ia64/xen-unstable

changeset 13157:d5677481f243

Document recent changes to the booting API, introducing PV and HVM groups in
favour of the old kernel / BIOS sections.

Signed-off-by: Ewan Mellor <ewan@xensource.com>
author Ewan Mellor <ewan@xensource.com>
date Thu Dec 21 13:11:24 2006 +0000 (2006-12-21)
parents 3e2d3d737624
children 38213c2544d7
files docs/xen-api/xenapi-datamodel.tex
line diff
     1.1 --- a/docs/xen-api/xenapi-datamodel.tex	Thu Dec 21 13:58:51 2006 +0000
     1.2 +++ b/docs/xen-api/xenapi-datamodel.tex	Thu Dec 21 13:11:24 2006 +0000
     1.3 @@ -244,18 +244,6 @@ The following enumeration types are used
     1.4  \vspace{1cm}
     1.5  \begin{longtable}{|ll|}
     1.6  \hline
     1.7 -{\tt enum boot\_type} & \\
     1.8 -\hline
     1.9 -\hspace{0.5cm}{\tt bios} & boot an HVM guest using an emulated BIOS \\
    1.10 -\hspace{0.5cm}{\tt grub} & boot from inside the machine using grub \\
    1.11 -\hspace{0.5cm}{\tt kernel\_external} & boot from an external kernel \\
    1.12 -\hspace{0.5cm}{\tt kernel\_internal} & boot from a kernel inside the guest filesystem \\
    1.13 -\hline
    1.14 -\end{longtable}
    1.15 -
    1.16 -\vspace{1cm}
    1.17 -\begin{longtable}{|ll|}
    1.18 -\hline
    1.19  {\tt enum vbd\_mode} & \\
    1.20  \hline
    1.21  \hspace{0.5cm}{\tt RO} & disk is mounted read-only \\
    1.22 @@ -1182,7 +1170,34 @@ references to objects with match names
    1.23  \begin{longtable}{|lllp{0.38\textwidth}|}
    1.24  \hline
    1.25  \multicolumn{1}{|l}{Name} & \multicolumn{3}{l|}{\bf VM} \\
    1.26 -\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A virtual machine (or 'guest')}} \\
    1.27 +\multicolumn{1}{|l}{Description} & \multicolumn{3}{l|}{\parbox{11cm}{\em A virtual machine (or 'guest').
    1.28 +
    1.29 +VM booting is controlled by setting one of the two mutually exclusive
    1.30 +groups: "PV", and "HVM".  If HVM.boot is the empty string, then paravirtual
    1.31 +domain building and booting will be used; otherwise the VM will be loaded
    1.32 +as an HVM domain, and booted using an emulated BIOS.
    1.33 +
    1.34 +When paravirtual booting is in use, the PV/bootloader field indicates the
    1.35 +bootloader to use.  It may be "pygrub", in which case the platform's
    1.36 +default installation of pygrub will be used, or a full path within the
    1.37 +control domain to some other bootloader.  The other fields, PV/kernel,
    1.38 +PV/ramdisk, PV/args and PV/bootloader\_args will be passed to the
    1.39 +bootloader unmodified, and interpretation of those fields is then specific
    1.40 +to the bootloader itself, including the possibility that the bootloader
    1.41 +will ignore some or all of those given values.
    1.42 +
    1.43 +If the bootloader is pygrub, then the menu.lst is parsed if present in the
    1.44 +guest's filesystem, otherwise the specified kernel and ramdisk are used, or
    1.45 +an autodetected kernel is used if nothing is specified and autodetection is
    1.46 +possible.  PV/args is appended to the kernel command line, no matter which
    1.47 +mechanism is used for finding the kernel.
    1.48 +
    1.49 +If PV/bootloader is empty but PV/kernel is specified, then the kernel and
    1.50 +ramdisk values will be treated as paths within the control domain.  If both
    1.51 +PV/bootloader and PV/kernel are empty, then the behaviour is as if
    1.52 +PV/bootloader was specified as "pygrub".
    1.53 +
    1.54 +When using HVM booting, HVM/boot specifies the order of the boot devices}} \\
    1.55  \hline
    1.56  Quals & Field & Type & Description \\
    1.57  \hline
    1.58 @@ -1215,18 +1230,17 @@ Quals & Field & Type & Description \\
    1.59  $\mathit{RO}_\mathit{run}$ &  {\tt VIFs} & (VIF ref) Set & virtual network interfaces \\
    1.60  $\mathit{RO}_\mathit{run}$ &  {\tt VBDs} & (VBD ref) Set & virtual block devices \\
    1.61  $\mathit{RO}_\mathit{run}$ &  {\tt VTPMs} & (VTPM ref) Set & virtual TPMs \\
    1.62 -$\mathit{RW}$ &  {\tt bios/boot} & string & device to boot the guest from \\
    1.63 +$\mathit{RW}$ &  {\tt PV/bootloader} & string & name of or path to bootloader \\
    1.64 +$\mathit{RW}$ &  {\tt PV/kernel} & string & path to the kernel \\
    1.65 +$\mathit{RW}$ &  {\tt PV/ramdisk} & string & path to the initrd \\
    1.66 +$\mathit{RW}$ &  {\tt PV/args} & string & kernel command-line arguments \\
    1.67 +$\mathit{RW}$ &  {\tt PV/bootloader\_args} & string & miscellaneous arguments for the bootloader \\
    1.68 +$\mathit{RW}$ &  {\tt HVM/boot} & string & device boot order \\
    1.69  $\mathit{RW}$ &  {\tt platform/std\_VGA} & bool & emulate standard VGA instead of cirrus logic \\
    1.70  $\mathit{RW}$ &  {\tt platform/serial} & string & redirect serial port to pty \\
    1.71  $\mathit{RW}$ &  {\tt platform/localtime} & bool & set RTC to local time \\
    1.72  $\mathit{RW}$ &  {\tt platform/clock\_offset} & bool & timeshift applied to guest's clock \\
    1.73  $\mathit{RW}$ &  {\tt platform/enable\_audio} & bool & emulate audio \\
    1.74 -$\mathit{RW}$ &  {\tt builder} & string & domain builder to use \\
    1.75 -$\mathit{RW}$ &  {\tt boot\_method} & boot\_type & select how this machine should boot \\
    1.76 -$\mathit{RW}$ &  {\tt kernel/kernel} & string & path to kernel e.g. /boot/vmlinuz \\
    1.77 -$\mathit{RW}$ &  {\tt kernel/initrd} & string & path to the initrd e.g. /boot/initrd.img \\
    1.78 -$\mathit{RW}$ &  {\tt kernel/args} & string & extra kernel command-line arguments \\
    1.79 -$\mathit{RW}$ &  {\tt grub/cmdline} & string & grub command-line \\
    1.80  $\mathit{RO}_\mathit{ins}$ &  {\tt PCI\_bus} & string & PCI bus path for pass-through devices \\
    1.81  $\mathit{RO}_\mathit{run}$ &  {\tt tools\_version} & (string $\rightarrow$ string) Map & versions of installed paravirtualised drivers \\
    1.82  $\mathit{RW}$ &  {\tt otherConfig} & (string $\rightarrow$ string) Map & additional configuration \\
    1.83 @@ -3192,13 +3206,145 @@ value of the field
    1.84  \vspace{0.3cm}
    1.85  \vspace{0.3cm}
    1.86  \vspace{0.3cm}
    1.87 -\subsubsection{RPC name:~get\_bios\_boot}
    1.88 -
    1.89 -{\bf Overview:} 
    1.90 -Get the bios/boot field of the given VM.
    1.91 -
    1.92 - \noindent {\bf Signature:} 
    1.93 -\begin{verbatim} string get_bios_boot (session_id s, VM ref self)\end{verbatim}
    1.94 +\subsubsection{RPC name:~get\_PV\_bootloader}
    1.95 +
    1.96 +{\bf Overview:} 
    1.97 +Get the PV/bootloader field of the given VM.
    1.98 +
    1.99 + \noindent {\bf Signature:} 
   1.100 +\begin{verbatim} string get_PV_bootloader (session_id s, VM ref self)\end{verbatim}
   1.101 +
   1.102 +
   1.103 +\noindent{\bf Arguments:}
   1.104 +
   1.105 + 
   1.106 +\vspace{0.3cm}
   1.107 +\begin{tabular}{|c|c|p{7cm}|}
   1.108 + \hline
   1.109 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.110 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.111 +
   1.112 +\end{tabular}
   1.113 +
   1.114 +\vspace{0.3cm}
   1.115 +
   1.116 + \noindent {\bf Return Type:} 
   1.117 +{\tt 
   1.118 +string
   1.119 +}
   1.120 +
   1.121 +
   1.122 +value of the field
   1.123 +\vspace{0.3cm}
   1.124 +\vspace{0.3cm}
   1.125 +\vspace{0.3cm}
   1.126 +\subsubsection{RPC name:~set\_PV\_bootloader}
   1.127 +
   1.128 +{\bf Overview:} 
   1.129 +Set the PV/bootloader field of the given VM.
   1.130 +
   1.131 + \noindent {\bf Signature:} 
   1.132 +\begin{verbatim} void set_PV_bootloader (session_id s, VM ref self, string value)\end{verbatim}
   1.133 +
   1.134 +
   1.135 +\noindent{\bf Arguments:}
   1.136 +
   1.137 + 
   1.138 +\vspace{0.3cm}
   1.139 +\begin{tabular}{|c|c|p{7cm}|}
   1.140 + \hline
   1.141 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.142 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.143 +
   1.144 +{\tt string } & value & New value to set \\ \hline 
   1.145 +
   1.146 +\end{tabular}
   1.147 +
   1.148 +\vspace{0.3cm}
   1.149 +
   1.150 + \noindent {\bf Return Type:} 
   1.151 +{\tt 
   1.152 +void
   1.153 +}
   1.154 +
   1.155 +
   1.156 +
   1.157 +\vspace{0.3cm}
   1.158 +\vspace{0.3cm}
   1.159 +\vspace{0.3cm}
   1.160 +\subsubsection{RPC name:~get\_PV\_kernel}
   1.161 +
   1.162 +{\bf Overview:} 
   1.163 +Get the PV/kernel field of the given VM.
   1.164 +
   1.165 + \noindent {\bf Signature:} 
   1.166 +\begin{verbatim} string get_PV_kernel (session_id s, VM ref self)\end{verbatim}
   1.167 +
   1.168 +
   1.169 +\noindent{\bf Arguments:}
   1.170 +
   1.171 + 
   1.172 +\vspace{0.3cm}
   1.173 +\begin{tabular}{|c|c|p{7cm}|}
   1.174 + \hline
   1.175 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.176 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.177 +
   1.178 +\end{tabular}
   1.179 +
   1.180 +\vspace{0.3cm}
   1.181 +
   1.182 + \noindent {\bf Return Type:} 
   1.183 +{\tt 
   1.184 +string
   1.185 +}
   1.186 +
   1.187 +
   1.188 +value of the field
   1.189 +\vspace{0.3cm}
   1.190 +\vspace{0.3cm}
   1.191 +\vspace{0.3cm}
   1.192 +\subsubsection{RPC name:~set\_PV\_kernel}
   1.193 +
   1.194 +{\bf Overview:} 
   1.195 +Set the PV/kernel field of the given VM.
   1.196 +
   1.197 + \noindent {\bf Signature:} 
   1.198 +\begin{verbatim} void set_PV_kernel (session_id s, VM ref self, string value)\end{verbatim}
   1.199 +
   1.200 +
   1.201 +\noindent{\bf Arguments:}
   1.202 +
   1.203 + 
   1.204 +\vspace{0.3cm}
   1.205 +\begin{tabular}{|c|c|p{7cm}|}
   1.206 + \hline
   1.207 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.208 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.209 +
   1.210 +{\tt string } & value & New value to set \\ \hline 
   1.211 +
   1.212 +\end{tabular}
   1.213 +
   1.214 +\vspace{0.3cm}
   1.215 +
   1.216 + \noindent {\bf Return Type:} 
   1.217 +{\tt 
   1.218 +void
   1.219 +}
   1.220 +
   1.221 +
   1.222 +
   1.223 +\vspace{0.3cm}
   1.224 +\vspace{0.3cm}
   1.225 +\vspace{0.3cm}
   1.226 +\subsubsection{RPC name:~get\_PV\_ramdisk}
   1.227 +
   1.228 +{\bf Overview:} 
   1.229 +Get the PV/ramdisk field of the given VM.
   1.230 +
   1.231 + \noindent {\bf Signature:} 
   1.232 +\begin{verbatim} string get_PV_ramdisk (session_id s, VM ref self)\end{verbatim}
   1.233  
   1.234  
   1.235  \noindent{\bf Arguments:}
   1.236 @@ -3224,13 +3370,211 @@ value of the field
   1.237  \vspace{0.3cm}
   1.238  \vspace{0.3cm}
   1.239  \vspace{0.3cm}
   1.240 -\subsubsection{RPC name:~set\_bios\_boot}
   1.241 -
   1.242 -{\bf Overview:} 
   1.243 -Set the bios/boot field of the given VM.
   1.244 -
   1.245 - \noindent {\bf Signature:} 
   1.246 -\begin{verbatim} void set_bios_boot (session_id s, VM ref self, string value)\end{verbatim}
   1.247 +\subsubsection{RPC name:~set\_PV\_ramdisk}
   1.248 +
   1.249 +{\bf Overview:} 
   1.250 +Set the PV/ramdisk field of the given VM.
   1.251 +
   1.252 + \noindent {\bf Signature:} 
   1.253 +\begin{verbatim} void set_PV_ramdisk (session_id s, VM ref self, string value)\end{verbatim}
   1.254 +
   1.255 +
   1.256 +\noindent{\bf Arguments:}
   1.257 +
   1.258 + 
   1.259 +\vspace{0.3cm}
   1.260 +\begin{tabular}{|c|c|p{7cm}|}
   1.261 + \hline
   1.262 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.263 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.264 +
   1.265 +{\tt string } & value & New value to set \\ \hline 
   1.266 +
   1.267 +\end{tabular}
   1.268 +
   1.269 +\vspace{0.3cm}
   1.270 +
   1.271 + \noindent {\bf Return Type:} 
   1.272 +{\tt 
   1.273 +void
   1.274 +}
   1.275 +
   1.276 +
   1.277 +
   1.278 +\vspace{0.3cm}
   1.279 +\vspace{0.3cm}
   1.280 +\vspace{0.3cm}
   1.281 +\subsubsection{RPC name:~get\_PV\_args}
   1.282 +
   1.283 +{\bf Overview:} 
   1.284 +Get the PV/args field of the given VM.
   1.285 +
   1.286 + \noindent {\bf Signature:} 
   1.287 +\begin{verbatim} string get_PV_args (session_id s, VM ref self)\end{verbatim}
   1.288 +
   1.289 +
   1.290 +\noindent{\bf Arguments:}
   1.291 +
   1.292 + 
   1.293 +\vspace{0.3cm}
   1.294 +\begin{tabular}{|c|c|p{7cm}|}
   1.295 + \hline
   1.296 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.297 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.298 +
   1.299 +\end{tabular}
   1.300 +
   1.301 +\vspace{0.3cm}
   1.302 +
   1.303 + \noindent {\bf Return Type:} 
   1.304 +{\tt 
   1.305 +string
   1.306 +}
   1.307 +
   1.308 +
   1.309 +value of the field
   1.310 +\vspace{0.3cm}
   1.311 +\vspace{0.3cm}
   1.312 +\vspace{0.3cm}
   1.313 +\subsubsection{RPC name:~set\_PV\_args}
   1.314 +
   1.315 +{\bf Overview:} 
   1.316 +Set the PV/args field of the given VM.
   1.317 +
   1.318 + \noindent {\bf Signature:} 
   1.319 +\begin{verbatim} void set_PV_args (session_id s, VM ref self, string value)\end{verbatim}
   1.320 +
   1.321 +
   1.322 +\noindent{\bf Arguments:}
   1.323 +
   1.324 + 
   1.325 +\vspace{0.3cm}
   1.326 +\begin{tabular}{|c|c|p{7cm}|}
   1.327 + \hline
   1.328 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.329 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.330 +
   1.331 +{\tt string } & value & New value to set \\ \hline 
   1.332 +
   1.333 +\end{tabular}
   1.334 +
   1.335 +\vspace{0.3cm}
   1.336 +
   1.337 + \noindent {\bf Return Type:} 
   1.338 +{\tt 
   1.339 +void
   1.340 +}
   1.341 +
   1.342 +
   1.343 +
   1.344 +\vspace{0.3cm}
   1.345 +\vspace{0.3cm}
   1.346 +\vspace{0.3cm}
   1.347 +\subsubsection{RPC name:~get\_PV\_bootloader\_args}
   1.348 +
   1.349 +{\bf Overview:} 
   1.350 +Get the PV/bootloader\_args field of the given VM.
   1.351 +
   1.352 + \noindent {\bf Signature:} 
   1.353 +\begin{verbatim} string get_PV_bootloader_args (session_id s, VM ref self)\end{verbatim}
   1.354 +
   1.355 +
   1.356 +\noindent{\bf Arguments:}
   1.357 +
   1.358 + 
   1.359 +\vspace{0.3cm}
   1.360 +\begin{tabular}{|c|c|p{7cm}|}
   1.361 + \hline
   1.362 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.363 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.364 +
   1.365 +\end{tabular}
   1.366 +
   1.367 +\vspace{0.3cm}
   1.368 +
   1.369 + \noindent {\bf Return Type:} 
   1.370 +{\tt 
   1.371 +string
   1.372 +}
   1.373 +
   1.374 +
   1.375 +value of the field
   1.376 +\vspace{0.3cm}
   1.377 +\vspace{0.3cm}
   1.378 +\vspace{0.3cm}
   1.379 +\subsubsection{RPC name:~set\_PV\_bootloader\_args}
   1.380 +
   1.381 +{\bf Overview:} 
   1.382 +Set the PV/bootloader\_args field of the given VM.
   1.383 +
   1.384 + \noindent {\bf Signature:} 
   1.385 +\begin{verbatim} void set_PV_bootloader_args (session_id s, VM ref self, string value)\end{verbatim}
   1.386 +
   1.387 +
   1.388 +\noindent{\bf Arguments:}
   1.389 +
   1.390 + 
   1.391 +\vspace{0.3cm}
   1.392 +\begin{tabular}{|c|c|p{7cm}|}
   1.393 + \hline
   1.394 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.395 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.396 +
   1.397 +{\tt string } & value & New value to set \\ \hline 
   1.398 +
   1.399 +\end{tabular}
   1.400 +
   1.401 +\vspace{0.3cm}
   1.402 +
   1.403 + \noindent {\bf Return Type:} 
   1.404 +{\tt 
   1.405 +void
   1.406 +}
   1.407 +
   1.408 +
   1.409 +
   1.410 +\vspace{0.3cm}
   1.411 +\vspace{0.3cm}
   1.412 +\vspace{0.3cm}
   1.413 +\subsubsection{RPC name:~get\_HVM\_boot}
   1.414 +
   1.415 +{\bf Overview:} 
   1.416 +Get the HVM/boot field of the given VM.
   1.417 +
   1.418 + \noindent {\bf Signature:} 
   1.419 +\begin{verbatim} string get_HVM_boot (session_id s, VM ref self)\end{verbatim}
   1.420 +
   1.421 +
   1.422 +\noindent{\bf Arguments:}
   1.423 +
   1.424 + 
   1.425 +\vspace{0.3cm}
   1.426 +\begin{tabular}{|c|c|p{7cm}|}
   1.427 + \hline
   1.428 +{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.429 +{\tt VM ref } & self & reference to the object \\ \hline 
   1.430 +
   1.431 +\end{tabular}
   1.432 +
   1.433 +\vspace{0.3cm}
   1.434 +
   1.435 + \noindent {\bf Return Type:} 
   1.436 +{\tt 
   1.437 +string
   1.438 +}
   1.439 +
   1.440 +
   1.441 +value of the field
   1.442 +\vspace{0.3cm}
   1.443 +\vspace{0.3cm}
   1.444 +\vspace{0.3cm}
   1.445 +\subsubsection{RPC name:~set\_HVM\_boot}
   1.446 +
   1.447 +{\bf Overview:} 
   1.448 +Set the HVM/boot field of the given VM.
   1.449 +
   1.450 + \noindent {\bf Signature:} 
   1.451 +\begin{verbatim} void set_HVM_boot (session_id s, VM ref self, string value)\end{verbatim}
   1.452  
   1.453  
   1.454  \noindent{\bf Arguments:}
   1.455 @@ -3588,402 +3932,6 @@ void
   1.456  \vspace{0.3cm}
   1.457  \vspace{0.3cm}
   1.458  \vspace{0.3cm}
   1.459 -\subsubsection{RPC name:~get\_builder}
   1.460 -
   1.461 -{\bf Overview:} 
   1.462 -Get the builder field of the given VM.
   1.463 -
   1.464 - \noindent {\bf Signature:} 
   1.465 -\begin{verbatim} string get_builder (session_id s, VM ref self)\end{verbatim}
   1.466 -
   1.467 -
   1.468 -\noindent{\bf Arguments:}
   1.469 -
   1.470 - 
   1.471 -\vspace{0.3cm}
   1.472 -\begin{tabular}{|c|c|p{7cm}|}
   1.473 - \hline
   1.474 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.475 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.476 -
   1.477 -\end{tabular}
   1.478 -
   1.479 -\vspace{0.3cm}
   1.480 -
   1.481 - \noindent {\bf Return Type:} 
   1.482 -{\tt 
   1.483 -string
   1.484 -}
   1.485 -
   1.486 -
   1.487 -value of the field
   1.488 -\vspace{0.3cm}
   1.489 -\vspace{0.3cm}
   1.490 -\vspace{0.3cm}
   1.491 -\subsubsection{RPC name:~set\_builder}
   1.492 -
   1.493 -{\bf Overview:} 
   1.494 -Set the builder field of the given VM.
   1.495 -
   1.496 - \noindent {\bf Signature:} 
   1.497 -\begin{verbatim} void set_builder (session_id s, VM ref self, string value)\end{verbatim}
   1.498 -
   1.499 -
   1.500 -\noindent{\bf Arguments:}
   1.501 -
   1.502 - 
   1.503 -\vspace{0.3cm}
   1.504 -\begin{tabular}{|c|c|p{7cm}|}
   1.505 - \hline
   1.506 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.507 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.508 -
   1.509 -{\tt string } & value & New value to set \\ \hline 
   1.510 -
   1.511 -\end{tabular}
   1.512 -
   1.513 -\vspace{0.3cm}
   1.514 -
   1.515 - \noindent {\bf Return Type:} 
   1.516 -{\tt 
   1.517 -void
   1.518 -}
   1.519 -
   1.520 -
   1.521 -
   1.522 -\vspace{0.3cm}
   1.523 -\vspace{0.3cm}
   1.524 -\vspace{0.3cm}
   1.525 -\subsubsection{RPC name:~get\_boot\_method}
   1.526 -
   1.527 -{\bf Overview:} 
   1.528 -Get the boot\_method field of the given VM.
   1.529 -
   1.530 - \noindent {\bf Signature:} 
   1.531 -\begin{verbatim} (boot_type) get_boot_method (session_id s, VM ref self)\end{verbatim}
   1.532 -
   1.533 -
   1.534 -\noindent{\bf Arguments:}
   1.535 -
   1.536 - 
   1.537 -\vspace{0.3cm}
   1.538 -\begin{tabular}{|c|c|p{7cm}|}
   1.539 - \hline
   1.540 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.541 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.542 -
   1.543 -\end{tabular}
   1.544 -
   1.545 -\vspace{0.3cm}
   1.546 -
   1.547 - \noindent {\bf Return Type:} 
   1.548 -{\tt 
   1.549 -boot\_type
   1.550 -}
   1.551 -
   1.552 -
   1.553 -value of the field
   1.554 -\vspace{0.3cm}
   1.555 -\vspace{0.3cm}
   1.556 -\vspace{0.3cm}
   1.557 -\subsubsection{RPC name:~set\_boot\_method}
   1.558 -
   1.559 -{\bf Overview:} 
   1.560 -Set the boot\_method field of the given VM.
   1.561 -
   1.562 - \noindent {\bf Signature:} 
   1.563 -\begin{verbatim} void set_boot_method (session_id s, VM ref self, boot_type value)\end{verbatim}
   1.564 -
   1.565 -
   1.566 -\noindent{\bf Arguments:}
   1.567 -
   1.568 - 
   1.569 -\vspace{0.3cm}
   1.570 -\begin{tabular}{|c|c|p{7cm}|}
   1.571 - \hline
   1.572 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.573 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.574 -
   1.575 -{\tt boot\_type } & value & New value to set \\ \hline 
   1.576 -
   1.577 -\end{tabular}
   1.578 -
   1.579 -\vspace{0.3cm}
   1.580 -
   1.581 - \noindent {\bf Return Type:} 
   1.582 -{\tt 
   1.583 -void
   1.584 -}
   1.585 -
   1.586 -
   1.587 -
   1.588 -\vspace{0.3cm}
   1.589 -\vspace{0.3cm}
   1.590 -\vspace{0.3cm}
   1.591 -\subsubsection{RPC name:~get\_kernel\_kernel}
   1.592 -
   1.593 -{\bf Overview:} 
   1.594 -Get the kernel/kernel field of the given VM.
   1.595 -
   1.596 - \noindent {\bf Signature:} 
   1.597 -\begin{verbatim} string get_kernel_kernel (session_id s, VM ref self)\end{verbatim}
   1.598 -
   1.599 -
   1.600 -\noindent{\bf Arguments:}
   1.601 -
   1.602 - 
   1.603 -\vspace{0.3cm}
   1.604 -\begin{tabular}{|c|c|p{7cm}|}
   1.605 - \hline
   1.606 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.607 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.608 -
   1.609 -\end{tabular}
   1.610 -
   1.611 -\vspace{0.3cm}
   1.612 -
   1.613 - \noindent {\bf Return Type:} 
   1.614 -{\tt 
   1.615 -string
   1.616 -}
   1.617 -
   1.618 -
   1.619 -value of the field
   1.620 -\vspace{0.3cm}
   1.621 -\vspace{0.3cm}
   1.622 -\vspace{0.3cm}
   1.623 -\subsubsection{RPC name:~set\_kernel\_kernel}
   1.624 -
   1.625 -{\bf Overview:} 
   1.626 -Set the kernel/kernel field of the given VM.
   1.627 -
   1.628 - \noindent {\bf Signature:} 
   1.629 -\begin{verbatim} void set_kernel_kernel (session_id s, VM ref self, string value)\end{verbatim}
   1.630 -
   1.631 -
   1.632 -\noindent{\bf Arguments:}
   1.633 -
   1.634 - 
   1.635 -\vspace{0.3cm}
   1.636 -\begin{tabular}{|c|c|p{7cm}|}
   1.637 - \hline
   1.638 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.639 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.640 -
   1.641 -{\tt string } & value & New value to set \\ \hline 
   1.642 -
   1.643 -\end{tabular}
   1.644 -
   1.645 -\vspace{0.3cm}
   1.646 -
   1.647 - \noindent {\bf Return Type:} 
   1.648 -{\tt 
   1.649 -void
   1.650 -}
   1.651 -
   1.652 -
   1.653 -
   1.654 -\vspace{0.3cm}
   1.655 -\vspace{0.3cm}
   1.656 -\vspace{0.3cm}
   1.657 -\subsubsection{RPC name:~get\_kernel\_initrd}
   1.658 -
   1.659 -{\bf Overview:} 
   1.660 -Get the kernel/initrd field of the given VM.
   1.661 -
   1.662 - \noindent {\bf Signature:} 
   1.663 -\begin{verbatim} string get_kernel_initrd (session_id s, VM ref self)\end{verbatim}
   1.664 -
   1.665 -
   1.666 -\noindent{\bf Arguments:}
   1.667 -
   1.668 - 
   1.669 -\vspace{0.3cm}
   1.670 -\begin{tabular}{|c|c|p{7cm}|}
   1.671 - \hline
   1.672 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.673 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.674 -
   1.675 -\end{tabular}
   1.676 -
   1.677 -\vspace{0.3cm}
   1.678 -
   1.679 - \noindent {\bf Return Type:} 
   1.680 -{\tt 
   1.681 -string
   1.682 -}
   1.683 -
   1.684 -
   1.685 -value of the field
   1.686 -\vspace{0.3cm}
   1.687 -\vspace{0.3cm}
   1.688 -\vspace{0.3cm}
   1.689 -\subsubsection{RPC name:~set\_kernel\_initrd}
   1.690 -
   1.691 -{\bf Overview:} 
   1.692 -Set the kernel/initrd field of the given VM.
   1.693 -
   1.694 - \noindent {\bf Signature:} 
   1.695 -\begin{verbatim} void set_kernel_initrd (session_id s, VM ref self, string value)\end{verbatim}
   1.696 -
   1.697 -
   1.698 -\noindent{\bf Arguments:}
   1.699 -
   1.700 - 
   1.701 -\vspace{0.3cm}
   1.702 -\begin{tabular}{|c|c|p{7cm}|}
   1.703 - \hline
   1.704 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.705 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.706 -
   1.707 -{\tt string } & value & New value to set \\ \hline 
   1.708 -
   1.709 -\end{tabular}
   1.710 -
   1.711 -\vspace{0.3cm}
   1.712 -
   1.713 - \noindent {\bf Return Type:} 
   1.714 -{\tt 
   1.715 -void
   1.716 -}
   1.717 -
   1.718 -
   1.719 -
   1.720 -\vspace{0.3cm}
   1.721 -\vspace{0.3cm}
   1.722 -\vspace{0.3cm}
   1.723 -\subsubsection{RPC name:~get\_kernel\_args}
   1.724 -
   1.725 -{\bf Overview:} 
   1.726 -Get the kernel/args field of the given VM.
   1.727 -
   1.728 - \noindent {\bf Signature:} 
   1.729 -\begin{verbatim} string get_kernel_args (session_id s, VM ref self)\end{verbatim}
   1.730 -
   1.731 -
   1.732 -\noindent{\bf Arguments:}
   1.733 -
   1.734 - 
   1.735 -\vspace{0.3cm}
   1.736 -\begin{tabular}{|c|c|p{7cm}|}
   1.737 - \hline
   1.738 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.739 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.740 -
   1.741 -\end{tabular}
   1.742 -
   1.743 -\vspace{0.3cm}
   1.744 -
   1.745 - \noindent {\bf Return Type:} 
   1.746 -{\tt 
   1.747 -string
   1.748 -}
   1.749 -
   1.750 -
   1.751 -value of the field
   1.752 -\vspace{0.3cm}
   1.753 -\vspace{0.3cm}
   1.754 -\vspace{0.3cm}
   1.755 -\subsubsection{RPC name:~set\_kernel\_args}
   1.756 -
   1.757 -{\bf Overview:} 
   1.758 -Set the kernel/args field of the given VM.
   1.759 -
   1.760 - \noindent {\bf Signature:} 
   1.761 -\begin{verbatim} void set_kernel_args (session_id s, VM ref self, string value)\end{verbatim}
   1.762 -
   1.763 -
   1.764 -\noindent{\bf Arguments:}
   1.765 -
   1.766 - 
   1.767 -\vspace{0.3cm}
   1.768 -\begin{tabular}{|c|c|p{7cm}|}
   1.769 - \hline
   1.770 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.771 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.772 -
   1.773 -{\tt string } & value & New value to set \\ \hline 
   1.774 -
   1.775 -\end{tabular}
   1.776 -
   1.777 -\vspace{0.3cm}
   1.778 -
   1.779 - \noindent {\bf Return Type:} 
   1.780 -{\tt 
   1.781 -void
   1.782 -}
   1.783 -
   1.784 -
   1.785 -
   1.786 -\vspace{0.3cm}
   1.787 -\vspace{0.3cm}
   1.788 -\vspace{0.3cm}
   1.789 -\subsubsection{RPC name:~get\_grub\_cmdline}
   1.790 -
   1.791 -{\bf Overview:} 
   1.792 -Get the grub/cmdline field of the given VM.
   1.793 -
   1.794 - \noindent {\bf Signature:} 
   1.795 -\begin{verbatim} string get_grub_cmdline (session_id s, VM ref self)\end{verbatim}
   1.796 -
   1.797 -
   1.798 -\noindent{\bf Arguments:}
   1.799 -
   1.800 - 
   1.801 -\vspace{0.3cm}
   1.802 -\begin{tabular}{|c|c|p{7cm}|}
   1.803 - \hline
   1.804 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.805 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.806 -
   1.807 -\end{tabular}
   1.808 -
   1.809 -\vspace{0.3cm}
   1.810 -
   1.811 - \noindent {\bf Return Type:} 
   1.812 -{\tt 
   1.813 -string
   1.814 -}
   1.815 -
   1.816 -
   1.817 -value of the field
   1.818 -\vspace{0.3cm}
   1.819 -\vspace{0.3cm}
   1.820 -\vspace{0.3cm}
   1.821 -\subsubsection{RPC name:~set\_grub\_cmdline}
   1.822 -
   1.823 -{\bf Overview:} 
   1.824 -Set the grub/cmdline field of the given VM.
   1.825 -
   1.826 - \noindent {\bf Signature:} 
   1.827 -\begin{verbatim} void set_grub_cmdline (session_id s, VM ref self, string value)\end{verbatim}
   1.828 -
   1.829 -
   1.830 -\noindent{\bf Arguments:}
   1.831 -
   1.832 - 
   1.833 -\vspace{0.3cm}
   1.834 -\begin{tabular}{|c|c|p{7cm}|}
   1.835 - \hline
   1.836 -{\bf type} & {\bf name} & {\bf description} \\ \hline
   1.837 -{\tt VM ref } & self & reference to the object \\ \hline 
   1.838 -
   1.839 -{\tt string } & value & New value to set \\ \hline 
   1.840 -
   1.841 -\end{tabular}
   1.842 -
   1.843 -\vspace{0.3cm}
   1.844 -
   1.845 - \noindent {\bf Return Type:} 
   1.846 -{\tt 
   1.847 -void
   1.848 -}
   1.849 -
   1.850 -
   1.851 -
   1.852 -\vspace{0.3cm}
   1.853 -\vspace{0.3cm}
   1.854 -\vspace{0.3cm}
   1.855  \subsubsection{RPC name:~get\_PCI\_bus}
   1.856  
   1.857  {\bf Overview:}