systemd-networkd-wait-online.service.xml revision be0c13707dbbc08fb842dbf1cfe162d8cc8cb479
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
f062ed7bd262a37a909dd77ce5fc23b446818823fielding "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
2d2eda71267231c2526be701fe655db125852c1ffielding This file is part of systemd.
2d2eda71267231c2526be701fe655db125852c1ffielding Copyright 2014 Tom Gundersen
2d2eda71267231c2526be701fe655db125852c1ffielding systemd is free software; you can redistribute it and/or modify it
2d2eda71267231c2526be701fe655db125852c1ffielding under the terms of the GNU Lesser General Public License as published by
f062ed7bd262a37a909dd77ce5fc23b446818823fielding the Free Software Foundation; either version 2.1 of the License, or
2d2eda71267231c2526be701fe655db125852c1ffielding (at your option) any later version.
2d2eda71267231c2526be701fe655db125852c1ffielding systemd is distributed in the hope that it will be useful, but
2d2eda71267231c2526be701fe655db125852c1ffielding WITHOUT ANY WARRANTY; without even the implied warranty of
2d2eda71267231c2526be701fe655db125852c1ffielding MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
2d2eda71267231c2526be701fe655db125852c1ffielding Lesser General Public License for more details.
f062ed7bd262a37a909dd77ce5fc23b446818823fielding You should have received a copy of the GNU Lesser General Public License
f062ed7bd262a37a909dd77ce5fc23b446818823fielding along with systemd; If not, see <http://www.gnu.org/licenses/>.
f062ed7bd262a37a909dd77ce5fc23b446818823fielding<refentry id="systemd-networkd-wait-online.service" conditional='ENABLE_NETWORKD'>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding <refentryinfo>
2d2eda71267231c2526be701fe655db125852c1ffielding <authorgroup>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding </authorgroup>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding </refentryinfo>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding <refentrytitle>systemd-networkd-wait-online.service</refentrytitle>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding <refnamediv>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding <refname>systemd-networkd-wait-online.service</refname>
2d2eda71267231c2526be701fe655db125852c1ffielding <refpurpose>Wait for network to come online</refpurpose>
2d2eda71267231c2526be701fe655db125852c1ffielding </refnamediv>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding <refsynopsisdiv>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding <para><filename>systemd-networkd-wait-online.service</filename></para>
2d2eda71267231c2526be701fe655db125852c1ffielding <para><filename>/usr/lib/systemd/systemd-networkd-wait-online</filename></para>
f062ed7bd262a37a909dd77ce5fc23b446818823fielding </refsynopsisdiv>
2d2eda71267231c2526be701fe655db125852c1ffielding <para><command>systemd-networkd-wait-online</command> is a
2d2eda71267231c2526be701fe655db125852c1ffielding one-shot system service that waits for the network to be
2d2eda71267231c2526be701fe655db125852c1ffielding configured. By default, it will wait for all links it is aware of
2d2eda71267231c2526be701fe655db125852c1ffielding and which are managed by
2d2eda71267231c2526be701fe655db125852c1ffielding <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
2d2eda71267231c2526be701fe655db125852c1ffielding to be fully configured or failed, and for at least one link to
2d2eda71267231c2526be701fe655db125852c1ffielding gain a carrier.</para>
2d2eda71267231c2526be701fe655db125852c1ffielding </refsect1>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <variablelist>
952908500d5f99f35afc5ed510391b9bdc3833farbb <varlistentry>
2d2eda71267231c2526be701fe655db125852c1ffielding <listitem><para>Network interface to wait for before deciding
30c289e6bc6d28d210b21edd800ab2cfc78a8381wrowe if the system is online. This is useful when a system has
bd53cb2bf4d77574fd502e1c02d8c3c0d5431967stoddard several interfaces which will be configured, but a particular
b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb one is necessary to access some network resources. This option
b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb may be used more than once to wait for multiple network
44c46ef733836b32585d135d2d90856e7cfd9929rbb interfaces. When used, all other interfaces are ignored.
2d2eda71267231c2526be701fe655db125852c1ffielding </varlistentry>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <varlistentry>
14bea4ba98aabaf554e37165a07123bb05d6736bstoddard <listitem><para>Network interfaces to be ignored when deciding
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb if the system is online. By default only the loopback
9731f9232bddd7dbac757c780b2b1a2a6931dce7stoddard interface is ignored. This option may be used more than once
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb to ignore multiple network interfaces. </para></listitem>
b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb </varlistentry>
2d2eda71267231c2526be701fe655db125852c1ffielding <varlistentry>
2d2eda71267231c2526be701fe655db125852c1ffielding <listitem><para>Fail the service if the network is not online
2d2eda71267231c2526be701fe655db125852c1ffielding by the time the timeout elapses. A timeout of 0 disables the
2d2eda71267231c2526be701fe655db125852c1ffielding timeout. Defaults to 120 seconds. </para></listitem>
2d2eda71267231c2526be701fe655db125852c1ffielding </varlistentry>
2d2eda71267231c2526be701fe655db125852c1ffielding </variablelist>
2d2eda71267231c2526be701fe655db125852c1ffielding </refsect1>
2d2eda71267231c2526be701fe655db125852c1ffielding <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
2e123e8beedc9f921448c113e2d6823a92fd5261fielding <citerefentry><refentrytitle>systemd-networkd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
2d2eda71267231c2526be701fe655db125852c1ffielding </refsect1>