direct-io.hg

changeset 13694:7d64bdc7a300

Tidy-ups; no semantic-change.

Signed-off-by: Ewan Mellor <ewan@xensource.com>
author Ewan Mellor <ewan@xensource.com>
date Mon Jan 29 13:16:00 2007 +0000 (2007-01-29)
parents f7b6ce00426b
children 049d9022653c
files docs/xen-api/xenapi-datamodel.tex
line diff
     1.1 --- a/docs/xen-api/xenapi-datamodel.tex	Mon Jan 29 12:57:49 2007 +0000
     1.2 +++ b/docs/xen-api/xenapi-datamodel.tex	Mon Jan 29 13:16:00 2007 +0000
     1.3 @@ -279,7 +279,8 @@ The following enumeration types are used
     1.4  \begin{longtable}{|lllp{0.38\textwidth}|}
     1.5  \hline
     1.6  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf session} \\
     1.7 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A session}} \\
     1.8 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
     1.9 +session.}} \\
    1.10  \hline
    1.11  Quals & Field & Type & Description \\
    1.12  \hline
    1.13 @@ -293,7 +294,7 @@ Quals & Field & Type & Description \\
    1.14  \subsubsection{RPC name:~login\_with\_password}
    1.15  
    1.16  {\bf Overview:} 
    1.17 -Attempt to authenticate the user, returning a session\_id if successful
    1.18 +Attempt to authenticate the user, returning a session\_id if successful.
    1.19  
    1.20   \noindent {\bf Signature:} 
    1.21  \begin{verbatim} (session ref) login_with_password (string uname, string pwd)\end{verbatim}
    1.22 @@ -327,7 +328,7 @@ ID of newly created session
    1.23  \subsubsection{RPC name:~logout}
    1.24  
    1.25  {\bf Overview:} 
    1.26 -Log out of a session
    1.27 +Log out of a session.
    1.28  
    1.29   \noindent {\bf Signature:} 
    1.30  \begin{verbatim} void logout (session_id s)\end{verbatim}
    1.31 @@ -545,7 +546,8 @@ all fields from the object
    1.32  \begin{longtable}{|lllp{0.38\textwidth}|}
    1.33  \hline
    1.34  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf task} \\
    1.35 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A long-running asynchronous task}} \\
    1.36 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
    1.37 +long-running asynchronous task.}} \\
    1.38  \hline
    1.39  Quals & Field & Type & Description \\
    1.40  \hline
    1.41 @@ -1045,7 +1047,8 @@ references to objects with match names
    1.42  \begin{longtable}{|lllp{0.38\textwidth}|}
    1.43  \hline
    1.44  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf VM} \\
    1.45 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A virtual machine (or 'guest').
    1.46 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
    1.47 +virtual machine (or 'guest').
    1.48  
    1.49  VM booting is controlled by setting one of the two mutually exclusive
    1.50  groups: "PV", and "HVM".  If HVM.boot is the empty string, then paravirtual
    1.51 @@ -1075,7 +1078,7 @@ ramdisk values will be treated as paths 
    1.52  PV/bootloader and PV/kernel are empty, then the behaviour is as if
    1.53  PV/bootloader was specified as "pygrub".
    1.54  
    1.55 -When using HVM booting, HVM/boot specifies the order of the boot devices}} \\
    1.56 +When using HVM booting, HVM/boot specifies the order of the boot devices.}} \\
    1.57  \hline
    1.58  Quals & Field & Type & Description \\
    1.59  \hline
    1.60 @@ -1128,7 +1131,10 @@ Quals & Field & Type & Description \\
    1.61  \subsubsection{RPC name:~clone}
    1.62  
    1.63  {\bf Overview:} 
    1.64 -Clones the specified VM, making a new VM. Clone automatically exploits the capabilities of the underlying storage repository in which the VM's disk images are stored (e.g. Copy on Write).   This function can only be called when the VM is in the Halted State.
    1.65 +Clones the specified VM, making a new VM. Clone automatically exploits the
    1.66 +capabilities of the underlying storage repository in which the VM's disk
    1.67 +images are stored (e.g. Copy on Write).   This function can only be called
    1.68 +when the VM is in the Halted State.
    1.69  
    1.70   \noindent {\bf Signature:} 
    1.71  \begin{verbatim} (VM ref) clone (session_id s, VM ref vm, string new_name)\end{verbatim}
    1.72 @@ -1164,7 +1170,8 @@ The ID of the newly created VM.
    1.73  \subsubsection{RPC name:~start}
    1.74  
    1.75  {\bf Overview:} 
    1.76 -Start the specified VM.  This function can only be called with the VM is in the Halted State.
    1.77 +Start the specified VM.  This function can only be called with the VM is in
    1.78 +the Halted State.
    1.79  
    1.80   \noindent {\bf Signature:} 
    1.81  \begin{verbatim} void start (session_id s, VM ref vm, bool start_paused)\end{verbatim}
    1.82 @@ -1200,7 +1207,8 @@ void
    1.83  \subsubsection{RPC name:~pause}
    1.84  
    1.85  {\bf Overview:} 
    1.86 -Pause the specified VM. This can only be called when the specified VM is in the Running state.
    1.87 +Pause the specified VM. This can only be called when the specified VM is in
    1.88 +the Running state.
    1.89  
    1.90   \noindent {\bf Signature:} 
    1.91  \begin{verbatim} void pause (session_id s, VM ref vm)\end{verbatim}
    1.92 @@ -1234,7 +1242,8 @@ void
    1.93  \subsubsection{RPC name:~unpause}
    1.94  
    1.95  {\bf Overview:} 
    1.96 -Resume the specified VM. This can only be called when the specified VM is in the Paused state.
    1.97 +Resume the specified VM. This can only be called when the specified VM is
    1.98 +in the Paused state.
    1.99  
   1.100   \noindent {\bf Signature:} 
   1.101  \begin{verbatim} void unpause (session_id s, VM ref vm)\end{verbatim}
   1.102 @@ -1268,9 +1277,11 @@ void
   1.103  \subsubsection{RPC name:~clean\_shutdown}
   1.104  
   1.105  {\bf Overview:} 
   1.106 -Attempt to cleanly shutdown the specified VM. (Note: this may not be supported---e.g. if a guest agent is not installed).
   1.107 -
   1.108 -Once shutdown has been completed perform poweroff action specified in guest configuration.
   1.109 +Attempt to cleanly shutdown the specified VM. (Note: this may not be
   1.110 +supported---e.g. if a guest agent is not installed).
   1.111 +
   1.112 +Once shutdown has been completed perform poweroff action specified in guest
   1.113 +configuration.
   1.114  
   1.115  This can only be called when the specified VM is in the Running state.
   1.116  
   1.117 @@ -1306,9 +1317,11 @@ void
   1.118  \subsubsection{RPC name:~clean\_reboot}
   1.119  
   1.120  {\bf Overview:} 
   1.121 -Attempt to cleanly shutdown the specified VM (Note: this may not be supported---e.g. if a guest agent is not installed).
   1.122 -
   1.123 -Once shutdown has been completed perform reboot action specified in guest configuration.
   1.124 +Attempt to cleanly shutdown the specified VM (Note: this may not be
   1.125 +supported---e.g. if a guest agent is not installed).
   1.126 +
   1.127 +Once shutdown has been completed perform reboot action specified in guest
   1.128 +configuration.
   1.129  
   1.130  This can only be called when the specified VM is in the Running state.
   1.131  
   1.132 @@ -1344,7 +1357,8 @@ void
   1.133  \subsubsection{RPC name:~hard\_shutdown}
   1.134  
   1.135  {\bf Overview:} 
   1.136 -Stop executing the specified VM without attempting a clean shutdown. Then perform poweroff action specified in VM configuration.
   1.137 +Stop executing the specified VM without attempting a clean shutdown. Then
   1.138 +perform poweroff action specified in VM configuration.
   1.139  
   1.140   \noindent {\bf Signature:} 
   1.141  \begin{verbatim} void hard_shutdown (session_id s, VM ref vm)\end{verbatim}
   1.142 @@ -1376,7 +1390,8 @@ void
   1.143  \subsubsection{RPC name:~hard\_reboot}
   1.144  
   1.145  {\bf Overview:} 
   1.146 -Stop executing the specified VM without attempting a clean shutdown. Then perform reboot action specified in VM configuration
   1.147 +Stop executing the specified VM without attempting a clean shutdown. Then
   1.148 +perform reboot action specified in VM configuration.
   1.149  
   1.150   \noindent {\bf Signature:} 
   1.151  \begin{verbatim} void hard_reboot (session_id s, VM ref vm)\end{verbatim}
   1.152 @@ -1408,7 +1423,8 @@ void
   1.153  \subsubsection{RPC name:~suspend}
   1.154  
   1.155  {\bf Overview:} 
   1.156 -Suspend the specified VM to disk.  This can only be called when the specified VM is in the Running state.
   1.157 +Suspend the specified VM to disk.  This can only be called when the
   1.158 +specified VM is in the Running state.
   1.159  
   1.160   \noindent {\bf Signature:} 
   1.161  \begin{verbatim} void suspend (session_id s, VM ref vm)\end{verbatim}
   1.162 @@ -1442,7 +1458,8 @@ void
   1.163  \subsubsection{RPC name:~resume}
   1.164  
   1.165  {\bf Overview:} 
   1.166 -Awaken the specified VM and resume it.  This can only be called when the specified VM is in the Suspended state.
   1.167 +Awaken the specified VM and resume it.  This can only be called when the
   1.168 +specified VM is in the Suspended state.
   1.169  
   1.170   \noindent {\bf Signature:} 
   1.171  \begin{verbatim} void resume (session_id s, VM ref vm, bool start_paused)\end{verbatim}
   1.172 @@ -2513,7 +2530,8 @@ void
   1.173  \subsubsection{RPC name:~add\_VCPUs\_features\_force\_on}
   1.174  
   1.175  {\bf Overview:} 
   1.176 -Add the given value to the VCPUs/features/force\_on field of the given VM.  If the value is already in that Set, then do nothing.
   1.177 +Add the given value to the VCPUs/features/force\_on field of the given VM. 
   1.178 +If the value is already in that Set, then do nothing.
   1.179  
   1.180   \noindent {\bf Signature:} 
   1.181  \begin{verbatim} void add_VCPUs_features_force_on (session_id s, VM ref self, cpu_feature value)\end{verbatim}
   1.182 @@ -2547,7 +2565,8 @@ void
   1.183  \subsubsection{RPC name:~remove\_VCPUs\_features\_force\_on}
   1.184  
   1.185  {\bf Overview:} 
   1.186 -Remove the given value from the VCPUs/features/force\_on field of the given VM.  If the value is not in that Set, then do nothing.
   1.187 +Remove the given value from the VCPUs/features/force\_on field of the given
   1.188 +VM.  If the value is not in that Set, then do nothing.
   1.189  
   1.190   \noindent {\bf Signature:} 
   1.191  \begin{verbatim} void remove_VCPUs_features_force_on (session_id s, VM ref self, cpu_feature value)\end{verbatim}
   1.192 @@ -2647,7 +2666,8 @@ void
   1.193  \subsubsection{RPC name:~add\_VCPUs\_features\_force\_off}
   1.194  
   1.195  {\bf Overview:} 
   1.196 -Add the given value to the VCPUs/features/force\_off field of the given VM.  If the value is already in that Set, then do nothing.
   1.197 +Add the given value to the VCPUs/features/force\_off field of the given VM.
   1.198 + If the value is already in that Set, then do nothing.
   1.199  
   1.200   \noindent {\bf Signature:} 
   1.201  \begin{verbatim} void add_VCPUs_features_force_off (session_id s, VM ref self, cpu_feature value)\end{verbatim}
   1.202 @@ -2681,7 +2701,8 @@ void
   1.203  \subsubsection{RPC name:~remove\_VCPUs\_features\_force\_off}
   1.204  
   1.205  {\bf Overview:} 
   1.206 -Remove the given value from the VCPUs/features/force\_off field of the given VM.  If the value is not in that Set, then do nothing.
   1.207 +Remove the given value from the VCPUs/features/force\_off field of the
   1.208 +given VM.  If the value is not in that Set, then do nothing.
   1.209  
   1.210   \noindent {\bf Signature:} 
   1.211  \begin{verbatim} void remove_VCPUs_features_force_off (session_id s, VM ref self, cpu_feature value)\end{verbatim}
   1.212 @@ -4066,7 +4087,8 @@ reference to the newly created object
   1.213  \subsubsection{RPC name:~destroy}
   1.214  
   1.215  {\bf Overview:} 
   1.216 -Destroy the specified VM.  The VM is completely removed from the system.  This function can only be called when the VM is in the Halted State.
   1.217 +Destroy the specified VM.  The VM is completely removed from the system. 
   1.218 +This function can only be called when the VM is in the Halted State.
   1.219  
   1.220   \noindent {\bf Signature:} 
   1.221  \begin{verbatim} void destroy (session_id s, VM ref self)\end{verbatim}
   1.222 @@ -4199,7 +4221,8 @@ references to objects with match names
   1.223  \begin{longtable}{|lllp{0.38\textwidth}|}
   1.224  \hline
   1.225  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf host} \\
   1.226 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A physical host}} \\
   1.227 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.228 +physical host.}} \\
   1.229  \hline
   1.230  Quals & Field & Type & Description \\
   1.231  \hline
   1.232 @@ -4216,7 +4239,8 @@ Quals & Field & Type & Description \\
   1.233  \subsubsection{RPC name:~disable}
   1.234  
   1.235  {\bf Overview:} 
   1.236 -Puts the host into a state in which no new VMs can be started. Currently active VMs on the host continue to execute.
   1.237 +Puts the host into a state in which no new VMs can be started. Currently
   1.238 +active VMs on the host continue to execute.
   1.239  
   1.240   \noindent {\bf Signature:} 
   1.241  \begin{verbatim} void disable (session_id s, host ref host)\end{verbatim}
   1.242 @@ -4280,7 +4304,8 @@ void
   1.243  \subsubsection{RPC name:~shutdown}
   1.244  
   1.245  {\bf Overview:} 
   1.246 -Shutdown the host. (This function can only be called if there are no currently running VMs on the host and it is disabled.)
   1.247 +Shutdown the host. (This function can only be called if there are no
   1.248 +currently running VMs on the host and it is disabled.).
   1.249  
   1.250   \noindent {\bf Signature:} 
   1.251  \begin{verbatim} void shutdown (session_id s, host ref host)\end{verbatim}
   1.252 @@ -4312,7 +4337,8 @@ void
   1.253  \subsubsection{RPC name:~reboot}
   1.254  
   1.255  {\bf Overview:} 
   1.256 -Reboot the host. (This function can only be called if there are no currently running VMs on the host and it is disabled.)
   1.257 +Reboot the host. (This function can only be called if there are no
   1.258 +currently running VMs on the host and it is disabled.).
   1.259  
   1.260   \noindent {\bf Signature:} 
   1.261  \begin{verbatim} void reboot (session_id s, host ref host)\end{verbatim}
   1.262 @@ -5229,7 +5255,8 @@ all fields from the object
   1.263  \begin{longtable}{|lllp{0.38\textwidth}|}
   1.264  \hline
   1.265  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf network} \\
   1.266 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A virtual network}} \\
   1.267 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.268 +virtual network.}} \\
   1.269  \hline
   1.270  Quals & Field & Type & Description \\
   1.271  \hline
   1.272 @@ -5792,7 +5819,8 @@ references to objects with match names
   1.273  \begin{longtable}{|lllp{0.38\textwidth}|}
   1.274  \hline
   1.275  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf VIF} \\
   1.276 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A virtual network interface}} \\
   1.277 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.278 +virtual network interface.}} \\
   1.279  \hline
   1.280  Quals & Field & Type & Description \\
   1.281  \hline
   1.282 @@ -6371,7 +6399,7 @@ all fields from the object
   1.283  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf PIF} \\
   1.284  \multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.285  physical network interface (note separate VLANs are represented as several
   1.286 -PIFs)}} \\
   1.287 +PIFs).}} \\
   1.288  \hline
   1.289  Quals & Field & Type & Description \\
   1.290  \hline
   1.291 @@ -6390,7 +6418,7 @@ Quals & Field & Type & Description \\
   1.292  \subsubsection{RPC name:~create\_VLAN}
   1.293  
   1.294  {\bf Overview:} 
   1.295 -Create a VLAN interface from an existing physical interface
   1.296 +Create a VLAN interface from an existing physical interface.
   1.297  
   1.298   \noindent {\bf Signature:} 
   1.299  \begin{verbatim} (PIF ref) create_VLAN (session_id s, string device, network ref network, host ref host, int VLAN)\end{verbatim}
   1.300 @@ -6430,7 +6458,8 @@ The reference of the created PIF object
   1.301  \subsubsection{RPC name:~destroy}
   1.302  
   1.303  {\bf Overview:} 
   1.304 -Destroy the interface (provided it is a synthetic interface like a VLAN; fail if it is a physical interface)
   1.305 +Destroy the interface (provided it is a synthetic interface like a VLAN;
   1.306 +fail if it is a physical interface).
   1.307  
   1.308   \noindent {\bf Signature:} 
   1.309  \begin{verbatim} void destroy (session_id s, PIF ref self)\end{verbatim}
   1.310 @@ -7025,7 +7054,8 @@ all fields from the object
   1.311  \begin{longtable}{|lllp{0.38\textwidth}|}
   1.312  \hline
   1.313  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf SR} \\
   1.314 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A storage repository}} \\
   1.315 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.316 +storage repository.}} \\
   1.317  \hline
   1.318  Quals & Field & Type & Description \\
   1.319  \hline
   1.320 @@ -7623,7 +7653,8 @@ references to objects with match names
   1.321  \begin{longtable}{|lllp{0.38\textwidth}|}
   1.322  \hline
   1.323  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf VDI} \\
   1.324 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A virtual disk image}} \\
   1.325 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.326 +virtual disk image.}} \\
   1.327  \hline
   1.328  Quals & Field & Type & Description \\
   1.329  \hline
   1.330 @@ -7644,7 +7675,8 @@ Quals & Field & Type & Description \\
   1.331  \subsubsection{RPC name:~snapshot}
   1.332  
   1.333  {\bf Overview:} 
   1.334 -Take an exact copy of the VDI; the snapshot lives in the same Storage Repository as its parent.
   1.335 +Take an exact copy of the VDI; the snapshot lives in the same Storage
   1.336 +Repository as its parent.
   1.337  
   1.338   \noindent {\bf Signature:} 
   1.339  \begin{verbatim} (VDI ref) snapshot (session_id s, VDI ref vdi)\end{verbatim}
   1.340 @@ -8431,7 +8463,8 @@ references to objects with match names
   1.341  \begin{longtable}{|lllp{0.38\textwidth}|}
   1.342  \hline
   1.343  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf VBD} \\
   1.344 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A virtual block device}} \\
   1.345 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.346 +virtual block device.}} \\
   1.347  \hline
   1.348  Quals & Field & Type & Description \\
   1.349  \hline
   1.350 @@ -8450,7 +8483,8 @@ Quals & Field & Type & Description \\
   1.351  \subsubsection{RPC name:~media\_change}
   1.352  
   1.353  {\bf Overview:} 
   1.354 -Change the media in the device for CDROM-like devices only. For other devices, detach the VBD and attach a new one
   1.355 +Change the media in the device for CDROM-like devices only. For other
   1.356 +devices, detach the VBD and attach a new one.
   1.357  
   1.358   \noindent {\bf Signature:} 
   1.359  \begin{verbatim} void media_change (session_id s, VBD ref vbd, VDI ref vdi)\end{verbatim}
   1.360 @@ -9384,7 +9418,8 @@ all fields from the object
   1.361  \begin{longtable}{|lllp{0.38\textwidth}|}
   1.362  \hline
   1.363  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf console} \\
   1.364 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A console}} \\
   1.365 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.366 +console.}} \\
   1.367  \hline
   1.368  Quals & Field & Type & Description \\
   1.369  \hline
   1.370 @@ -9659,7 +9694,8 @@ all fields from the object
   1.371  \begin{longtable}{|lllp{0.38\textwidth}|}
   1.372  \hline
   1.373  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf user} \\
   1.374 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A user of the system}} \\
   1.375 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A
   1.376 +user of the system.}} \\
   1.377  \hline
   1.378  Quals & Field & Type & Description \\
   1.379  \hline
   1.380 @@ -9958,7 +9994,7 @@ A list of all the IDs of all the debug r
   1.381  \subsubsection{RPC name:~return\_failure}
   1.382  
   1.383  {\bf Overview:} 
   1.384 -Return an API 'successful' failure
   1.385 +Return an API 'successful' failure.
   1.386  
   1.387   \noindent {\bf Signature:} 
   1.388  \begin{verbatim} void return_failure (session_id s)\end{verbatim}