shutdown


Description:

[ Version ( since = "1.19.16" ) ]
public bool shutdown () throws Error

shutdown the hypervisor

This is the opposite of launch. It performs an orderly shutdown of the backend process(es). If the autosync flag is set (which is the default) then the disk image is synchronized.

If the subprocess exits with an error then this function will return an error, which should *not* be ignored (it may indicate that the disk image could not be written out properly).

It is safe to call this multiple times. Extra calls are ignored.

This call does *not* close or free up the handle. You still need to call guestfs_session_close afterwards.

guestfs_session_close will call this if you don't do it explicitly, but note that any errors are ignored in that case.

Parameters:

this

A GuestfsSession object

Returns:

true on success, false on error