commit 781f937210b199a2f80efa239d5d025d9ef9772b
Author: W. David Ashley <w.david.ashley(a)gmail.com>
Date: Fri Aug 14 09:25:02 2015 -0500
All chapters
- proofread fixups
en-US/Connections.xml | 14 +++++++-------
en-US/Guest_Domains.xml | 6 +++---
en-US/Introduction.xml | 10 +++++-----
en-US/Network_Interfaces.xml | 2 +-
en-US/Storage_Pools.xml | 2 +-
5 files changed, 17 insertions(+), 17 deletions(-)
---
diff --git a/en-US/Connections.xml b/en-US/Connections.xml
index b08c64c..e613772 100644
--- a/en-US/Connections.xml
+++ b/en-US/Connections.xml
@@ -81,7 +81,7 @@ conn = libvirt.openReadOnly(name)</programlisting>
for read-only access. Such a connection has a restricted set of method
calls that are allowed, and is typically useful for monitoring
applications that should not be allowed to make changes. As with
- <literal>open</literal>, this API has no scope for
authentication callbacks, so
+ <literal>open</literal>, this method has no scope for
authentication callbacks, so
relies on credentials.
</para>
<example>
@@ -109,7 +109,7 @@ conn = libvirt.openReadOnly(name)</programlisting>
the application to request a read-only connection with the
<parameter>VIR_CONNECT_RO</parameter> flag if desired. A
simple example Python program that uses
<literal>openAuth</literal> with username and password
credentials follows. As with
- <literal>open</literal>, this API has no scope for
authentication callbacks, so
+ <literal>open</literal>, this method has no scope for
authentication callbacks, so
relies on credentials.
</para>
<example id="openAuth-Example1">
@@ -317,7 +317,7 @@ driver+unix:///session</screen>
</tgroup>
</table>
<para>
- The following example shows how to local to a QEMU hypervisor using a
local URI.
+ The following example shows how to connect to a local QEMU hypervisor
using a local URI.
</para>
<example id="Example-Connect_Local">
<title>Connecting to a local QEMU hypervisor</title>
@@ -911,11 +911,11 @@ command -p port [-l username] hostname netcat -U socket
<secondary>getHost</secondary></indexterm>
<para>
The <command>getHostname</command> method can be used to
obtain the hostname
- of the virtualization host as returned by gethostname(2). It takes a
- connection pointer in and, if successful, returns a string
+ of the virtualization host as returned by gethostname(2). It invoked via
a the
+ virConnection instance and, if successful, returns a string
containing the hostname. If an error occurred, NULL will be returned
instead. It is the responsibility of the caller to free the memory
- returned from this API call. The following code demonstrates the use of
+ returned from this method call. The following code demonstrates the use
of
<command>getHostname</command>:
</para>
<example id="Example-ConnectGetHostname">
@@ -1070,7 +1070,7 @@ command -p port [-l username] hostname netcat -U socket
nodes in the system. It takes as input thet starting cell
and the maximum number of cells to retrieve data from.
If successful, aPython <literal>list</literal> is returned
with the
- amount of free memory in each node
+ amount of free memory in each node.
On failure <literal>None</literal> is returned. The
following code
demonstrates the use of
<command>getCellsFreeMemory</command>:
</para>
diff --git a/en-US/Guest_Domains.xml b/en-US/Guest_Domains.xml
index 04942d1..e6ef0e3 100644
--- a/en-US/Guest_Domains.xml
+++ b/en-US/Guest_Domains.xml
@@ -13,7 +13,7 @@
<para>
A domain is an instance of an operating system running on a virtualized
machine.
A guest domain can refer to either a running virtual machine or a
configuration
- which can be used to launch a virtual machine. The connection object provides
APIs
+ which can be used to launch a virtual machine. The connection object provides
methods
to enumerate the guest domains, create new guest domains and manage existing
domains.
A guest domain is represented with the
<literal>virDomainPtr</literal> object and
has a number of unique identifiers:
@@ -688,7 +688,7 @@
<para>
Some period of time later, the saved state file can then be
used to restart the guest where it left of, using the
- virDomainRestore API. The hypervisor driver will return an
+ virDomainRestore method. The hypervisor driver will return an
error if the guest is already running, however, it won't
prevent attempts to restore from the same state file multiple
times. As noted earlier, it is the applications' responsibility
@@ -1220,7 +1220,7 @@
<indexterm><primary>blockPull</primary></indexterm>
<indexterm><primary>Domains</primary>
<secondary>blockPull</secondary></indexterm>
- Libvirt provides a generic Block Job API that can be used to initiate
+ Libvirt provides a generic Block Job methods that can be used to
initiate
and manage operations on disks that belong to a domain. Jobs are
started by calling the function associated with the desired operation
(eg. <literal>blockPull</literal>). Once started, all
block
diff --git a/en-US/Introduction.xml b/en-US/Introduction.xml
index a1c06b1..d2a3497 100644
--- a/en-US/Introduction.xml
+++ b/en-US/Introduction.xml
@@ -22,18 +22,18 @@
<para>
Libvirt provides a common, generic and stable layer to securely manage
domains on a node. As nodes may be remotely located, libvirt provides
- all APIs required to provision, create, modify, monitor, control, migrate
+ all methods required to provision, create, modify, monitor, control, migrate
and stop the domains, within the limits of hypervisor support for these
operations. Although multiple nodes may be accessed with libvirt
- simultaneously, the APIs are limited to single node operations.
+ simultaneously, the methods are limited to single node operations.
</para>
<para>
Libvirt is designed to work across multiple virtualization environments,
- which means that more common capabilities are provided as APIs. Due to
+ which means that more common capabilities are provided as methods and
functions. Due to
this, certain specific capabilities may not be provided. For example,
it does not provide high level virtualization policies or multi-node
- management features such as load balancing. However, API stability
+ management features such as load balancing. However, method stability
ensures that these features can be implemented on top of libvirt. To
maintain this level of stability, libvirt seeks to isolate applications
from the frequent changes expected at the lower level of the virtualization
@@ -44,7 +44,7 @@
Libvirt is intended as a building block for higher level management tools
and applications focusing on virtualization of a single node, with the
only exception being domain migration between multiple node capabilities.
- It provides APIs to enumerate, monitor and use the resources available
+ It provides methods to enumerate, monitor and use the resources available
on the managed node, including CPUs, memory, storage, networking and
Non-Uniform Memory Access (NUMA) partitions. Although a management node
can be located on a separate physical machine to the management program,
diff --git a/en-US/Network_Interfaces.xml b/en-US/Network_Interfaces.xml
index 63001ab..d4b8652 100644
--- a/en-US/Network_Interfaces.xml
+++ b/en-US/Network_Interfaces.xml
@@ -20,7 +20,7 @@
(briefly - enslave a physical interface to the bridge, then create a
tap device for each VM you want to share the interface), as well as
for general host network interface management. In addition to physical
- hardware, this API can also be used to configure bridges, bonded
+ hardware, the methods can also be used to configure bridges, bonded
interfaces, and vlan interfaces.
</para>
<para>
diff --git a/en-US/Storage_Pools.xml b/en-US/Storage_Pools.xml
index 705e2c0..52b1936 100644
--- a/en-US/Storage_Pools.xml
+++ b/en-US/Storage_Pools.xml
@@ -52,7 +52,7 @@
If at this point the value of pools and volumes over traditional system
administration tools is unclear,
note that one of the features of libvirt is its remote protocol, so it's
possible to manage all aspects
of a virtual machine's lifecycle as well as the configuration of the
resources required by the VM. These
- operations can be performed on a remote host entirely within the libvirt API. In
other words, a
+ operations can be performed on a remote host entirely within the Python libvirt
module. In other words, a
management application using libvirt can enable a user to perform all the
required tasks for configuring
the host for a VM: allocating resources, running the VM, shutting it down and
deallocating the resources, without requiring shell access or any other control channel.
</para>