diff --git a/man/systemd.network.xml b/man/systemd.network.xml
index 3e85edec6d..282ce57a00 100644
--- a/man/systemd.network.xml
+++ b/man/systemd.network.xml
@@ -220,11 +220,16 @@
systemd-networkd-wait-online). When no, the network is ignored
when determining the online state. When a minimum operational state and an optional maximum operational
state are set, yes is implied, and this controls the minimum and maximum
- operational state required for the network interface to be considered online.
- Defaults to yes.
+ operational state required for the network interface to be considered online.
- The network will be brought up normally in all cases, but in
- the event that there is no address being assigned by DHCP or the
+ Defaults to yes when ActivationPolicy= is not set,
+ or set to up, always-up, or bound.
+ Defaults to no when ActivationPolicy= is set to
+ manual or down. This is forced to no
+ when ActivationPolicy= is set to always-down.
+
+ The network will be brought up normally (as configured by ActivationPolicy=),
+ but in the event that there is no address being assigned by DHCP or the
cable is not plugged in, the link will simply remain offline and be
skipped automatically by systemd-networkd-wait-online
if RequiredForOnline=no.
@@ -265,6 +270,11 @@
the administrative state. When BindCarrier= is also set, this is
automatically set to bound and any other value is ignored.
+ When the policy is set to down or manual,
+ the default value of RequiredForOnline= is no.
+ When the policy is set to always-down, the value of
+ RequiredForOnline= forced to no.
+
The administrative state is not the same as the carrier state, so using
always-up does not mean the link will never lose carrier. The link
carrier depends on both the administrative state as well as the network device's physical
diff --git a/src/network/networkd-network.c b/src/network/networkd-network.c
index 011cb94462..850b4f449e 100644
--- a/src/network/networkd-network.c
+++ b/src/network/networkd-network.c
@@ -229,6 +229,21 @@ int network_verify(Network *network) {
if (network->ignore_carrier_loss < 0)
network->ignore_carrier_loss = network->configure_without_carrier;
+ if (IN_SET(network->activation_policy, ACTIVATION_POLICY_DOWN, ACTIVATION_POLICY_ALWAYS_DOWN, ACTIVATION_POLICY_MANUAL)) {
+ if (network->required_for_online < 0 ||
+ (network->required_for_online == true && network->activation_policy == ACTIVATION_POLICY_ALWAYS_DOWN)) {
+ log_debug("%s: Setting RequiredForOnline=no because ActivationPolicy=%s.", network->filename,
+ activation_policy_to_string(network->activation_policy));
+ network->required_for_online = false;
+ } else if (network->required_for_online == true)
+ log_warning("%s: RequiredForOnline=yes and ActivationPolicy=%s, "
+ "this may cause a delay at boot.", network->filename,
+ activation_policy_to_string(network->activation_policy));
+ }
+
+ if (network->required_for_online < 0)
+ network->required_for_online = true;
+
if (network->keep_configuration < 0)
network->keep_configuration = KEEP_CONFIGURATION_NO;
@@ -303,7 +318,7 @@ int network_load_one(Manager *manager, OrderedHashmap **networks, const char *fi
.manager = manager,
.n_ref = 1,
- .required_for_online = true,
+ .required_for_online = -1,
.required_operstate_for_online = LINK_OPERSTATE_RANGE_DEFAULT,
.activation_policy = _ACTIVATION_POLICY_INVALID,
.arp = -1,
@@ -1108,7 +1123,7 @@ int config_parse_required_for_online(
assert(network);
if (isempty(rvalue)) {
- network->required_for_online = true;
+ network->required_for_online = -1;
network->required_operstate_for_online = LINK_OPERSTATE_RANGE_DEFAULT;
return 0;
}
diff --git a/src/network/networkd-network.h b/src/network/networkd-network.h
index 98b8b95295..b39063fe8a 100644
--- a/src/network/networkd-network.h
+++ b/src/network/networkd-network.h
@@ -102,7 +102,7 @@ struct Network {
int allmulticast;
int promiscuous;
bool unmanaged;
- bool required_for_online; /* Is this network required to be considered online? */
+ int required_for_online; /* Is this network required to be considered online? */
LinkOperationalStateRange required_operstate_for_online;
AddressFamily required_family_for_online;
ActivationPolicy activation_policy;