From 55944e5e40b1be2afc4855d8d2baf4b73d1876b5 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 10 Apr 2024 22:49:52 +0200 Subject: Adding upstream version 255.4. Signed-off-by: Daniel Baumann --- man/systemd-networkd-wait-online.service.xml | 194 +++++++++++++++++++++++++++ 1 file changed, 194 insertions(+) create mode 100644 man/systemd-networkd-wait-online.service.xml (limited to 'man/systemd-networkd-wait-online.service.xml') diff --git a/man/systemd-networkd-wait-online.service.xml b/man/systemd-networkd-wait-online.service.xml new file mode 100644 index 0000000..06f837a --- /dev/null +++ b/man/systemd-networkd-wait-online.service.xml @@ -0,0 +1,194 @@ + + + + + + + + systemd-networkd-wait-online.service + systemd + + + + systemd-networkd-wait-online.service + 8 + + + + systemd-networkd-wait-online.service + systemd-networkd-wait-online@.service + systemd-networkd-wait-online + Wait for network to come online + + + + systemd-networkd-wait-online.service + systemd-networkd-wait-online@.service + /usr/lib/systemd/systemd-networkd-wait-online + + + + Description + + systemd-networkd-wait-online is a + oneshot system service (see systemd.service5), that waits for the network to be + configured. By default, it will wait for all links it is aware of + and which are managed by + systemd-networkd.service8 + to be fully configured or failed, and for at least one link to be online. Here, online means that + the link's operational state is equal or higher than degraded. The threshold + can be configured by option. + + The service systemd-networkd-wait-online.service invokes + systemd-networkd-wait-online without any options. Thus, it waits for all managed + interfaces to be configured or failed, and for at least one to be online. + + The service systemd-networkd-wait-online@.service takes an interface + name, and invokes systemd-networkd-wait-online with and the + specified interface name. Thus, wait for the specified interface to be configured and online. For + example, systemd-networkd-wait-online@eth0.service waits for + eth0 to be configured by systemd-networkd and online. + + + + + Options + + The following options are understood: + + + + INTERFACE:MIN_OPERSTATE:MAX_OPERSTATE + INTERFACE:MIN_OPERSTATE:MAX_OPERSTATE + + Network interface to wait for before deciding if the system is online. This + is useful when a system has several interfaces which will be configured, but a particular + one is necessary to access some network resources. When used, all other interfaces are ignored. + This option may be used more than once to wait for multiple network interfaces. When this + option is specified multiple times, then systemd-networkd-wait-online waits + for all specified interfaces to be online. Optionally, required minimum and maximum operational + states can be specified after a colon :. Please see + networkctl1 + for possible operational states. If the operational state is not specified here, then + the value from RequiredForOnline= in the corresponding + .network file is used if present, and degraded otherwise. + + + + + + + INTERFACE + + Network interfaces to be ignored when deciding + if the system is online. By default, only the loopback + interface is ignored. This option may be used more than once + to ignore multiple network interfaces. + + + + + + MIN_OPERSTATE:MAX_OPERSTATE + MIN_OPERSTATE:MAX_OPERSTATE + + Takes a minimum operational state and an optional maximum operational state. + Please see networkctl1 + for possible operational states. If set, the specified value overrides + RequiredForOnline= settings in .network files. + But this does not override operational states specified in option. + + + + + + + + + + Waiting for an IPv4 address of each network interface to be configured. If this + option is specified with , then + systemd-networkd-wait-online exits with success when at least one interface + becomes online and has an IPv4 address. If the required minimum operational state is + below routable, then each link (or at least one link with + ) must have an IPv4 link-local or routable address. If the required + minimum operational state is routable, then each link must have an IPv4 + routable address. + If neither nor + is specified, then the value from + RequiredFamilyForOnline= in the corresponding .network + file is used if present. + + + + + + + + + Waiting for an IPv6 address of each network interface to be configured. If this + option is specified with , then + systemd-networkd-wait-online exits with success when at least one interface + becomes online and has an IPv6 address. If the required minimum operational state is + below routable, then each link (or at least one link with + ) must have an IPv6 link-local or routable address. If the required + minimum operational state is routable, then each link must have an IPv6 + routable address. + If neither nor + is specified, then the value from + RequiredFamilyForOnline= in the corresponding .network + file is used if present. + + + + + + + + Even if several interfaces are in configuring state, + systemd-networkd-wait-online exits with success when at least one interface + becomes online. When this option is specified with , then + systemd-networkd-wait-online waits for one of the specified interfaces to be + online. This option is useful when some interfaces may not have carrier on boot. + + + + + + + SECS + + Fail the service if the network is not online + by the time the timeout elapses. A timeout of 0 disables the + timeout. Defaults to 120 seconds. + + + + + + + + + Suppress log messages. + + + + + + + + + + + See Also + + systemd1, + systemd.service5, + systemd-networkd.service8, + networkctl1 + + + + -- cgit v1.2.3