aug_init


Description:

[ Version ( since = "0.7" ) ]
public bool aug_init (string root, int32 flags) throws Error

create a new Augeas handle

Create a new Augeas handle for editing configuration files. If there was any previous Augeas handle associated with this guestfs session, then it is closed.

You must call this before using any other "guestfs_aug_*" commands.

root is the filesystem root. root must not be NULL, use / instead.

The flags are the same as the flags defined in <augeas.h>, the logical *or* of the following integers:

AUG_SAVE_BACKUP = 1 Keep the original file with a ".augsave" extension.

AUG_SAVE_NEWFILE = 2 Save changes into a file with extension ".augnew", and do not overwrite original. Overrides AUG_SAVE_BACKUP.

AUG_TYPE_CHECK = 4 Typecheck lenses.

This option is only useful when debugging Augeas lenses. Use of this option may require additional memory for the libguestfs appliance. You may need to set the LIBGUESTFS_MEMSIZE environment variable or call set_memsize.

AUG_NO_STDINC = 8 Do not use standard load path for modules.

AUG_SAVE_NOOP = 16 Make save a no-op, just record what would have been changed.

AUG_NO_LOAD = 32 Do not load the tree in aug_init.

To close the handle, you can call aug_close.

To find out more about Augeas, see <ulink url='http://augeas.net/'> http://augeas.net/ </ulink>.

Parameters:

this

A GuestfsSession object

Returns:

true on success, false on error