@ -874,7 +874,7 @@ free(domains);</pre></div><dl class="variablelist"><dt>conn</dt><dd>Pointer to t
<spanclass="type">unsigned int</span> dumpformat,
<spanclass="type">unsigned int</span> flags)</pre><divclass="description"><p>This method will dump the core of a domain on a given file for analysis. Note that for remote Xen Daemon the file path will be interpreted in the remote host. Hypervisors may require the user to manually ensure proper permissions on the file named by @to.</p><p>@dumpformat controls which format the dump will have; use of <ahref="libvirt-libvirt-domain.html#VIR_DOMAIN_CORE_DUMP_FORMAT_RAW">VIR_DOMAIN_CORE_DUMP_FORMAT_RAW</a> mirrors what <ahref="libvirt-libvirt-domain.html#virDomainCoreDump">virDomainCoreDump</a>() will perform. Not all hypervisors are able to support all formats.</p><p>If @flags includes <ahref="libvirt-libvirt-domain.html#VIR_DUMP_CRASH">VIR_DUMP_CRASH</a>, then leave the guest shut off with a crashed state after the dump completes. If @flags includes <ahref="libvirt-libvirt-domain.html#VIR_DUMP_LIVE">VIR_DUMP_LIVE</a>, then make the core dump while continuing to allow the guest to run; otherwise, the guest is suspended during the dump. <ahref="libvirt-libvirt-domain.html#VIR_DUMP_RESET">VIR_DUMP_RESET</a> flag forces reset of the guest after dump. The above three flags are mutually exclusive.</p><p>Additionally, if @flags includes <ahref="libvirt-libvirt-domain.html#VIR_DUMP_BYPASS_CACHE">VIR_DUMP_BYPASS_CACHE</a>, then libvirt will attempt to bypass the file system cache while creating the file, or fail if it cannot do so for the given system; this can allow less pressure on file system cache, but also risks slowing saves to NFS.</p></div><dlclass="variablelist"><dt>domain</dt><dd>a domain object</dd><dt>to</dt><dd>path for the core file</dd><dt>dumpformat</dt><dd>format of domain memory's dump (one of <ahref="libvirt-libvirt-domain.html#virDomainCoreDumpFormat">virDomainCoreDumpFormat</a> enum)</dd><dt>flags</dt><dd>bitwise-OR of <ahref="libvirt-libvirt-domain.html#virDomainCoreDumpFlags">virDomainCoreDumpFlags</a></dd><dt>Returns</dt><dd>0 in case of success and -1 in case of failure.</dd></dl><divclass="acl"></div><h3><aname="virDomainCreate"id="virDomainCreate"><code>virDomainCreate</code></a><aclass="headerlink"href="#virDomainCreate"title="Permalink to this headline">¶</a></h3><preclass="api"><spanclass="type">int</span> virDomainCreate (<spanclass="type"><ahref="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain)</pre><divclass="description"><p>Launch a defined domain. If the call succeeds the domain moves from the defined to the running domains pools. The domain will be paused only if restoring from managed state created from a paused domain. For more control, see <ahref="libvirt-libvirt-domain.html#virDomainCreateWithFlags">virDomainCreateWithFlags</a>().</p></div><dlclass="variablelist"><dt>domain</dt><dd>pointer to a defined domain</dd><dt>Returns</dt><dd>0 in case of success, -1 in case of error</dd></dl><divclass="acl"></div><h3><aname="virDomainCreateLinux"id="virDomainCreateLinux"><code>virDomainCreateLinux</code></a><aclass="headerlink"href="#virDomainCreateLinux"title="Permalink to this headline">¶</a></h3><preclass="api"><spanclass="type"><ahref="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> virDomainCreateLinux (<spanclass="type"><ahref="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a></span> conn,
<spanclass="type">const char *</span> xmlDesc,
<spanclass="type">unsigned int</span> flags)</pre><divclass="description"><p>Deprecated after 0.4.6. Renamed to <ahref="libvirt-libvirt-domain.html#virDomainCreateXML">virDomainCreateXML</a>() providing identical functionality. This existing name will left indefinitely for API compatibility.</p></div><dlclass="variablelist"><dt>conn</dt><dd>pointer to the hypervisor connection</dd><dt>xmlDesc</dt><dd>string containing an XML description of the domain</dd><dt>flags</dt><dd>extra flags; not used yet, so callers should always pass 0</dd><dt>Returns</dt><dd>a new domain object or NULL in case of failure</dd></dl><divclass="acl"></div><h3><aname="virDomainCreateWithFiles"id="virDomainCreateWithFiles"><code>virDomainCreateWithFiles</code></a><aclass="headerlink"href="#virDomainCreateWithFiles"title="Permalink to this headline">¶</a></h3><preclass="api"><spanclass="type">int</span> virDomainCreateWithFiles (<spanclass="type"><ahref="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain,
<spanclass="type">unsigned int</span> flags)</pre><divclass="description"><p>Deprecated after 0.4.6. Renamed to <ahref="libvirt-libvirt-domain.html#virDomainCreateXML">virDomainCreateXML</a>() providing identical functionality. This existing name will be left indefinitely for API compatibility.</p></div><dlclass="variablelist"><dt>conn</dt><dd>pointer to the hypervisor connection</dd><dt>xmlDesc</dt><dd>string containing an XML description of the domain</dd><dt>flags</dt><dd>extra flags; not used yet, so callers should always pass 0</dd><dt>Returns</dt><dd>a new domain object or NULL in case of failure</dd></dl><divclass="acl"></div><h3><aname="virDomainCreateWithFiles"id="virDomainCreateWithFiles"><code>virDomainCreateWithFiles</code></a><aclass="headerlink"href="#virDomainCreateWithFiles"title="Permalink to this headline">¶</a></h3><preclass="api"><spanclass="type">int</span> virDomainCreateWithFiles (<spanclass="type"><ahref="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain,
<spanclass="type">unsigned int</span> nfiles,
<spanclass="type">int *</span> files,
<spanclass="type">unsigned int</span> flags)</pre><divclass="description"><p>Launch a defined domain. If the call succeeds the domain moves from the defined to the running domains pools.</p><p>@files provides an array of file descriptors which will be made available to the 'init' process of the guest. The file handles exposed to the guest will be renumbered to start from 3 (ie immediately following stderr). This is only supported for guests which use container based virtualization technology.</p><p>If the <ahref="libvirt-libvirt-domain.html#VIR_DOMAIN_START_PAUSED">VIR_DOMAIN_START_PAUSED</a> flag is set, or if the guest domain has a managed save image that requested paused state (see <ahref="libvirt-libvirt-domain.html#virDomainManagedSave">virDomainManagedSave</a>()) the guest domain will be started, but its CPUs will remain paused. The CPUs can later be manually started using <ahref="libvirt-libvirt-domain.html#virDomainResume">virDomainResume</a>(). In all other cases, the guest domain will be running.</p><p>If the <ahref="libvirt-libvirt-domain.html#VIR_DOMAIN_START_AUTODESTROY">VIR_DOMAIN_START_AUTODESTROY</a> flag is set, the guest domain will be automatically destroyed when the <ahref="libvirt-libvirt-host.html#virConnectPtr">virConnectPtr</a> object is finally released. This will also happen if the client application crashes / loses its connection to the libvirtd daemon. Any domains marked for auto destroy will block attempts at migration, save-to-file, or snapshots.</p><p>If the <ahref="libvirt-libvirt-domain.html#VIR_DOMAIN_START_BYPASS_CACHE">VIR_DOMAIN_START_BYPASS_CACHE</a> flag is set, and there is a managed save file for this domain (created by <ahref="libvirt-libvirt-domain.html#virDomainManagedSave">virDomainManagedSave</a>()), then libvirt will attempt to bypass the file system cache while restoring the file, or fail if it cannot do so for the given system; this can allow less pressure on file system cache, but also risks slowing loads from NFS.</p><p>If the <ahref="libvirt-libvirt-domain.html#VIR_DOMAIN_START_FORCE_BOOT">VIR_DOMAIN_START_FORCE_BOOT</a> flag is set, then any managed save file for this domain is discarded, and the domain boots from scratch.</p></div><dlclass="variablelist"><dt>domain</dt><dd>pointer to a defined domain</dd><dt>nfiles</dt><dd>number of file descriptors passed</dd><dt>files</dt><dd>list of file descriptors passed</dd><dt>flags</dt><dd>bitwise-OR of supported <ahref="libvirt-libvirt-domain.html#virDomainCreateFlags">virDomainCreateFlags</a></dd><dt>Returns</dt><dd>0 in case of success, -1 in case of error</dd></dl><divclass="acl"></div><h3><aname="virDomainCreateWithFlags"id="virDomainCreateWithFlags"><code>virDomainCreateWithFlags</code></a><aclass="headerlink"href="#virDomainCreateWithFlags"title="Permalink to this headline">¶</a></h3><preclass="api"><spanclass="type">int</span> virDomainCreateWithFlags (<spanclass="type"><ahref="libvirt-libvirt-domain.html#virDomainPtr">virDomainPtr</a></span> domain,
Guido Günther
7 years ago