|AUGEAS_LENS_DIR||The default location for lens definitions|
|AUGEAS_ROOT_ENV||The env var that points to the chroot holding files we may modify.|
|AUGEAS_FILES_TREE||The root for actual file contents|
|AUGEAS_META_TREE||Augeas reports some information in this subtree|
|AUGEAS_META_FILES||Information about files|
|AUGEAS_META_TEXT||Information about text (see aug_text_store and aug_text_retrieve)|
|AUGEAS_META_ROOT||The root directory|
|AUGEAS_META_SAVE_MODE||How we save files.|
|AUGEAS_CLONE_IF_RENAME_FAILS||Control what save does when renaming the temporary file to its final destination fails with EXDEV or EBUSY: when this tree node exists, copy the file contents.|
|AUGEAS_CONTEXT||Context prepended to all non-absolute paths|
|AUGEAS_SPAN_OPTION||Enable or disable node indexes|
|MAX_ENV_SIZE||Fairly arbitrary bound on the length of the path we accept from AUGEAS_SPEC_ENV|
|PATH_SEP_CHAR||Character separating paths in a list of paths|
|escape||Escape nonprintable characters within TEXT, similar to how it’s done in C string literals.|
|print_pos||Print a pretty representation of being at position POS within TEXT|
|xread_file||Read the contents of file PATH and return them as one long string.|
|augeas||The data structure representing a connection to Augeas.|
|tree||An entry in the global config tree.|
|make_tree||Allocate a new tree node with the given LABEL, VALUE, and CHILDREN, which are not copied.|
|memstream||Wrappers to simulate OPEN_MEMSTREAM where that’s not available.|
|init_memstream||Initialize a memstream.|
|close_memstream||Close a memstream.|
An entry in the global config tree. The data structure allows associating values with interior nodes, but the API currently marks that as an error.
To make dealing with parents uniform, even for the root, we create standalone trees with a fake root, called origin. That root is generally not referenced from anywhere. Standalone trees should be created with MAKE_TREE_ORIGIN.
The DIRTY flag is used to track which parts of the tree might need to be saved. For any node that is marked dirty, all of its ancestors must be marked dirty, too. Instead of setting this flag directly, the function TREE_MARK_DIRTY in augeas.c should be used (and only functions in that file should have a need to mark nodes as dirty)
The FILE flag is set for entries underneath /augeas/files that hold the metadata for a file by ADD_FILE_INFO. The FILE flag is set for entries underneath /files for the toplevel node corresponding to a file by TREE_FREPLACE and is used by AUG_SOURCE to find the file to which a node belongs.
Wrappers to simulate OPEN_MEMSTREAM where that’s not available. The STREAM member is opened by INIT_MEMSTREAM and closed by CLOSE_MEMSTREAM. The BUF is allocated automatically, but can not be used until after CLOSE_MEMSTREAM has been called. It is the callers responsibility to free up BUF.
Escape nonprintable characters within TEXT, similar to how it’s done in C string literals.
char *escape( const char * text, int cnt, const char * extra )
char *unescape( const char * s, int len, const char * extra )
int print_chars( FILE * out, const char * text, int cnt )
Print a pretty representation of being at position POS within TEXT
void print_pos( FILE * out, const char * text, int pos )
Read the contents of file PATH and return them as one long string.
char* xread_file( const char * path )
The data structure representing a connection to Augeas.
An entry in the global config tree.
Allocate a new tree node with the given LABEL, VALUE, and CHILDREN, which are not copied.
struct tree *make_tree( char * label, char * value, struct tree * parent, struct tree * children )
Wrappers to simulate OPEN_MEMSTREAM where that’s not available.
Initialize a memstream.
int __aug_init_memstream( struct memstream * ms )
Close a memstream.
int __aug_close_memstream( struct memstream * ms )