{ "content": [ { "type": "text", "text": "# networkd-dispatcher (man)\n\n## NAME\n\nnetworkd-dispatcher - Dispatcher service for systemd-networkd connection status changes\n\n## SYNOPSIS\n\nnetworkd-dispatcher [-h] [-S SCRIPTDIR] [-T] [-v] [-q]\n\n## DESCRIPTION\n\nDispatcher daemon for systemd-networkd connection status changes. This daemon is similar to\nNetworkManager-dispatcher, but is much more limited in the types of events it supports due to\nthe limited nature of systemd-networkd(8).\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **OPTIONS** (5 subsections)\n- **CONFIGURATION FILES**\n- **RESOURCES**\n- **SEE ALSO**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n" } ], "structuredContent": { "command": "networkd-dispatcher", "section": "", "mode": "man", "summary": "networkd-dispatcher - Dispatcher service for systemd-networkd connection status changes", "synopsis": "networkd-dispatcher [-h] [-S SCRIPTDIR] [-T] [-v] [-q]", "tldr_summary": null, "tldr_examples": [], "tldr_source": null, "flags": [ { "flag": "-h", "long": "--help", "arg": null, "description": "Print command-line syntax and program options to stdout." }, { "flag": "-S", "long": null, "arg": null, "description": "Location under which to look for scripts. Like the PATH environment variable, this may contain multiple directories separated by : and in case multiple directories have scripts with the same name, the earliest directory wins. Defaults to /etc/networkd-dispatcher:/usr/lib/networkd-dispatcher." }, { "flag": "-T", "long": "--run-startup-triggers", "arg": null, "description": "Generate events reflecting preexisting state and behavior on startup. This can be used to ensure that triggers are belatedly run even if networkd-dispatcher is invoked after systemd-networkd has already started an interface." }, { "flag": "-v", "long": "--verbose", "arg": null, "description": "Increase verbosity by one level. The default level is WARNING. Each use of -v will increment the log level (towards INFO or DEBUG), and each use of -q will decrement it (towards ERROR or CRITICAL)." }, { "flag": "-q", "long": "--quiet", "arg": null, "description": "Decrease verbosity by one level." } ], "examples": [], "see_also": [ { "name": "systemd-networkd", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/systemd-networkd/8/json" }, { "name": "networkctl", "section": "1", "url": "https://www.chedong.com/phpMan.php/man/networkctl/1/json" }, { "name": "NETWORKD-DISPATCHER", "section": "8", "url": "https://www.chedong.com/phpMan.php/man/NETWORKD-DISPATCHER/8/json" } ], "section_outline": [ { "name": "NAME", "lines": 2, "subsections": [] }, { "name": "SYNOPSIS", "lines": 2, "subsections": [] }, { "name": "DESCRIPTION", "lines": 12, "subsections": [] }, { "name": "OPTIONS", "lines": 1, "subsections": [ { "name": "-h, --help", "lines": 2, "flag": "-h", "long": "--help" }, { "name": "-S, --script-dir=", "lines": 5, "flag": "-S" }, { "name": "-T, --run-startup-triggers", "lines": 4, "flag": "-T", "long": "--run-startup-triggers" }, { "name": "-v, --verbose", "lines": 4, "flag": "-v", "long": "--verbose" }, { "name": "-q, --quiet", "lines": 2, "flag": "-q", "long": "--quiet" } ] }, { "name": "CONFIGURATION FILES", "lines": 10, "subsections": [] }, { "name": "RESOURCES", "lines": 2, "subsections": [] }, { "name": "SEE ALSO", "lines": 5, "subsections": [] } ], "sections": { "NAME": { "content": "networkd-dispatcher - Dispatcher service for systemd-networkd connection status changes\n", "subsections": [] }, "SYNOPSIS": { "content": "networkd-dispatcher [-h] [-S SCRIPTDIR] [-T] [-v] [-q]\n", "subsections": [] }, "DESCRIPTION": { "content": "Dispatcher daemon for systemd-networkd connection status changes. This daemon is similar to\nNetworkManager-dispatcher, but is much more limited in the types of events it supports due to\nthe limited nature of systemd-networkd(8).\n\nDesired actions (scripts) are placed into directories that reflect systemd-networkd\noperational states under SCRIPTDIR and are executed when the daemon receives the relevant\nevent from systemd-networkd.\n\nThe daemon listens for signals from systemd-networkd over dbus, so it should be very light on\nresources (e.g. no polling). It is meant to be run as a system-wide daemon (as root). This\nallows it to be used for tasks such as starting a VPN after a connection is established.\n", "subsections": [] }, "OPTIONS": { "content": "", "subsections": [ { "name": "-h, --help", "content": "Print command-line syntax and program options to stdout.\n", "flag": "-h", "long": "--help" }, { "name": "-S, --script-dir=", "content": "Location under which to look for scripts. Like the PATH environment variable, this may\ncontain multiple directories separated by : and in case multiple directories have scripts\nwith the same name, the earliest directory wins. Defaults to\n/etc/networkd-dispatcher:/usr/lib/networkd-dispatcher.\n", "flag": "-S" }, { "name": "-T, --run-startup-triggers", "content": "Generate events reflecting preexisting state and behavior on startup. This can be used to\nensure that triggers are belatedly run even if networkd-dispatcher is invoked after\nsystemd-networkd has already started an interface.\n", "flag": "-T", "long": "--run-startup-triggers" }, { "name": "-v, --verbose", "content": "Increase verbosity by one level. The default level is WARNING. Each use of -v will\nincrement the log level (towards INFO or DEBUG), and each use of -q will decrement it\n(towards ERROR or CRITICAL).\n", "flag": "-v", "long": "--verbose" }, { "name": "-q, --quiet", "content": "Decrease verbosity by one level.\n", "flag": "-q", "long": "--quiet" } ] }, "CONFIGURATION FILES": { "content": "The systemd service reads /etc/default/networkd-dispatcher as an environment file for\nadditional daemon arguments.\n\nThe scripts to be run on network changes are in subdirectories routable.d/, dormant.d/,\nno-carrier.d/, off.d/, carrier.d/, degraded.d/, configured.d, configuring.d/ inside\nSCRIPTDIR. The default value for SCRIPTDIR is\n/etc/networkd-dispatcher:/usr/lib/networkd-dispatcher.\n\nFor information about the network operational states exposed by systemd, see networkctl(1).\n", "subsections": [] }, "RESOURCES": { "content": "GitHub: https://github.com/craftyguy/networkd-dispatcher\n", "subsections": [] }, "SEE ALSO": { "content": "systemd-networkd(8), networkctl(1)\n\n\n\n05/04/2022 NETWORKD-DISPATCHER(8)", "subsections": [] } } } }