OS Manuals

/usr/bin/augtool

Library for changing configuration files

From augeas 1.15.0-r2 (enterprise-packages), captured 2026-11-08 by running augtool --help (exit 1). permalink

Usage: augtool [OPTIONS] [COMMAND]
Load the Augeas tree and modify it. If no COMMAND is given, run interactively
Run 'augtool help' to get a list of possible commands.

Options:

  -c, --typecheck        typecheck lenses
  -b, --backup           preserve originals of modified files with
                         extension '.augsave'
  -n, --new              save changes in files with extension '.augnew',
                         leave original unchanged
  -r, --root ROOT        use ROOT as the root of the filesystem
  -I, --include DIR      search DIR for modules; can be given multiple times
  -t, --transform XFM    add a file transform; uses the 'transform' command
                         syntax, e.g. -t 'Fstab incl /etc/fstab.bak'
  -l, --load-file FILE   load individual FILE in the tree
  -e, --echo             echo commands when reading from a file
  -f, --file FILE        read commands from FILE
  -s, --autosave         automatically save at the end of instructions
  -i, --interactive      run an interactive shell after evaluating
                         the commands in STDIN and FILE
  -S, --nostdinc         do not search the builtin default directories
                         for modules
  -L, --noload           do not load any files into the tree on startup
  -A, --noautoload       do not autoload modules from the search path
  --span                 load span positions for nodes related to a file
  --timing               after executing each command, show how long it took
  --version              print version information and exit.
Options (17)
OptionDescriptionSource
-c, --typecheckTypecheck lenses.help + man
-b, --backupWhen files are changed, preserve the originals in a file with extension '.augsave'help + man
-n, --newSave changes in files with extension '.augnew', do not modify the original fileshelp + man
-r, --root ROOTUse directory ROOT as the root of the filesystem.help + man
-I, --include DIRAdd DIR to the module loadpath.help + man
-t, --transform XFMadd a file transform;help + man
-l, --load-file FILELoad an individual FILE into the tree.help + man
-e, --echoWhen reading commands from a file via stdin, echo the commands before printing their output.help + man
-f, --file FILERead commands from FILE.help + man
-s, --autosaveAutomatically save all changes at the end of the session.help + man
-i, --interactiverun an interactive shell after evaluating the commands in STDIN and FILEhelp + man
-S, --nostdincdo not search the builtin default directories for moduleshelp + man
-L, --noloaddo not load any files into the tree on startuphelp + man
-A, --noautoloadDo not load any lens modules, and therefore no files, on startup.help + man
--spanLoad span positions for nodes in the tree, as they relate to the original file.help + man
--timingAfter executing each command, print how long, in milliseconds, executing the command took.help + man
--versionprint version information and exit.help + man
Examples (1) from the manual page, untested

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.