From nobody Thu May 2 05:26:25 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 150479261216574.31898566326561; Thu, 7 Sep 2017 06:56:52 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 857D468C5; Thu, 7 Sep 2017 13:56:50 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 2E33071C97; Thu, 7 Sep 2017 13:56:50 +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 EDC273FAD1; Thu, 7 Sep 2017 13:56:49 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id v87DmMwE009678 for ; Thu, 7 Sep 2017 09:48:22 -0400 Received: by smtp.corp.redhat.com (Postfix) id 2A1F86062D; Thu, 7 Sep 2017 13:48:22 +0000 (UTC) Received: from beluga.usersys.redhat.com (unknown [10.43.2.36]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1BCC96062F; Thu, 7 Sep 2017 13:48:20 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com 857D468C5 Authentication-Results: ext-mx09.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx09.extmail.prod.ext.phx2.redhat.com; spf=fail smtp.mailfrom=libvir-list-bounces@redhat.com From: Erik Skultety To: libvir-list@redhat.com Date: Thu, 7 Sep 2017 15:48:13 +0200 Message-Id: <0c0c50a8f8cf68247c4fc2f0a75376dc3e5d6556.1504791999.git.eskultet@redhat.com> In-Reply-To: References: In-Reply-To: References: X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com Cc: Erik Skultety Subject: [libvirt] [PATCH 1/2] virsh: man: Be more explicit about 'create' creating transient domain 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: , MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.38]); Thu, 07 Sep 2017 13:56:51 +0000 (UTC) X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" So we refer to terms 'persistent' and 'transient' across the whole man page, without explicitly stating that domain created via the 'create' command is in fact transient and will vanish once destroyed. Signed-off-by: Erik Skultety --- tools/virsh.pod | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/tools/virsh.pod b/tools/virsh.pod index c13f96f22..14a01e9ba 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -652,6 +652,11 @@ of open file descriptors which should be pass on into = the guest. The file descriptors will be re-numbered in the guest, starting from 3. This is only supported with container based virtualization. =20 +Note that a domain created using this command is transient (temporary), me= aning +that such a domain simply disappears once shut off or destroyed and any +subsequent attempts to B it will fail. See B command on how= to +make a domain persistent. + B =20 virsh dumpxml > domain.xml --=20 2.13.3 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list From nobody Thu May 2 05:26:25 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1504792633088457.1730078622386; Thu, 7 Sep 2017 06:57:13 -0700 (PDT) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id A7C35356D4; Thu, 7 Sep 2017 13:57:11 +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 4F31F6134C; Thu, 7 Sep 2017 13:57:11 +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 13BEB1806108; Thu, 7 Sep 2017 13:57:11 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id v87DmNwI009686 for ; Thu, 7 Sep 2017 09:48:23 -0400 Received: by smtp.corp.redhat.com (Postfix) id 2FBEA60633; Thu, 7 Sep 2017 13:48:23 +0000 (UTC) Received: from beluga.usersys.redhat.com (unknown [10.43.2.36]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8495D60631; Thu, 7 Sep 2017 13:48:22 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mx1.redhat.com A7C35356D4 Authentication-Results: ext-mx06.extmail.prod.ext.phx2.redhat.com; dmarc=none (p=none dis=none) header.from=redhat.com Authentication-Results: ext-mx06.extmail.prod.ext.phx2.redhat.com; spf=fail smtp.mailfrom=libvir-list-bounces@redhat.com From: Erik Skultety To: libvir-list@redhat.com Date: Thu, 7 Sep 2017 15:48:14 +0200 Message-Id: <54536681c48e694dcda03d4a6e8f84f3b34b6865.1504791999.git.eskultet@redhat.com> In-Reply-To: References: In-Reply-To: References: X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 X-loop: libvir-list@redhat.com Cc: Erik Skultety Subject: [libvirt] [PATCH 2/2] virsh: man: Document the --validate option for create and define cmds 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: , MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.30]); Thu, 07 Sep 2017 13:57:12 +0000 (UTC) X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=3D1368753 Signed-off-by: Erik Skultety Reviewed-by: Martin Kletzander --- tools/virsh.pod | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index 14a01e9ba..8ab93faf2 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -636,13 +636,15 @@ the I<--force> flag may be specified, requesting to d= isconnect any existing sessions, such as in a case of a broken connection. =20 =3Ditem B I [I<--console>] [I<--paused>] [I<--autodestroy>] -[I<--pass-fds N,M,...>] +[I<--pass-fds N,M,...>] [I<--validate>] =20 -Create a domain from an XML . An easy way to create the XML - is to use the B command to obtain the definition of a -pre-existing guest. The domain will be paused if the I<--paused> option -is used and supported by the driver; otherwise it will be running. -If I<--console> is requested, attach to the console after creation. +Create a domain from an XML . Optionally, I<--validate> option can be +passed to validate the format of the input XML file against an internal RNG +schema (identical to using L tool). An easy way to c= reate +the XML is to use the B command to obtain the definition o= f a +pre-existing guest. The domain will be paused if the I<--paused> option i= s used +and supported by the driver; otherwise it will be running. If I<--console>= is +requested, attach to the console after creation. If I<--autodestroy> is requested, then the guest will be automatically destroyed when virsh closes its connection to libvirt, or otherwise exits. @@ -663,10 +665,12 @@ B vi domain.xml (or make changes with your other text editor) virsh create domain.xml =20 -=3Ditem B I +=3Ditem B I [I<--validate>] =20 -Define a domain from an XML . The domain definition is registered -but not started. If domain is already running, the changes will take +Define a domain from an XML . Optionally, the format of the input XML +file can be validated against an internal RNG schema with I<--validate> +(identical to using L tool). The domain definition is +registered but not started. If domain is already running, the changes wil= l take effect on the next boot. =20 =3Ditem B I [[I<--live>] [I<--config>] | --=20 2.13.3 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list