{
    "content": [
        {
            "type": "text",
            "text": "# systemd-networkd-wait-online.service (man)\n\n## NAME\n\nsystemd-networkd-wait-online.service, systemd-networkd-wait-online - Wait for network to come online\n\n## SYNOPSIS\n\nsystemd-networkd-wait-online.service\n/lib/systemd/systemd-networkd-wait-online\n\n## DESCRIPTION\n\nsystemd-networkd-wait-online is a oneshot system service (see systemd.service(5)), that waits\nfor the network to be configured. By default, it will wait for all links it is aware of and\nwhich are managed by systemd-networkd.service(8) to be fully configured or failed, and for at\nleast one link to be online. Here, online means that the link's operational state is equal or\nhigher than \"degraded\". The threshold can be configured by --operational-state= option.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (8 subsections)\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "systemd-networkd-wait-online.service",
        "section": "",
        "mode": "man",
        "summary": "systemd-networkd-wait-online.service, systemd-networkd-wait-online - Wait for network to come online",
        "synopsis": "systemd-networkd-wait-online.service\n/lib/systemd/systemd-networkd-wait-online",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [
            {
                "flag": "-i",
                "long": null,
                "arg": null,
                "description": "--interface=INTERFACE[:MINOPERSTATE[:MAXOPERSTATE]] 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 networkctl(1) 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. --ignore=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."
            },
            {
                "flag": "-o",
                "long": null,
                "arg": null,
                "description": "Takes a minimum operational state and an optional maximum operational state. Please see networkctl(1) for possible operational states. If set, the specified value overrides RequiredForOnline= settings in .network files. But this does not override operational states specified in --interface= option."
            },
            {
                "flag": "-4",
                "long": "--ipv4",
                "arg": null,
                "description": "Waiting for an IPv4 address of each network interface to be configured. If this option is specified with --any, then systemd-networkd-wait-online exits with success when at least one interface becomes online and has an IPv4 address. The option is applied only for the operational state \"degraded\" or above. If neither --ipv4 nor --ipv6 is specified, then the value from RequiredFamilyForOnline= in the corresponding .network file is used if present."
            },
            {
                "flag": "-6",
                "long": "--ipv6",
                "arg": null,
                "description": "Waiting for an IPv6 address of each network interface to be configured. If this option is specified with --any, then systemd-networkd-wait-online exits with success when at least one interface becomes online and has an IPv6 address. The option is applied only for the operational state \"degraded\" or above. If neither --ipv4 nor --ipv6 is specified, then the value from RequiredFamilyForOnline= in the corresponding .network file is used if present."
            },
            {
                "flag": "",
                "long": "--any",
                "arg": null,
                "description": "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 --interface=, 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. --timeout=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."
            },
            {
                "flag": "-q",
                "long": "--quiet",
                "arg": null,
                "description": "Suppress log messages."
            },
            {
                "flag": "-h",
                "long": "--help",
                "arg": null,
                "description": "Print a short help text and exit."
            },
            {
                "flag": "",
                "long": "--version",
                "arg": null,
                "description": "Print a short version string and exit."
            }
        ],
        "examples": [],
        "see_also": [
            {
                "name": "systemd",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/systemd/1/json"
            },
            {
                "name": "systemd.service",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/systemd.service/5/json"
            },
            {
                "name": "systemd-networkd.service",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/systemd-networkd.service/8/json"
            },
            {
                "name": "networkctl",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/networkctl/1/json"
            },
            {
                "name": "SYSTEMD-NETWORKD-WAIT-ONLINE.SERVICE",
                "section": "8",
                "url": "https://www.chedong.com/phpMan.php/man/SYSTEMD-NETWORKD-WAIT-ONLINE.SERVICE/8/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 2,
                "subsections": [
                    {
                        "name": "-i",
                        "lines": 17,
                        "flag": "-i"
                    },
                    {
                        "name": "-o --operational-state=",
                        "lines": 5,
                        "flag": "-o"
                    },
                    {
                        "name": "-4 --ipv4",
                        "lines": 7,
                        "flag": "-4",
                        "long": "--ipv4"
                    },
                    {
                        "name": "-6 --ipv6",
                        "lines": 7,
                        "flag": "-6",
                        "long": "--ipv6"
                    },
                    {
                        "name": "--any",
                        "lines": 10,
                        "long": "--any"
                    },
                    {
                        "name": "-q --quiet",
                        "lines": 2,
                        "flag": "-q",
                        "long": "--quiet"
                    },
                    {
                        "name": "-h --help",
                        "lines": 2,
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "--version",
                        "lines": 2,
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "SEE ALSO",
                "lines": 5,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "systemd-networkd-wait-online.service, systemd-networkd-wait-online - Wait for network to come\nonline\n",
                "subsections": []
            },
            "SYNOPSIS": {
                "content": "systemd-networkd-wait-online.service\n\n/lib/systemd/systemd-networkd-wait-online\n",
                "subsections": []
            },
            "DESCRIPTION": {
                "content": "systemd-networkd-wait-online is a oneshot system service (see systemd.service(5)), that waits\nfor the network to be configured. By default, it will wait for all links it is aware of and\nwhich are managed by systemd-networkd.service(8) to be fully configured or failed, and for at\nleast one link to be online. Here, online means that the link's operational state is equal or\nhigher than \"degraded\". The threshold can be configured by --operational-state= option.\n",
                "subsections": []
            },
            "OPTIONS": {
                "content": "The following options are understood:\n",
                "subsections": [
                    {
                        "name": "-i",
                        "content": "--interface=INTERFACE[:MINOPERSTATE[:MAXOPERSTATE]]\nNetwork interface to wait for before deciding if the system is online. This is useful\nwhen a system has several interfaces which will be configured, but a particular one is\nnecessary to access some network resources. When used, all other interfaces are ignored.\nThis option may be used more than once to wait for multiple network interfaces. When this\noption is specified multiple times, then systemd-networkd-wait-online waits for all\nspecified interfaces to be online. Optionally, required minimum and maximum operational\nstates can be specified after a colon \":\". Please see networkctl(1) for possible\noperational states. If the operational state is not specified here, then the value from\nRequiredForOnline= in the corresponding .network file is used if present, and \"degraded\"\notherwise.\n\n--ignore=INTERFACE\nNetwork interfaces to be ignored when deciding if the system is online. By default, only\nthe loopback interface is ignored. This option may be used more than once to ignore\nmultiple network interfaces.\n",
                        "flag": "-i"
                    },
                    {
                        "name": "-o --operational-state=",
                        "content": "Takes a minimum operational state and an optional maximum operational state. Please see\nnetworkctl(1) for possible operational states. If set, the specified value overrides\nRequiredForOnline= settings in .network files. But this does not override operational\nstates specified in --interface= option.\n",
                        "flag": "-o"
                    },
                    {
                        "name": "-4 --ipv4",
                        "content": "Waiting for an IPv4 address of each network interface to be configured. If this option is\nspecified with --any, then systemd-networkd-wait-online exits with success when at least\none interface becomes online and has an IPv4 address. The option is applied only for the\noperational state \"degraded\" or above. If neither --ipv4 nor --ipv6 is specified, then\nthe value from RequiredFamilyForOnline= in the corresponding .network file is used if\npresent.\n",
                        "flag": "-4",
                        "long": "--ipv4"
                    },
                    {
                        "name": "-6 --ipv6",
                        "content": "Waiting for an IPv6 address of each network interface to be configured. If this option is\nspecified with --any, then systemd-networkd-wait-online exits with success when at least\none interface becomes online and has an IPv6 address. The option is applied only for the\noperational state \"degraded\" or above. If neither --ipv4 nor --ipv6 is specified, then\nthe value from RequiredFamilyForOnline= in the corresponding .network file is used if\npresent.\n",
                        "flag": "-6",
                        "long": "--ipv6"
                    },
                    {
                        "name": "--any",
                        "content": "Even if several interfaces are in configuring state, systemd-networkd-wait-online exits\nwith success when at least one interface becomes online. When this option is specified\nwith --interface=, then systemd-networkd-wait-online waits for one of the specified\ninterfaces to be online. This option is useful when some interfaces may not have carrier\non boot.\n\n--timeout=SECS\nFail the service if the network is not online by the time the timeout elapses. A timeout\nof 0 disables the timeout. Defaults to 120 seconds.\n",
                        "long": "--any"
                    },
                    {
                        "name": "-q --quiet",
                        "content": "Suppress log messages.\n",
                        "flag": "-q",
                        "long": "--quiet"
                    },
                    {
                        "name": "-h --help",
                        "content": "Print a short help text and exit.\n",
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "--version",
                        "content": "Print a short version string and exit.\n",
                        "long": "--version"
                    }
                ]
            },
            "SEE ALSO": {
                "content": "systemd(1), systemd.service(5), systemd-networkd.service(8), networkctl(1)\n\n\n\nsystemd 249                                                  SYSTEMD-NETWORKD-WAIT-ONLINE.SERVICE(8)",
                "subsections": []
            }
        }
    }
}