From patchwork Mon Jul 15 00:04:01 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Cole Robinson X-Patchwork-Id: 168974 Delivered-To: patch@linaro.org Received: by 2002:a92:4782:0:0:0:0:0 with SMTP id e2csp3688644ilk; Sun, 14 Jul 2019 17:04:29 -0700 (PDT) X-Google-Smtp-Source: APXvYqzzJXVHlNLvcagJ1GanvGpeQzckr2pl4+3mM7BFr64EBxAO/xcEADYNHcUCczuKhYiVLymt X-Received: by 2002:a0c:e908:: with SMTP id a8mr16505625qvo.214.1563149069782; Sun, 14 Jul 2019 17:04:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1563149069; cv=none; d=google.com; s=arc-20160816; b=PgvUtBdvPYw3yUDBAlDrsbw8L77yOXM3lhmky1FpVbdoCcggX5fvHNCtnkDEBAYB1I sM7KAdg1bgDyMkpRuaR0sj6RlGe8cnc+lm4rvk7Pj7hFgGx+5c4ssre4o+qkdwY0YpEF ERdqufhTAqDWWFVFpm1WHIpE1Nt/l5F7VDc9LyiFLGVVutuOojbqEOW7WAgfd76fp61m PmB8gZzY8j2oJnoxCj90vveXP3w2wMi2WhBsWRe28FVRrP4Ue2f4RsT4SY7jcg5wCsRE ls+IQ79nbQ8SGe0K/v01udoPAtDYh3dwgNELH93Ty3DMbiAEkNNdwlUWzN2yHANCKVAK RKSw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=errors-to:sender:content-transfer-encoding:list-subscribe:list-help :list-post:list-archive:list-unsubscribe:list-id:precedence:subject :mime-version:references:in-reply-to:message-id:date:to:from :delivered-to; bh=QfWnTQXG3Se5gPdoWlfBS6JB37DsNL0iwwcCG5l8yrs=; b=0QkuXCewK3BpbjVRpQdh51SvJry/PBQ0Jj2GROw19Dv/q1WEQPFzIysDxvkxILHlRd 0X8nF1tP4OPlvyS1OSFv733hqMrwXT7wTxFkv/7LD3CLBSEFLLrNZQFhKv369IS0EInq EAx18MftXX6PQtKfAtM932i/E0f/mJql5VmeaPYBGFC+OnEmR1ByH0/QsSLN5GH1Kot4 Yu3JsdIaXRoLbXUc77ui5Ya7VMR9uO2SyRlaxr3nTCX7Kn7qtDTLdaB0nPlLqEHiYNV+ IprKTNuQj0T9CkdaijqmkNyZgVHpb/wC74FB91buUdCD52upM1jfC8O2cXdMFtLsn9ZK 8nOA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of libvir-list-bounces@redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com. [209.132.183.28]) by mx.google.com with ESMTPS id l63si9060436qkf.346.2019.07.14.17.04.29 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 14 Jul 2019 17:04:29 -0700 (PDT) Received-SPF: pass (google.com: domain of libvir-list-bounces@redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; Authentication-Results: mx.google.com; spf=pass (google.com: domain of libvir-list-bounces@redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 4DEF236893; Mon, 15 Jul 2019 00:04:28 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 1FA4C5D9DE; Mon, 15 Jul 2019 00:04:28 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id D228818184B6; Mon, 15 Jul 2019 00:04:27 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id x6F04JFd030327 for ; Sun, 14 Jul 2019 20:04:19 -0400 Received: by smtp.corp.redhat.com (Postfix) id B965960C44; Mon, 15 Jul 2019 00:04:19 +0000 (UTC) Delivered-To: libvirt-list@redhat.com Received: from worklaptop.redhat.com (ovpn-121-2.rdu2.redhat.com [10.10.121.2]) by smtp.corp.redhat.com (Postfix) with ESMTP id 5445560BFB; Mon, 15 Jul 2019 00:04:19 +0000 (UTC) From: Cole Robinson To: libvirt-list@redhat.com Date: Sun, 14 Jul 2019 20:04:01 -0400 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH 5/5] docs: formatnetwork: Document xmlns:dnsmasq X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.30]); Mon, 15 Jul 2019 00:04:28 +0000 (UTC) Signed-off-by: Cole Robinson --- docs/formatnetwork.html.in | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) -- 2.21.0 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list diff --git a/docs/formatnetwork.html.in b/docs/formatnetwork.html.in index 509cca9e8b..2448fb09e7 100644 --- a/docs/formatnetwork.html.in +++ b/docs/formatnetwork.html.in @@ -1096,6 +1096,28 @@ +

Network namespaces

+ +

+ A special XML namespace is available for passing options directly to the + underlying dnsmasq configuration file. Usage of XML namespaces comes with no + support guarantees, so use at your own risk. +

+ +

+ This example XML will pass the option strings foo=bar and + cname=*.foo.example.com,master.example.com directly to the + underlying dnsmasq instance. + 

+<network xmlns:dnsmasq='http://libvirt.org/schemas/network/dnsmasq/1.0'>
+  ...
+  <dnsmasq:options>
+    <dnsmasq:option value="foo=bar"/>
+    <dnsmasq:option value="cname=*.foo.example.com,master.example.com"/>
+  </dnsmasq:options>
+</network>
+

+

Example configuration

NAT based network