docs: document ifstate
This commit is contained in:
parent
6cadc44183
commit
8cae485ca7
3 changed files with 59 additions and 0 deletions
1
Makefile
1
Makefile
|
@ -138,6 +138,7 @@ install: all
|
||||||
${SCDOC} < $< > $@
|
${SCDOC} < $< > $@
|
||||||
|
|
||||||
MANPAGES_5 = \
|
MANPAGES_5 = \
|
||||||
|
doc/ifstate.5 \
|
||||||
doc/ifupdown-ng.conf.5 \
|
doc/ifupdown-ng.conf.5 \
|
||||||
doc/interfaces.5 \
|
doc/interfaces.5 \
|
||||||
doc/interfaces-bond.5 \
|
doc/interfaces-bond.5 \
|
||||||
|
|
57
doc/ifstate.scd
Normal file
57
doc/ifstate.scd
Normal file
|
@ -0,0 +1,57 @@
|
||||||
|
ifstate(5)
|
||||||
|
|
||||||
|
# NAME
|
||||||
|
|
||||||
|
*/run/ifstate* - interface state database
|
||||||
|
|
||||||
|
# DESCRIPTION
|
||||||
|
|
||||||
|
The */run/ifstate* file describes the present state of the interface
|
||||||
|
configuration -- namely, how many interfaces are up, how many
|
||||||
|
dependencies each interface has which are up (the refcount), and
|
||||||
|
whether or not an interface was explicitly brought up due to request
|
||||||
|
or configuration.
|
||||||
|
|
||||||
|
# FILE SYNTAX
|
||||||
|
|
||||||
|
At a minimum, the */run/ifstate* file contains at least one column,
|
||||||
|
the physical to logical interface mapping. This column is formatted
|
||||||
|
as such:
|
||||||
|
|
||||||
|
```
|
||||||
|
lo=lo
|
||||||
|
eth0=eth0
|
||||||
|
wlan0=work
|
||||||
|
```
|
||||||
|
|
||||||
|
The left side of the mapping is the physical interface, while the right
|
||||||
|
side is the logical interface. This field is required to be present.
|
||||||
|
|
||||||
|
The next field is the reference count. This is a number that reflects
|
||||||
|
the number of *active* dependencies an interface has. As interfaces
|
||||||
|
are brought up and down, the refcount may change. This field is
|
||||||
|
optional.
|
||||||
|
|
||||||
|
The final field denotes whether or not an interface was brought up
|
||||||
|
explicitly -- either by being marked as _auto_ or brought up manually
|
||||||
|
using *ifup*(8). The contents of this field if present is the
|
||||||
|
_explicit_ keyword.
|
||||||
|
|
||||||
|
# EXAMPLES
|
||||||
|
|
||||||
|
An example from a typical system with localhost, eth0 and a wireguard
|
||||||
|
VPN:
|
||||||
|
|
||||||
|
```
|
||||||
|
lo=lo 1 explicit
|
||||||
|
eth0=eth0 2 explicit
|
||||||
|
wg0=wg0 1 explicit
|
||||||
|
```
|
||||||
|
|
||||||
|
# SEE ALSO
|
||||||
|
|
||||||
|
*interfaces*(5)
|
||||||
|
|
||||||
|
# AUTHORS
|
||||||
|
|
||||||
|
Ariadne Conill <ariadne@dereferenced.org>
|
|
@ -216,6 +216,7 @@ iface eth0
|
||||||
|
|
||||||
# SEE ALSO
|
# SEE ALSO
|
||||||
|
|
||||||
|
*ifstate*(5)
|
||||||
*ifupdown-ng.conf*(5)
|
*ifupdown-ng.conf*(5)
|
||||||
*ifup*(8)
|
*ifup*(8)
|
||||||
*ifdown*(8)
|
*ifdown*(8)
|
||||||
|
|
Loading…
Reference in a new issue