Cfpeek User Manual (split by section):   Section:   Chapter:FastBack: Invocation   Up: Invocation   FastForward: Exit Codes   Contents: Table of ContentsIndex: Concept Index

5.2 Output Control

-H flags
--format=flags

Set output format flags. The argument is a comma-separated list of format flags and relative movement options. Relative movement options select another node, relative to the one found. They are:

parent=id

Find a parent of the matching node, which has id as its identifier.

child=id

Find a child of the matching node, which has id as its identifier.

child=id

Find a sibling of the matching node, which has id as its identifier.

up=n

Ascend n parent nodes and print the node at which the ascent stopped.

descend=n

Descend n child nodes.

Any number of relative movement options can be specified. They are executed in the order of their appearance in the --format statement. For example, --format=up=2,sibling=foo,child=bar means: ascend two levels of hierarchy, find a node named ‘foo’, look for a node named ‘bar’ among the children of that node and print the result.

If evaluation of the relative movement options results in an empty node (e.g. the ‘up’ option attempts to go past the root of the tree), nothing is output.

The delim flag controls how keyword paths is printed:

delim=char

Sets path component delimiter, instead of the default ‘.’.

The following flags control the amount of information printed for each node. These are boolean flags: when prefixed with ‘no’ they have the meaning opposite to the described.

locus

Print source location of each configuration statement. A location is printed as the file name, followed by a semicolon, followed by the line number and another semicolon. Locations are separated from the rest of output by a single space character.

path

Print statement paths.

value

Print statement values.

quote

Always quote string values.

never-quote

Never quote string values.

quote-hex

Print non-printable characters as C hex escapes. This option is ignored if ‘noquote’ is set.

descend

Descend into subnodes. Set default options.

The default format options are: ‘path,value,quote,descend’.

-q
--quiet

Suppress error diagnostics. See quiet.

Cfpeek User Manual (split by section):   Section:   Chapter:FastBack: Invocation   Up: Invocation   FastForward: Exit Codes   Contents: Table of ContentsIndex: Concept Index