CFPEEK
	CFPEEK	Sergey Poznyakoff

• Main
• Downloads
• Documentation

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.