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>.
this |
A GuestfsSession object |
true on success, false on error |