add ifquery manpage

This commit is contained in:
Ariadne Conill 2020-07-24 07:48:14 -06:00
parent 6d1c67ed38
commit bc48534814
2 changed files with 79 additions and 0 deletions

View file

@ -1,3 +1,5 @@
SCDOC := scdoc
PACKAGE_NAME := ifupdown-ng PACKAGE_NAME := ifupdown-ng
PACKAGE_VERSION := 0.2 PACKAGE_VERSION := 0.2
PACKAGE_BUGREPORT := https://github.com/kaniini/ifupdown-ng/issues/new PACKAGE_BUGREPORT := https://github.com/kaniini/ifupdown-ng/issues/new
@ -54,6 +56,7 @@ libifupdown.a: ${LIBIFUPDOWN_OBJ}
clean: clean:
rm -f ${LIBIFUPDOWN_OBJ} ${CMD_OBJ} rm -f ${LIBIFUPDOWN_OBJ} ${CMD_OBJ}
rm -f ${CMDS} ${MULTICALL} rm -f ${CMDS} ${MULTICALL}
rm -f ${MANPAGES}
check: libifupdown.a ${CMDS} check: libifupdown.a ${CMDS}
kyua test kyua test
@ -63,3 +66,13 @@ install: all
for i in ${CMDS}; do \ for i in ${CMDS}; do \
ln -s /sbin/${MULTICALL} ${DESTDIR}/sbin/$$i; \ ln -s /sbin/${MULTICALL} ${DESTDIR}/sbin/$$i; \
done done
.scd.1 .scd.2 .scd.3 .scd.4 .scd.5 .scd.6 .scd.7 .scd.8:
${SCDOC} < $< > $@
MANPAGES = \
doc/ifquery.8
docs: ${MANPAGES}
.SUFFIXES: .scd .1 .2 .3 .4 .5 .6 .7 .8

66
doc/ifquery.scd Normal file
View file

@ -0,0 +1,66 @@
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.
*-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.
*-S, --state-file* _FILE_
Use _FILE_ as the state database.
*-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>