{
    "content": [
        {
            "type": "text",
            "text": "# SYSTEMD-NETWORKD-WAIT-ONLINE.SERVICE (info)\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\nsystemd.service(5)), that waits for the network to be configured. By\ndefault, it will wait for all links it is aware of and which are\nmanaged by systemd-networkd.service(8) to be fully configured or\nfailed, and for at least one link to be online. Here, online means that\nthe link's operational state is equal or higher than \"degraded\". The\nthreshold can be configured by --operational-state= option.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (4 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": "info",
        "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": "",
                "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"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 4,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 8,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 52,
                "subsections": [
                    {
                        "name": "--any",
                        "lines": 12,
                        "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": 4,
                "subsections": []
            }
        ],
        "sections": {
            "NAME": {
                "content": "systemd-networkd-wait-online.service, systemd-networkd-wait-online -\nWait for network to come online\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\nsystemd.service(5)), that waits for the network to be configured. By\ndefault, it will wait for all links it is aware of and which are\nmanaged by systemd-networkd.service(8) to be fully configured or\nfailed, and for at least one link to be online. Here, online means that\nthe link's operational state is equal or higher than \"degraded\". The\nthreshold can be configured by --operational-state= option.\n",
                "subsections": []
            },
            "OPTIONS": {
                "content": "The following options are understood:\n\n-i INTERFACE[:MINOPERSTATE[:MAXOPERSTATE]],\n--interface=INTERFACE[:MINOPERSTATE[:MAXOPERSTATE]]\nNetwork interface to wait for before deciding if the system is\nonline. This is useful when a system has several interfaces which\nwill be configured, but a particular one is necessary to access\nsome network resources. When used, all other interfaces are\nignored. This option may be used more than once to wait for\nmultiple network interfaces. When this option is specified multiple\ntimes, then systemd-networkd-wait-online waits for all specified\ninterfaces to be online. Optionally, required minimum and maximum\noperational states can be specified after a colon \":\". Please see\nnetworkctl(1) for possible operational states. If the operational\nstate is not specified here, then the value from RequiredForOnline=\nin the corresponding .network file is used if present, and\n\"degraded\" otherwise.\n\n--ignore=INTERFACE\nNetwork interfaces to be ignored when deciding if the system is\nonline. By default, only the loopback interface is ignored. This\noption may be used more than once to ignore multiple network\ninterfaces.\n\n-o MINOPERSTATE[:MAXOPERSTATE],\n--operational-state=MINOPERSTATE[:MAXOPERSTATE]\nTakes a minimum operational state and an optional maximum\noperational state. Please see networkctl(1) for possible\noperational states. If set, the specified value overrides\nRequiredForOnline= settings in .network files. But this does not\noverride operational states specified in --interface= option.\n\n-4, --ipv4\nWaiting for an IPv4 address of each network interface to be\nconfigured. If this option is specified with --any, then\nsystemd-networkd-wait-online exits with success when at least one\ninterface becomes online and has an IPv4 address. The option is\napplied only for the operational state \"degraded\" or above. If\nneither --ipv4 nor --ipv6 is specified, then the value from\nRequiredFamilyForOnline= in the corresponding .network file is used\nif present.\n\n-6, --ipv6\nWaiting for an IPv6 address of each network interface to be\nconfigured. If this option is specified with --any, then\nsystemd-networkd-wait-online exits with success when at least one\ninterface becomes online and has an IPv6 address. The option is\napplied only for the operational state \"degraded\" or above. If\nneither --ipv4 nor --ipv6 is specified, then the value from\nRequiredFamilyForOnline= in the corresponding .network file is used\nif present.\n",
                "subsections": [
                    {
                        "name": "--any",
                        "content": "Even if several interfaces are in configuring state,\nsystemd-networkd-wait-online exits with success when at least one\ninterface becomes online. When this option is specified with\n--interface=, then systemd-networkd-wait-online waits for one of\nthe specified interfaces to be online. This option is useful when\nsome interfaces may not have carrier on boot.\n\n--timeout=SECS\nFail the service if the network is not online by the time the\ntimeout elapses. A timeout of 0 disables the timeout. Defaults to\n120 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),\nnetworkctl(1)\n\nsystemd 249                            SYSTEMD-NETWORKD-WAIT-ONLINE.SERVICE(8)",
                "subsections": []
            }
        }
    }
}