.\" Generated by scdoc 1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "ifquery" "8" "2022-10-15"
.P
.SH NAME
.P
ifquery - query interface configuration and state
.P
.SH SYNOPSIS
.P
\fBifquery\fR [<\fIoptions\fR>.\&.\&.\&] <\fIinterfaces\fR.\&.\&.\&>
.P
\fBifquery\fR -L|--list
.P
\fBifquery\fR -s|--state
.P
.SH DESCRIPTION
.P
\fBifquery\fR 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.\&
.P
.SH OPTIONS
.P
\fB-a, --auto\fR
.RS 4
Only match interfaces that are marked as \fIauto\fR.\&
.P
.RE
\fB-h, --help\fR
.RS 4
Display supported options to ifquery.\&
.P
.RE
\fB-i, --interfaces\fR \fIFILE\fR
.RS 4
Use \fIFILE\fR as the config database.\&
.P
.RE
\fB-p, --property\fR \fIPROPERTY\fR
.RS 4
Print the values of matching properties for an interface.\&
.P
.RE
\fB-r, --running\fR
.RS 4
Print the interface names that are marked as running in
the state database.\&
.P
.RE
\fB-s, --state\fR
.RS 4
Query the state database instead of the config database.\&
.P
.RE
\fB-D, --dot\fR
.RS 4
Generate a dependency graph that can be used with GraphViz
\fBdot\fR(1).\&  Used with \fB--list\fR.\&
.P
.RE
\fB-I, --include\fR \fIPATTERN\fR
.RS 4
Include \fIPATTERN\fR when matching against the config or state
database.\&
.P
.RE
\fB-L, --list\fR
.RS 4
List interfaces which exist in the configuration database.\&
.P
.RE
\fB-P, --pretty-print\fR
.RS 4
When listing interfaces, print their configuration in a format
that is compatible with \fBinterfaces\fR(5) files.\&
.P
.RE
\fB-U, --allow-undefined\fR
.RS 4
Create virtual interfaces for any interfaces not explicitly
defined in the configuration file.\&  This is primarily useful
for property queries.\&
.P
.RE
\fB-S, --state-file\fR \fIFILE\fR
.RS 4
Use \fIFILE\fR as the state database.\&
.P
.RE
\fB-V, --version\fR
.RS 4
Print the ifupdown-ng version and exit.\&
.P
.RE
\fB-X, --exclude\fR \fIPATTERN\fR
.RS 4
Exclude \fIPATTERN\fR when matching against the config or state
database.\&
.P
.RE
.SH SEE ALSO
.P
\fBifup\fR(8)
.br
\fBifdown\fR(8)
.br
\fBinterfaces\fR(5)
.P
.SH AUTHORS
.P
Ariadne Conill <ariadne@dereferenced.\&org>