.\" 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 "ifstate" "5" "2024-03-13"
.P
.SH NAME
.P
\fB/run/ifstate\fR - interface state database
.P
.SH DESCRIPTION
.P
The \fB/run/ifstate\fR 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.\&
.P
.SH FILE SYNTAX
.P
At a minimum, the \fB/run/ifstate\fR file contains at least one column,
the physical to logical interface mapping.\&  This column is formatted
as such:
.P
.nf
.RS 4
lo=lo
eth0=eth0
wlan0=work
.fi
.RE
.P
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.\&
.P
The next field is the reference count.\&  This is a number that reflects
the number of \fBactive\fR dependencies an interface has.\&  As interfaces
are brought up and down, the refcount may change.\&  This field is
optional.\&
.P
The final field denotes whether or not an interface was brought up
explicitly -- either by being marked as \fIauto\fR or brought up manually
using \fBifup\fR(8).\&  The contents of this field if present is the
\fIexplicit\fR keyword.\&
.P
.SH EXAMPLES
.P
An example from a typical system with localhost, eth0 and a wireguard
VPN:
.P
.nf
.RS 4
lo=lo 1 explicit
eth0=eth0 2 explicit
wg0=wg0 1 explicit
.fi
.RE
.P
.SH SEE ALSO
.P
\fBinterfaces\fR(5)
.P
.SH AUTHORS
.P
Ariadne Conill <ariadne@dereferenced.\&org>