Scroll to navigation

ifquery(8) System Manager's Manual ifquery(8)

NAME

ifquery - query interface configuration and state

SYNOPSIS

ifquery [<options>...] <interfaces...>

ifquery -L|--list

ifquery -s|--state

DESCRIPTION

ifquery is used to extract information from the interface configuration file. It can also be used to convert from old versions of the interface configuration file to the current format.

OPTIONS

-a, --auto

Only match interfaces that are marked as auto.

-h, --help

Display supported options to ifquery.

-i, --interfaces FILE

Use FILE as the config database.

-p, --property PROPERTY

Print the values of matching properties for an interface.

-r, --running

Print the interface names that are marked as running in the state database.

-s, --state

Query the state database instead of the config database.

-D, --dot

Generate a dependency graph that can be used with GraphViz dot(1). Used with --list.

-I, --include PATTERN

Include PATTERN when matching against the config or state database.

-L, --list

List interfaces which exist in the configuration database.

-P, --pretty-print

When listing interfaces, print their configuration in a format that is compatible with interfaces(5) files.

-U, --allow-undefined

Create virtual interfaces for any interfaces not explicitly defined in the configuration file. This is primarily useful for property queries.

-S, --state-file FILE

Use FILE as the state database.

-T, --timeout TIMEOUT

Wait up to TIMEOUT seconds for executors to complete before raising an error.

-V, --version

Print the ifupdown-ng version and exit.

-X, --exclude PATTERN

Exclude PATTERN when matching against the config or state database.

SEE ALSO

ifup(8)
ifdown(8)
interfaces(5)

AUTHORS

Ariadne Conill <ariadne@dereferenced.org>

2024-08-02