libvirt_domain_create_xml Launch a new guest domain, based on an XML description
&reftitle.description; resource libvirt_domain_create_xml resource connection string xml

Launch a new guest domain, based on an XML description similar to the one returned by `libvirt_domain_get_xml_desc`. This function may requires privileged access to the hypervisor. The domain is not persistent, so its definition will disappear when it is destroyed, or if the host is restarted (see `libvirt_domain_define_xml` to define persistent domains).

&reftitle.parameters;

connection

  Libvirt connection obtained by calling `libvirt_connect`.

xml

  XML description of the domain. For more details see http://www.libvirt.org/formatdomain.html

&reftitle.returnvalues;

Returns &false; on failure and domain resource on success

&reftitle.seealso;

- `libvirt_domain_define_xml`