man/augtool.1

   1 .\" Automatically generated by Pod::Man 2.27 (Pod::Simple 3.28)
   2 .\"
   3 .\" Standard preamble:
   4 .\" ========================================================================
   5 .de Sp \" Vertical space (when we can't use .PP)
   6 .if t .sp .5v
   7 .if n .sp
   8 ..
   9 .de Vb \" Begin verbatim text
  10 .ft CW
  11 .nf
  12 .ne \\$1
  13 ..
  14 .de Ve \" End verbatim text
  15 .ft R
  16 .fi
  17 ..
  18 .\" Set up some character translations and predefined strings.  \*(-- will
  19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
  20 .\" double quote, and \*(R" will give a right double quote.  \*(C+ will
  21 .\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
  22 .\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
  23 .\" nothing in troff, for use with C<>.
  24 .tr \(*W-
  25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
  26 .ie n \{\
  27 .    ds -- \(*W-
  28 .    ds PI pi
  29 .    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
  30 .    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
  31 .    ds L" ""
  32 .    ds R" ""
  33 .    ds C` ""
  34 .    ds C' ""
  35 'br\}
  36 .el\{\
  37 .    ds -- \|\(em\|
  38 .    ds PI \(*p
  39 .    ds L" ``
  40 .    ds R" ''
  41 .    ds C`
  42 .    ds C'
  43 'br\}
  44 .\"
  45 .\" Escape single quotes in literal strings from groff's Unicode transform.
  46 .ie \n(.g .ds Aq \(aq
  47 .el       .ds Aq '
  48 .\"
  49 .\" If the F register is turned on, we'll generate index entries on stderr for
  50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
  51 .\" entries marked with X<> in POD.  Of course, you'll have to process the
  52 .\" output yourself in some meaningful fashion.
  53 .\"
  54 .\" Avoid warning from groff about undefined register 'F'.
  55 .de IX
  56 ..
  57 .nr rF 0
  58 .if \n(.g .if rF .nr rF 1
  59 .if (\n(rF:(\n(.g==0)) \{
  60 .    if \nF \{
  61 .        de IX
  62 .        tm Index:\\$1\t\\n%\t"\\$2"
  63 ..
  64 .        if !\nF==2 \{
  65 .            nr % 0
  66 .            nr F 2
  67 .        \}
  68 .    \}
  69 .\}
  70 .rr rF
  71 .\"
  72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
  73 .\" Fear.  Run.  Save yourself.  No user-serviceable parts.
  74 .    \" fudge factors for nroff and troff
  75 .if n \{\
  76 .    ds #H 0
  77 .    ds #V .8m
  78 .    ds #F .3m
  79 .    ds #[ \f1
  80 .    ds #] \fP
  81 .\}
  82 .if t \{\
  83 .    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
  84 .    ds #V .6m
  85 .    ds #F 0
  86 .    ds #[ \&
  87 .    ds #] \&
  88 .\}
  89 .    \" simple accents for nroff and troff
  90 .if n \{\
  91 .    ds ' \&
  92 .    ds ` \&
  93 .    ds ^ \&
  94 .    ds , \&
  95 .    ds ~ ~
  96 .    ds /
  97 .\}
  98 .if t \{\
  99 .    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
 100 .    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
 101 .    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
 102 .    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
 103 .    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
 104 .    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
 105 .\}
 106 .    \" troff and (daisy-wheel) nroff accents
 107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
 108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
 109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
 110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
 111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
 112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
 113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
 114 .ds ae a\h'-(\w'a'u*4/10)'e
 115 .ds Ae A\h'-(\w'A'u*4/10)'E
 116 .    \" corrections for vroff
 117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
 118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
 119 .    \" for low resolution devices (crt and lpr)
 120 .if \n(.H>23 .if \n(.V>19 \
 121 \{\
 122 .    ds : e
 123 .    ds 8 ss
 124 .    ds o a
 125 .    ds d- d\h'-1'\(ga
 126 .    ds D- D\h'-1'\(hy
 127 .    ds th \o'bp'
 128 .    ds Th \o'LP'
 129 .    ds ae ae
 130 .    ds Ae AE
 131 .\}
 132 .rm #[ #] #H #V #F C
 133 .\" ========================================================================
 134 .\"
 135 .IX Title "AUGTOOL 1"
 136 .TH AUGTOOL 1 "2014-06-04" "Augeas 1.2.0" "Augeas"
 137 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 138 .\" way too many mistakes in technical documents.
 139 .if n .ad l
 140 .nh
 141 .SH "NAME"
 142 augtool \- inspect and modify configuration files
 143 .SH "SYNOPSIS"
 144 .IX Header "SYNOPSIS"
 145 augtool [\s-1OPTIONS\s0] [\s-1COMMAND\s0]
 146 .SH "DESCRIPTION"
 147 .IX Header "DESCRIPTION"
 148 Augeas is a configuration editing tool. It parses configuration files
 149 in their native formats and transforms them into a tree. Configuration
 150 changes are made by manipulating this tree and saving it back into
 151 native config files.
 152 .PP
 153 augtool provides a command line interface to the generated tree. \s-1COMMAND\s0
 154 can be a single command as described under \*(L"\s-1COMMANDS\*(R"\s0. When called with
 155 no \s-1COMMAND,\s0 it reads commands from standard input until an end-of-file is
 156 encountered.
 157 .SH "OPTIONS"
 158 .IX Header "OPTIONS"
 159 .IP "\fB\-c\fR, \fB\-\-typecheck\fR" 4
 160 .IX Item "-c, --typecheck"
 161 Typecheck lenses. This can be very slow, and is therefore not done by
 162 default, but is highly recommended during development.
 163 .IP "\fB\-b\fR, \fB\-\-backup\fR" 4
 164 .IX Item "-b, --backup"
 165 When files are changed, preserve the originals in a file with extension
 166 \&'.augsave'
 167 .IP "\fB\-n\fR, \fB\-\-new\fR" 4
 168 .IX Item "-n, --new"
 169 Save changes in files with extension '.augnew', do not modify the original
 170 files
 171 .IP "\fB\-r\fR, \fB\-\-root\fR=\fI\s-1ROOT\s0\fR" 4
 172 .IX Item "-r, --root=ROOT"
 173 Use directory \s-1ROOT\s0 as the root of the filesystem. Takes precedence over a
 174 root set with the \s-1AUGEAS_ROOT\s0 environment variable.
 175 .IP "\fB\-I\fR, \fB\-\-include\fR=\fI\s-1DIR\s0\fR" 4
 176 .IX Item "-I, --include=DIR"
 177 Add \s-1DIR\s0 to the module loadpath. Can be given multiple times. The
 178 directories set here are searched before any directories specified in the
 179 \&\s-1AUGEAS_LENS_LIB\s0 environment variable, and before the default directories
 180 \&\fI/usr/share/augeas/lenses\fR and \fI/usr/share/augeas/lenses/dist\fR.
 181 .IP "\fB\-t\fR, \fB\-\-transform\fR=\fI\s-1XFM\s0\fR" 4
 182 .IX Item "-t, --transform=XFM"
 183 Add a file transform; uses the 'transform' command syntax,
 184 e.g. \f(CW\*(C`\-t \*(AqFstab incl /etc/fstab.bak\*(Aq\*(C'\fR.
 185 .IP "\fB\-f\fR, \fB\-\-file\fR=\fI\s-1FILE\s0\fR" 4
 186 .IX Item "-f, --file=FILE"
 187 Read commands from \s-1FILE.\s0
 188 .IP "\fB\-i\fR, \fB\-\-interactive\fR" 4
 189 .IX Item "-i, --interactive"
 190 Read commands from the terminal. When combined with \fB\-f\fR or redirection of
 191 stdin, drop into an interactive session after executing the commands from
 192 the file.
 193 .IP "\fB\-e\fR, \fB\-\-echo\fR" 4
 194 .IX Item "-e, --echo"
 195 When reading commands from a file via stdin, echo the commands before
 196 printing their output.
 197 .IP "\fB\-s\fR, \fB\-\-autosave\fR" 4
 198 .IX Item "-s, --autosave"
 199 Automatically save all changes at the end of the session.
 200 .IP "\fB\-S\fR, \fB\-\-nostdinc\fR" 4
 201 .IX Item "-S, --nostdinc"
 202 Do not search any of the default directories for modules. When this option
 203 is set, only directories specified explicitly with \fB\-I\fR or specified in
 204 \&\fB\s-1AUGEAS_LENS_LIB\s0\fR will be searched for modules.
 205 .IP "\fB\-L\fR, \fB\-\-noload\fR" 4
 206 .IX Item "-L, --noload"
 207 Do not load any files on startup. This is generally used to fine-tune which
 208 files to load by modifying the entries in \f(CW\*(C`/augeas/load\*(C'\fR and then issuing
 209 a \f(CW\*(C`load\*(C'\fR command.
 210 .IP "\fB\-A\fR, \fB\-\-noautoload\fR" 4
 211 .IX Item "-A, --noautoload"
 212 Do not load any lens modules, and therefore no files, on startup. This
 213 creates no entries under \f(CW\*(C`/augeas/load\*(C'\fR whatsoever; to read any files,
 214 they need to be set up manually and loading must be initiated with a
 215 \&\f(CW\*(C`load\*(C'\fR command. Using this option gives the fastest startup.
 216 .IP "\fB\-\-span\fR" 4
 217 .IX Item "--span"
 218 Load span positions for nodes in the tree, as they relate to the original
 219 file. Enables the use of the \fBspan\fR command to retrieve position data.
 220 .IP "\fB\-\-version\fR" 4
 221 .IX Item "--version"
 222 Print version information and exit. The version is also in the tree under
 223 \&\f(CW\*(C`/augeas/version\*(C'\fR.
 224 .SH "COMMANDS"
 225 .IX Header "COMMANDS"
 226 In interactive mode, commands and paths can be completed by pressing \f(CW\*(C`TAB\*(C'\fR.
 227 .PP
 228 The paths accepted as arguments by commands use a small subset of XPath
 229 path expressions. A path expression consists of a number of segments,
 230 separated by \f(CW\*(C`/\*(C'\fR. In each segment, the character \f(CW\*(C`*\*(C'\fR can be used to match
 231 every node regardless of its label. Sibling nodes with identical labels can
 232 be distinguished by appending \f(CW\*(C`[N]\*(C'\fR to their label to match the N\-th
 233 sibling with such a label. The last sibling with a specific label can be
 234 reached as \f(CW\*(C`[last()]\*(C'\fR. See \*(L"\s-1EXAMPLES\*(R"\s0 for some examples of this.
 235 .SS "\s-1ADMIN COMMANDS\s0"
 236 .IX Subsection "ADMIN COMMANDS"
 237 The following commands control the behavior of Augeas and augtool itself.
 238 .IP "\fBhelp\fR" 4
 239 .IX Item "help"
 240 Print this help text
 241 .IP "\fBload\fR" 4
 242 .IX Item "load"
 243 Load files according to the transforms in \f(CW\*(C`/augeas/load\*(C'\fR.
 244 .IP "\fBquit\fR" 4
 245 .IX Item "quit"
 246 Exit the program
 247 .IP "\fBretrieve\fR <\s-1LENS\s0> <\s-1NODE_IN\s0> <\s-1PATH\s0> <\s-1NODE_OUT\s0>" 4
 248 .IX Item "retrieve <LENS> <NODE_IN> <PATH> <NODE_OUT>"
 249 Transform tree at \s-1PATH\s0 back into text using lens \s-1LENS\s0 and store the
 250 resulting string at \s-1NODE_OUT.\s0 Assume that the tree was initially read in
 251 with the same lens and the string stored at \s-1NODE_IN\s0 as input.
 252 .IP "\fBsave\fR" 4
 253 .IX Item "save"
 254 Save all pending changes to disk. Unless either the \fB\-b\fR or \fB\-n\fR
 255 command line options are given, files are changed in place.
 256 .IP "\fBstore\fR <\s-1LENS\s0> <\s-1NODE\s0> <\s-1PATH\s0>" 4
 257 .IX Item "store <LENS> <NODE> <PATH>"
 258 Parse \s-1NODE\s0 using \s-1LENS\s0 and store the resulting tree at \s-1PATH.\s0
 259 .IP "\fBtransform\fR <\s-1LENS\s0> <\s-1FILTER\s0> <\s-1FILE\s0>" 4
 260 .IX Item "transform <LENS> <FILTER> <FILE>"
 261 Add a transform for \s-1FILE\s0 using \s-1LENS.\s0 The \s-1LENS\s0 may be a module name or a
 262 full lens name.  If a module name is given, then \*(L"lns\*(R" will be the lens
 263 assumed.  The \s-1FILTER\s0 must be either \*(L"incl\*(R" or \*(L"excl\*(R".  If the filter is
 264 \&\*(L"incl\*(R",  the \s-1FILE\s0 will be parsed by the \s-1LENS. \s0 If the filter is \*(L"excl\*(R",
 265 the \s-1FILE\s0 will be excluded from the \s-1LENS. FILE\s0 may contain wildcards.
 266 .SS "\s-1READ COMMANDS\s0"
 267 .IX Subsection "READ COMMANDS"
 268 The following commands are used to retrieve data from the Augeas tree.
 269 .IP "\fBdump-xml\fR \fI[<\s-1PATH\s0>]\fR" 4
 270 .IX Item "dump-xml [<PATH>]"
 271 Print entries in the tree as \s-1XML.\s0 If \s-1PATH\s0 is given, printing starts there,
 272 otherwise the whole tree is printed.
 273 .IP "\fBget\fR <\s-1PATH\s0>" 4
 274 .IX Item "get <PATH>"
 275 Print the value associated with \s-1PATH\s0
 276 .IP "\fBlabel\fR <\s-1PATH\s0>" 4
 277 .IX Item "label <PATH>"
 278 Get and print the label associated with \s-1PATH\s0
 279 .IP "\fBls\fR <\s-1PATH\s0>" 4
 280 .IX Item "ls <PATH>"
 281 List the direct children of \s-1PATH\s0
 282 .IP "\fBmatch\fR <\s-1PATTERN\s0> [<\s-1VALUE\s0>]" 4
 283 .IX Item "match <PATTERN> [<VALUE>]"
 284 Find all paths that match \s-1PATTERN.\s0 If \s-1VALUE\s0 is given, only the matching
 285 paths whose value equals \s-1VALUE\s0 are printed
 286 .IP "\fBprint\fR \fI[<\s-1PATH\s0>]\fR" 4
 287 .IX Item "print [<PATH>]"
 288 Print entries in the tree. If \s-1PATH\s0 is given, printing starts there,
 289 otherwise the whole tree is printed
 290 .IP "\fBspan\fR <\s-1PATH\s0>" 4
 291 .IX Item "span <PATH>"
 292 Print the name of the file from which the node \s-1PATH\s0 was generated, as well
 293 as information about the positions in the file corresponding to the label,
 294 the value, and the entire node. \s-1PATH\s0 must match exactly one node.
 295 .Sp
 296 You need to run 'set /augeas/span enable' prior to loading files to enable
 297 recording of span information. It is disabled by default.
 298 .SS "\s-1WRITE COMMANDS\s0"
 299 .IX Subsection "WRITE COMMANDS"
 300 The following commands are used to modify the Augeas tree.
 301 .IP "\fBclear\fR <\s-1PATH\s0>" 4
 302 .IX Item "clear <PATH>"
 303 Set the value for \s-1PATH\s0 to \s-1NULL.\s0 If \s-1PATH\s0 is not in the tree yet, it and all
 304 its ancestors will be created.
 305 .IP "\fBclearm\fR <\s-1BASE\s0> <\s-1SUB\s0>" 4
 306 .IX Item "clearm <BASE> <SUB>"
 307 Clear multiple nodes values in one operation. Find or create a node matching \s-1SUB\s0
 308 by interpreting \s-1SUB\s0 as a path expression relative to each node matching
 309 \&\s-1BASE.\s0 If \s-1SUB\s0 is '.', the nodes matching \s-1BASE\s0 will be modified.
 310 .IP "\fBins\fR \fI<\s-1LABEL\s0>\fR \fI<\s-1WHERE\s0>\fR \fI<\s-1PATH\s0>\fR" 4
 311 .IX Item "ins <LABEL> <WHERE> <PATH>"
 312 Insert a new node with label \s-1LABEL\s0 right before or after \s-1PATH\s0 into the
 313 tree. \s-1WHERE\s0 must be either 'before' or 'after'.
 314 .IP "\fBinsert\fR \fI<\s-1LABEL\s0>\fR \fI<\s-1WHERE\s0>\fR \fI<\s-1PATH\s0>\fR" 4
 315 .IX Item "insert <LABEL> <WHERE> <PATH>"
 316 Alias of \fBins\fR.
 317 .IP "\fBmv\fR <\s-1SRC\s0> <\s-1DST\s0>" 4
 318 .IX Item "mv <SRC> <DST>"
 319 Move node \s-1SRC\s0 to \s-1DST. SRC\s0 must match exactly one node in the tree.  \s-1DST\s0
 320 must either match exactly one node in the tree, or may not exist yet. If
 321 \&\s-1DST\s0 exists already, it and all its descendants are deleted. If \s-1DST\s0 does not
 322 exist yet, it and all its missing ancestors are created.
 323 .IP "\fBmove\fR <\s-1SRC\s0> <\s-1DST\s0>" 4
 324 .IX Item "move <SRC> <DST>"
 325 Alias of \fBmv\fR.
 326 .IP "\fBcp\fR <\s-1SRC\s0> <\s-1DST\s0>" 4
 327 .IX Item "cp <SRC> <DST>"
 328 Copy node \s-1SRC\s0 to \s-1DST. SRC\s0 must match exactly one node in the tree.  \s-1DST\s0
 329 must either match exactly one node in the tree, or may not exist yet. If
 330 \&\s-1DST\s0 exists already, it and all its descendants are deleted. If \s-1DST\s0 does not
 331 exist yet, it and all its missing ancestors are created.
 332 .IP "\fBcopy\fR <\s-1SRC\s0> <\s-1DST\s0>" 4
 333 .IX Item "copy <SRC> <DST>"
 334 Alias of \fBcp\fR.
 335 .IP "\fBrename\fR <\s-1SRC\s0> <\s-1LBL\s0>" 4
 336 .IX Item "rename <SRC> <LBL>"
 337 Rename the label of all nodes matching \s-1SRC\s0 to \s-1LBL.\s0
 338 .IP "\fBrm\fR <\s-1PATH\s0>" 4
 339 .IX Item "rm <PATH>"
 340 Delete \s-1PATH\s0 and all its children from the tree
 341 .IP "\fBset\fR <\s-1PATH\s0> <\s-1VALUE\s0>" 4
 342 .IX Item "set <PATH> <VALUE>"
 343 Associate \s-1VALUE\s0 with \s-1PATH.\s0 If \s-1PATH\s0 is not in the tree yet,
 344 it and all its ancestors will be created.
 345 .IP "\fBsetm\fR <\s-1BASE\s0> <\s-1SUB\s0> [<\s-1VALUE\s0>]" 4
 346 .IX Item "setm <BASE> <SUB> [<VALUE>]"
 347 Set multiple nodes in one operation.  Find or create a node matching \s-1SUB\s0 by
 348 interpreting \s-1SUB\s0 as a path expression relative to each node matching
 349 \&\s-1BASE.\s0 If \s-1SUB\s0 is '.', the nodes matching \s-1BASE\s0 will be modified.
 350 .IP "\fBtouch\fR <\s-1PATH\s0>" 4
 351 .IX Item "touch <PATH>"
 352 Create \s-1PATH\s0 with the value \s-1NULL\s0 if it is not in the tree yet.  All its
 353 ancestors will also be created.  These new tree entries will appear
 354 last amongst their siblings.
 355 .SS "\s-1PATH EXPRESSION COMMANDS\s0"
 356 .IX Subsection "PATH EXPRESSION COMMANDS"
 357 The following commands help when working with path expressions.
 358 .IP "\fBdefnode\fR <\s-1NAME\s0> <\s-1EXPR\s0> [<\s-1VALUE\s0>]" 4
 359 .IX Item "defnode <NAME> <EXPR> [<VALUE>]"
 360 Define the variable \s-1NAME\s0 to the result of evaluating \s-1EXPR,\s0 which must be a
 361 nodeset. If no node matching \s-1EXPR\s0 exists yet, one is created and \s-1NAME\s0 will
 362 refer to it. If \s-1VALUE\s0 is given, this is the same as 'set \s-1EXPR VALUE\s0'; if
 363 \&\s-1VALUE\s0 is not given, the node is created as if with 'clear \s-1EXPR\s0' would and
 364 \&\s-1NAME\s0 refers to that node.
 365 .IP "\fBdefvar\fR <\s-1NAME\s0> <\s-1EXPR\s0>" 4
 366 .IX Item "defvar <NAME> <EXPR>"
 367 Define the variable \s-1NAME\s0 to the result of evaluating \s-1EXPR.\s0 The variable
 368 can be used in path expressions as \f(CW$NAME\fR. Note that \s-1EXPR\s0 is evaluated when
 369 the variable is defined, not when it is used.
 370 .SH "ENVIRONMENT VARIABLES"
 371 .IX Header "ENVIRONMENT VARIABLES"
 372 .IP "\fB\s-1AUGEAS_ROOT\s0\fR" 4
 373 .IX Item "AUGEAS_ROOT"
 374 The file system root, defaults to '/'. Can be overridden with
 375 the \fB\-r\fR command line option
 376 .IP "\fB\s-1AUGEAS_LENS_LIB\s0\fR" 4
 377 .IX Item "AUGEAS_LENS_LIB"
 378 Colon separated list of directories with lenses. Directories specified here
 379 are searched after any directories set with the \fB\-I\fR command line option,
 380 but before the default directories \fI/usr/share/augeas/lenses\fR and
 381 \&\fI/usr/share/augeas/lenses/dist\fR
 382 .SH "DIAGNOSTICS"
 383 .IX Header "DIAGNOSTICS"
 384 Normally, exit status is 0. If one or more commands fail, the exit status
 385 is set to a non-zero value.
 386 .PP
 387 Note though that failure to load some of the files specified by transforms
 388 in \f(CW\*(C`/augeas/load\*(C'\fR is not considered a failure. If it is important to know
 389 that all files were loaded, you need to issue a \f(CW\*(C`match /augeas//error\*(C'\fR
 390 after loading to find out details about what files could not be loaded and
 391 why.
 392 .SH "EXAMPLES"
 393 .IX Header "EXAMPLES"
 394 .Vb 2
 395 \&  # command line mode
 396 \&  augtool print /files/etc/hosts/
 397 \&
 398 \&  # interactive mode
 399 \&  augtool
 400 \&  augtool> help
 401 \&  augtool> print /files/etc/hosts/
 402 \&
 403 \&  # Print the third entry from the second AcceptEnv line
 404 \&  augtool print \*(Aq/files/etc/ssh/sshd_config/AcceptEnv[2]/3\*(Aq
 405 \&
 406 \&  # Find the entry in inittab with action \*(Aqinitdefault\*(Aq
 407 \&  augtool> match /files/etc/inittab/*/action initdefault
 408 \&
 409 \&  # Print the last alias for each entry in /etc/hosts
 410 \&  augtool> print /files/etc/hosts/*/alias[last()]
 411 .Ve
 412 .SH "FILES"
 413 .IX Header "FILES"
 414 Lenses and schema definitions in \fI/usr/share/augeas/lenses\fR and
 415 \&\fI/usr/share/augeas/lenses/dist\fR
 416 .SH "AUTHOR"
 417 .IX Header "AUTHOR"
 418 .Vb 1
 419 \&  David Lutterkort <dlutter@redhat.com>
 420 .Ve
 421 .SH "COPYRIGHT AND LICENSE"
 422 .IX Header "COPYRIGHT AND LICENSE"
 423 Copyright 2007\-2012 Red Hat Inc.
 424 .PP
 425 Augeas (and augtool) are distributed under the \s-1GNU\s0 Lesser General Public
 426 License (\s-1LGPL\s0)
 427 .SH "SEE ALSO"
 428 .IX Header "SEE ALSO"
 429 \&\fBAugeas\fR project homepage <http://www.augeas.net/>
 430 .PP
 431 augparse