load

Load files into the tree.

Which files to load and which lenses to use on them is specified under /augeas/load in the tree. Each entry /augeas/load/NAME specifies a "transform", having exactly one child "lens" and any number of children labelled incl and excl. The value of NAME has no meaning.

The lens grandchild of /augeas/load specifies which lens to use, and can either be the fully qualified name of a lens 'module.lns' or 'module'. The latter form means that the lens from the transform marked for autoloading in MODULE should be used.

The incl and excl grandchildren of /augeas/load indicate which files to transform. Their value are used as glob patterns. Any file that matches at least one 'incl' pattern and no 'excl' pattern is transformed. The order of incl and excl entries is irrelevant.

Before loading any files, load () will remove everything underneath /augeas/files and /files, regardless of whether any entries have been modified or not.

Returns:

0 on success, -1 on error. Note that success includes the case where some files could not be loaded. Details of such files can be found under /augeas/ /error