OS Manuals

/usr/bin/augmatch

Library for changing configuration files

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

Usage: augmatch [OPTIONS] FILE
Print the contents of a file as parsed by augeas.

Options:

  -l, --lens LENS    use LENS to transform the file
  -L, --print-lens   print the lens that will be used for a file an exit
  -a, --all          print all nodes, even ones without a value
  -m, --match EXPR   start printing where nodes match EXPR
  -e, --exact        print only exact matches instead of the entire tree
                     starting at a match
  -o, --only-value   print only the values of tree nodes, but no path
  -q, --quiet        do not print anything. Exit with zero status if a
                     match was found
  -r, --root ROOT    use ROOT as the root of the filesystem
  -I, --include DIR  search DIR for modules; can be given mutiple times
  -S, --nostdinc     do not search the builtin default directories
                     for modules

Examples:

  Print how augeas sees /etc/exports:
    augmatch /etc/exports

  Show only the entry for a specific mount:
    augmatch -m 'dir["/home"]' /etc/exports

  Show all the clients to which we are exporting /home:
    augmatch -eom 'dir["/home"]/client' /etc/exports
Options (10)
OptionDescriptionSource
-l, --lens LENSuse LENS to transform the filehelp + man
-L, --print-lensPrint the name of the lens that will be used with the given file and exit.help + man
-a, --allPrint all tree nodes, even ones without an associated value.help + man
-m, --match EXPROnly print the parts of the tree that match the path expression EXPR.help + man
-e, --exactOnly print the parts of the tree that exactly match the expression provided with --match and not any of the descendants of matching nodes.help + man
-o, --only-valuePrint only the value and not the label or the path of nodes.help + man
-q, --quietdo not print anything.help + man
-r, --root ROOTUse directory ROOT as the root of the filesystem.help + man
-I, --include DIRAdd DIR to the module loadpath.help + man
-S, --nostdincdo not search the builtin default directories for moduleshelp + man
Exit status (3) from the manual page
0there was at least one match
1there was no match
2an error occurred
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.