summaryrefslogtreecommitdiffstats
path: root/man/systemd.network.xml
diff options
context:
space:
mode:
authorYu Watanabe <watanabe.yu+github@gmail.com>2024-01-16 17:35:34 +0100
committerYu Watanabe <watanabe.yu+github@gmail.com>2024-01-16 20:05:43 +0100
commit3255bda698d2a02ab2f2825a1e652ac6f0871a89 (patch)
tree95f7c9b1571fb7987e004ee9ead20c933a04b189 /man/systemd.network.xml
parentwait-online: several cleanups for LinkOperationalState (diff)
downloadsystemd-3255bda698d2a02ab2f2825a1e652ac6f0871a89.tar.xz
systemd-3255bda698d2a02ab2f2825a1e652ac6f0871a89.zip
network: make 'carrier' as the default required operational state for CAN device
As CAN devices do not support IP address, hence the state never goes to higher than 'carrier'. Prompted by https://github.com/linux-can/can-utils/issues/68#issuecomment-1327987724.
Diffstat (limited to 'man/systemd.network.xml')
-rw-r--r--man/systemd.network.xml11
1 files changed, 9 insertions, 2 deletions
diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 76f9f4d042..35c897af39 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -259,8 +259,9 @@
<varlistentry>
<term><varname>RequiredForOnline=</varname></term>
<listitem>
- <para>Takes a boolean or a minimum operational state and an optional maximum operational
- state. Please see
+ <para>Takes a boolean, a minimum operational state (e.g., <literal>carrier</literal>), or a range
+ of operational state separated with a colon (e.g., <literal>degraded:routable</literal>).
+ Please see
<citerefentry><refentrytitle>networkctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
for possible operational states. When <literal>yes</literal>, the network is deemed required
when determining whether the system is online (including when running
@@ -270,6 +271,12 @@
minimum and maximum operational state required for the network interface to be considered
online.</para>
+ <para>When <literal>yes</literal> is specified for a CAN device,
+ <command>systemd-networkd-wait-online</command> deems that the interface is online when its
+ operational state becomes <literal>carrier</literal>. For an interface with other type, e.g.
+ <literal>ether</literal>, the interface is deened online when its online state is
+ <literal>degraded</literal> or <literal>routable</literal>.</para>
+
<para>Defaults to <literal>yes</literal> when <varname>ActivationPolicy=</varname> is not
set, or set to <literal>up</literal>, <literal>always-up</literal>, or
<literal>bound</literal>. Defaults to <literal>no</literal> when