1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
networkd-dispatcher(8)
======================
:doctype: manpage
NAME
----
networkd-dispatcher - Dispatcher service for systemd-networkd connection status
changes
SYNOPSIS
--------
*networkd-dispatcher* [-h] [-S 'SCRIPT_DIR'] [-T] [-v] [-q]
DESCRIPTION
-----------
Dispatcher daemon for systemd-networkd connection status changes. This daemon is
similar to NetworkManager-dispatcher, but is much more limited in the types of
events it supports due to the limited nature of 'systemd-networkd(8)'.
Desired actions (scripts) are placed into directories that reflect
systemd-networkd operational states under 'SCRIPT_DIR' and are executed when the
daemon receives the relevant event from systemd-networkd.
The daemon listens for signals from systemd-networkd over dbus, so it should be
very light on resources (e.g. no polling). It is meant to be run as a
system-wide daemon (as root). This allows it to be used for tasks such as
starting a VPN after a connection is established.
OPTIONS
-------
*-h, --help*::
Print command-line syntax and program options to stdout.
*-S, --script-dir='SCRIPT_DIR'*::
Location under which to look for scripts. Like the 'PATH' environment
variable, this may contain multiple directories separated by : and
in case multiple directories have scripts with the same name, the
earliest directory wins. Defaults to
/etc/networkd-dispatcher:/usr/lib/networkd-dispatcher.
*-T, --run-startup-triggers*::
Generate events reflecting preexisting state and behavior on startup. This can
be used to ensure that triggers are belatedly run even if networkd-dispatcher
is invoked after systemd-networkd has already started an interface.
*-v, --verbose*::
Increase verbosity by one level. The default level is 'WARNING'.
Each use of '-v' will increment the log level (towards 'INFO' or 'DEBUG'), and
each use of '-q' will decrement it (towards 'ERROR' or 'CRITICAL').
*-q, --quiet*::
Decrease verbosity by one level.
CONFIGURATION FILES
-------------------
The systemd service reads '/etc/default/networkd-dispatcher' as an
environment file for additional daemon arguments.
The scripts to be run on network changes are in subdirectories 'routable.d/',
'dormant.d/', 'no-carrier.d/', 'off.d/', 'carrier.d/', 'degraded.d/',
'configured.d/', 'configuring.d/' inside 'SCRIPT_DIR'. The default value for
'SCRIPT_DIR' is '/etc/networkd-dispatcher:/usr/lib/networkd-dispatcher'.
For information about the network operational states exposed by
systemd, see networkctl(1).
ENVIRONMENT
-----------
Scripts are executed with some environment variables set. Some of these
variables may not be set or may be set to an empty value, dependent
upon the type of event. These can be used by scripts to conditionally
take action based on a specific interface, state, etc.
- *IFACE* - interface that triggered the event
- *STATE* - The destination state change for which a script is currently
being invoked. May be any of the values listed as valid for
`AdministrativeState` or `OperationalState`.
- *ESSID* - for wlan connections, the ESSID the device is connected to
- *ADDR* - the ipv4 address of the device
- *IP_ADDRS* - space-delimited string of ipv4 address(es) assigned to the
device (see note below)
- *IP6_ADDRS* - space-delimited string of ipv6 address(es) assigned to
the device (see note below)
- *AdministrativeState* - One of `pending`, `configuring`, `configured`,
`unmanaged`, `failed` or `linger`.
- *OperationalState* - One of `off`, `no-carrier`, `dormant`, `carrier`,
`degraded`, `routable`, `configuring`, or `configured`. For more
information about the network operational states exposed by systemd,
see the `networkctl` manpage (`man networkctl`).
RESOURCES
---------
GitLab: https://gitlab.com/craftyguy/networkd-dispatcher
SEE ALSO
--------
systemd-networkd(8), networkctl(1)
|
