From nobody Thu May 15 00:21:23 2025 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 152036121347083.96317739474091; Tue, 6 Mar 2018 10:33:33 -0800 (PST) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 498804DD49; Tue, 6 Mar 2018 18:33:32 +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 2515760BEC; Tue, 6 Mar 2018 18:33:32 +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 D9C8718033F0; Tue, 6 Mar 2018 18:33:31 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id w26IXArs008968 for ; Tue, 6 Mar 2018 13:33:10 -0500 Received: by smtp.corp.redhat.com (Postfix) id AD0241C71C; Tue, 6 Mar 2018 18:33:10 +0000 (UTC) Received: from vhost2.laine.org (ovpn-116-195.phx2.redhat.com [10.3.116.195]) by smtp.corp.redhat.com (Postfix) with ESMTP id 445901C720 for ; Tue, 6 Mar 2018 18:33:10 +0000 (UTC) From: Laine Stump To: libvir-list@redhat.com Date: Tue, 6 Mar 2018 13:33:01 -0500 Message-Id: <20180306183302.522518-3-laine@laine.org> In-Reply-To: <20180306183302.522518-1-laine@laine.org> References: <20180306183302.522518-1-laine@laine.org> X-Scanned-By: MIMEDefang 2.79 on 10.11.54.5 X-loop: libvir-list@redhat.com Subject: [libvirt] [perl PATCH 2/3] docs: replace VMM with hypervisor 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.12 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.38]); Tue, 06 Mar 2018 18:33:32 +0000 (UTC) X-ZohoMail: RSF_0 Z_629925259 SPT_0 Content-Type: text/plain; charset="utf-8" I *think* this makes the most sense in the context of the descriptions, but am open to other ideas (I also considered "virtualization host", which might be better; it just seemed a bit long...) Signed-off-by: Laine Stump Reviewed-by: Daniel P. Berrang=C3=A9 --- lib/Sys/Virt.pm | 92 ++++++++++++++++++++++++++++-------------------------= ---- 1 file changed, 46 insertions(+), 46 deletions(-) diff --git a/lib/Sys/Virt.pm b/lib/Sys/Virt.pm index 6a643fa..13b2603 100644 --- a/lib/Sys/Virt.pm +++ b/lib/Sys/Virt.pm @@ -119,8 +119,8 @@ Xen driver on C using TCP / SASL security For further details consult C =20 If the optional C parameter is supplied, then an unprivileged -connection to the VMM will be attempted. If it is not supplied, then it -defaults to making a fully privileged connection to the VMM. If the +connection to the hypervisor will be attempted. If it is not supplied, the= n it +defaults to making a fully privileged connection to the hypervisor. If the calling application is not running as root, it may be necessary to provide authentication callbacks. =20 @@ -226,7 +226,7 @@ sub new_stream { Create a new domain based on the XML description passed into the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with unprivileged connections to -the VMM. The C<$flags> parameter accepts one of the DOMAIN CREATION +the hypervisor. The C<$flags> parameter accepts one of the DOMAIN CREATION constants documented in L, and defaults to 0 if omitted. =20 =3Dcut @@ -244,7 +244,7 @@ sub create_domain { Create a new domain based on the XML description passed into the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with unprivileged connections to -the VMM. The C<$fds> parameter is an array of UNIX file descriptors +the hypervisor. The C<$fds> parameter is an array of UNIX file descriptors which will be passed to the init process of the container. This is only supported with container based virtualization. The C<$flags> parameter accepts one of the DOMAIN CREATION constants documented @@ -267,7 +267,7 @@ sub create_domain_with_files { Defines, but does not start, a new domain based on the XML description passed into the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with -unprivileged connections to the VMM. The defined domain can be later start= ed +unprivileged connections to the hypervisor. The defined domain can be late= r started by calling the C method on the returned C object. =20 @@ -286,7 +286,7 @@ sub define_domain { Create a new network based on the XML description passed into the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with unprivileged connections to -the VMM. +the hypervisor. =20 =3Dcut =20 @@ -302,7 +302,7 @@ sub create_network { Defines, but does not start, a new network based on the XML description passed into the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with -unprivileged connections to the VMM. The defined network can be later star= ted +unprivileged connections to the hypervisor. The defined network can be lat= er started by calling the C method on the returned C object. =20 @@ -320,7 +320,7 @@ sub define_network { Create a new storage pool based on the XML description passed into the C<$= xml> parameter. The returned object is an instance of the L class. This method is not available with unprivileged connections to -the VMM. +the hypervisor. =20 =3Dcut =20 @@ -336,7 +336,7 @@ sub create_storage_pool { Defines, but does not start, a new storage pol based on the XML description passed into the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with -unprivileged connections to the VMM. The defined pool can be later started +unprivileged connections to the hypervisor. The defined pool can be later = started by calling the C method on the returned C object. =20 @@ -354,7 +354,7 @@ sub define_storage_pool { Create a new interface based on the XML description passed into the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with unprivileged connections to -the VMM. +the hypervisor. =20 =3Dcut =20 @@ -370,7 +370,7 @@ sub create_interface { Defines, but does not start, a new interface based on the XML description passed into the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with -unprivileged connections to the VMM. The defined interface can be later st= arted +unprivileged connections to the hypervisor. The defined interface can be l= ater started by calling the C method on the returned C object. =20 @@ -388,7 +388,7 @@ sub define_interface { Create a new virtual node device based on the XML description passed into = the C<$xml> parameter. The returned object is an instance of the L class. This method is not available with unprivileged connections to -the VMM. +the hypervisor. =20 =3Dcut =20 @@ -402,7 +402,7 @@ sub create_node_device { =20 =3Ditem my @doms =3D $conn->list_domains() =20 -Return a list of all running domains currently known to the VMM. The eleme= nts +Return a list of all running domains currently known to the hypervisor. Th= e elements in the returned list are instances of the L class. This method requires O(n) RPC calls, so the C method is recommended as a more efficient alternative. @@ -428,18 +428,18 @@ sub list_domains { =20 =3Ditem my $nids =3D $conn->num_of_domains() =20 -Return the number of running domains known to the VMM. This can be +Return the number of running domains known to the hypervisor. This can be used as the C parameter to C. =20 =3Ditem my @domIDs =3D $conn->list_domain_ids($maxids) =20 -Return a list of all domain IDs currently known to the VMM. The IDs can +Return a list of all domain IDs currently known to the hypervisor. The IDs= can be used with the C method. =20 =3Ditem my @doms =3D $conn->list_defined_domains() =20 Return a list of all domains defined, but not currently running, on the -VMM. The elements in the returned list are instances of the +hypervisor. The elements in the returned list are instances of the L class. This method requires O(n) RPC calls, so the C method is recommended as a more efficient alternative. =20 @@ -465,24 +465,24 @@ sub list_defined_domains { =20 =3Ditem my $nnames =3D $conn->num_of_defined_domains() =20 -Return the number of running domains known to the VMM. This can be +Return the number of running domains known to the hypervisor. This can be used as the C parameter to C. =20 =3Ditem my @names =3D $conn->list_defined_domain_names($maxnames) =20 Return a list of names of all domains defined, but not currently running, = on -the VMM. The names can be used with the C method. +the hypervisor. The names can be used with the C metho= d. =20 =3Ditem my @doms =3D $conn->list_all_domains($flags) =20 -Return a list of all domains currently known to the VMM, whether +Return a list of all domains currently known to the hypervisor, whether running or shutoff. The elements in the returned list are instances of the L class. The C<$flags> parameter can be used to filter the list of returned domains. =20 =3Ditem my @nets =3D $conn->list_networks() =20 -Return a list of all networks currently known to the VMM. The elements +Return a list of all networks currently known to the hypervisor. The eleme= nts in the returned list are instances of the L class. This method requires O(n) RPC calls, so the C method is recommended as a more efficient alternative. @@ -509,18 +509,18 @@ sub list_networks { =20 =3Ditem my $nnames =3D $conn->num_of_networks() =20 -Return the number of running networks known to the VMM. This can be +Return the number of running networks known to the hypervisor. This can be used as the C parameter to C. =20 =3Ditem my @netNames =3D $conn->list_network_names($maxnames) =20 -Return a list of all network names currently known to the VMM. The names c= an +Return a list of all network names currently known to the hypervisor. The = names can be used with the C method. =20 =3Ditem my @nets =3D $conn->list_defined_networks() =20 Return a list of all networks defined, but not currently running, on the -VMM. The elements in the returned list are instances of the +hypervisor. The elements in the returned list are instances of the L class. This method requires O(n) RPC calls, so the C method is recommended as a more efficient alternative. =20 @@ -556,7 +556,7 @@ the host. The names can be used with the C method. =20 =3Ditem my @nets =3D $conn->list_all_networks($flags) =20 -Return a list of all networks currently known to the VMM, whether +Return a list of all networks currently known to the hypervisor, whether running or shutoff. The elements in the returned list are instances of the L class. The C<$flags> parameter can be used to filter the list of returned networks. @@ -590,12 +590,12 @@ sub list_storage_pools { =20 =3Ditem my $nnames =3D $conn->num_of_storage_pools() =20 -Return the number of running storage pools known to the VMM. This can be +Return the number of running storage pools known to the hypervisor. This c= an be used as the C parameter to C. =20 =3Ditem my @poolNames =3D $conn->list_storage_pool_names($maxnames) =20 -Return a list of all storage pool names currently known to the VMM. The ID= s can +Return a list of all storage pool names currently known to the hypervisor.= The IDs can be used with the C method. =20 =3Ditem my @pools =3D $conn->list_defined_storage_pools() @@ -637,7 +637,7 @@ the host. The names can be used with the C method. =20 =3Ditem my @pools =3D $conn->list_all_storage_pools($flags) =20 -Return a list of all storage pools currently known to the VMM, whether +Return a list of all storage pools currently known to the hypervisor, whet= her running or shutoff. The elements in the returned list are instances of the L class. The C<$flags> parameter can be used to filter the list of returned pools. @@ -674,7 +674,7 @@ sub list_node_devices { =20 =3Ditem my $nnames =3D $conn->num_of_node_devices($capability[, $flags]) =20 -Return the number of host devices known to the VMM. This can be +Return the number of host devices known to the hypervisor. This can be used as the C parameter to C. The C parameter allows the list to be restricted to only devices with a particular capability type, and should be left @@ -683,7 +683,7 @@ parameter is currently unused and defaults to 0 if omit= ted. =20 =3Ditem my @netNames =3D $conn->list_node_device_names($capability, $maxna= mes[, $flags]) =20 -Return a list of all host device names currently known to the VMM. The nam= es can +Return a list of all host device names currently known to the hypervisor. = The names can be used with the C method. The C parameter allows the list to be restricted to only devices with a particular capability type, and should be left @@ -692,14 +692,14 @@ parameter is currently unused and defaults to 0 if om= itted. =20 =3Ditem my @devs =3D $conn->list_all_node_devices($flags) =20 -Return a list of all node devices currently known to the VMM. The +Return a list of all node devices currently known to the hypervisor. The elements in the returned list are instances of the L class. The C<$flags> parameter can be used to filter the list of returned devices. =20 =3Ditem my @ifaces =3D $conn->list_interfaces() =20 -Return a list of all network interfaces currently known to the VMM. The el= ements +Return a list of all network interfaces currently known to the hypervisor.= The elements in the returned list are instances of the L class. This method requires O(n) RPC calls, so the C method = is recommended as a more efficient alternative. @@ -726,17 +726,17 @@ sub list_interfaces { =20 =3Ditem my $nnames =3D $conn->num_of_interfaces() =20 -Return the number of running interfaces known to the VMM. This can be +Return the number of running interfaces known to the hypervisor. This can = be used as the C parameter to C. =20 =3Ditem my @names =3D $conn->list_interface_names($maxnames) =20 -Return a list of all interface names currently known to the VMM. The names= can +Return a list of all interface names currently known to the hypervisor. Th= e names can be used with the C method. =20 =3Ditem my @ifaces =3D $conn->list_defined_interfaces() =20 -Return a list of all network interfaces currently known to the VMM. The el= ements +Return a list of all network interfaces currently known to the hypervisor.= The elements in the returned list are instances of the L class. This method requires O(n) RPC calls, so the C method = is recommended as a more efficient alternative. @@ -763,24 +763,24 @@ sub list_defined_interfaces { =20 =3Ditem my $nnames =3D $conn->num_of_defined_interfaces() =20 -Return the number of inactive interfaces known to the VMM. This can be +Return the number of inactive interfaces known to the hypervisor. This can= be used as the C parameter to C. =20 =3Ditem my @names =3D $conn->list_defined_interface_names($maxnames) =20 -Return a list of inactive interface names currently known to the VMM. The = names can +Return a list of inactive interface names currently known to the hyperviso= r. The names can be used with the C method. =20 =3Ditem my @ifaces =3D $conn->list_all_interfaces($flags) =20 -Return a list of all interfaces currently known to the VMM, whether +Return a list of all interfaces currently known to the hypervisor, whether running or shutoff. The elements in the returned list are instances of the L class. The C<$flags> parameter can be used to filter the list of returned interfaces. =20 =3Ditem my @ifaces =3D $conn->list_secrets() =20 -Return a list of all secrets currently known to the VMM. The elements +Return a list of all secrets currently known to the hypervisor. The elemen= ts in the returned list are instances of the L class. This method requires O(n) RPC calls, so the C method is recommended as a more efficient alternative. @@ -807,24 +807,24 @@ sub list_secrets { =20 =3Ditem my $nuuids =3D $conn->num_of_secrets() =20 -Return the number of secrets known to the VMM. This can be +Return the number of secrets known to the hypervisor. This can be used as the C parameter to C. =20 =3Ditem my @uuids =3D $conn->list_secret_uuids($maxuuids) =20 -Return a list of all secret uuids currently known to the VMM. The uuids can +Return a list of all secret uuids currently known to the hypervisor. The u= uids can be used with the C method. =20 =3Ditem my @secrets =3D $conn->list_all_secrets($flags) =20 -Return a list of all secrets currently known to the VMM. The elements +Return a list of all secrets currently known to the hypervisor. The elemen= ts in the returned list are instances of the L class. The C<$flags> parameter can be used to filter the list of returned secrets. =20 =3Ditem my @nets =3D $conn->list_nwfilters() =20 -Return a list of all nwfilters currently known to the VMM. The elements +Return a list of all nwfilters currently known to the hypervisor. The elem= ents in the returned list are instances of the L class. This method requires O(n) RPC calls, so the C method is recommended as a more efficient alternative. @@ -851,17 +851,17 @@ sub list_nwfilters { =20 =3Ditem my $nnames =3D $conn->num_of_nwfilters() =20 -Return the number of running nwfilters known to the VMM. This can be +Return the number of running nwfilters known to the hypervisor. This can be used as the C parameter to C. =20 =3Ditem my @filterNames =3D $conn->list_nwfilter_names($maxnames) =20 -Return a list of all nwfilter names currently known to the VMM. The names = can +Return a list of all nwfilter names currently known to the hypervisor. The= names can be used with the C method. =20 =3Ditem my @nwfilters =3D $conn->list_all_nwfilters($flags) =20 -Return a list of all nwfilters currently known to the VMM. The elements +Return a list of all nwfilters currently known to the hypervisor. The elem= ents in the returned list are instances of the L class. The C<$flags> parameter is currently unused and defaults to zero. =20 @@ -1234,7 +1234,7 @@ typically obtained from SMBIOS tables. =20 =3Ditem my $type =3D $conn->get_type() =20 -Return the type of virtualization backend accessed by this VMM object. Cur= rently +Return the type of virtualization backend accessed by this hypervisor obje= ct. Currently the only supported type is C. =20 =3Ditem my $xml =3D $conn->domain_xml_from_native($format, $config); --=20 2.14.3 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list