NetworkManager/data/NetworkManager-dispatcher.service.in

[Unit]
Description=Network Manager Script Dispatcher Service
Documentation=man:NetworkManager-dispatcher.service(8)

[Service]
Type=dbus
BusName=org.freedesktop.nm_dispatcher
ExecStart=@libexecdir@/nm-dispatcher
NotifyAccess=main

# Enable debug logging in dispatcher service. Note that dispatcher
# also honors debug logging requests from NetworkManager, so you
# can also control logging requests with
# `nmcli general logging domain DISPATCHER level TRACE`.
#Environment=NM_DISPATCHER_DEBUG_LOG=1

# We want to allow scripts to spawn long-running daemons, so tell
# systemd to not clean up when nm-dispatcher exits
KillMode=process

[Install]
Alias=dbus-org.freedesktop.nm-dispatcher.service
systemd: add service for dispatcher (rh #948433) 2013-05-15 09:28:16 -05:00			`[Unit]`
			`Description=Network Manager Script Dispatcher Service`
dispatcher: show man page in .service file We have a nice man page so let's advertise it a bit by hooking it up in NetworkManager-dispatcher.service. 2023-10-20 15:08:03 +02:00			`Documentation=man:NetworkManager-dispatcher.service(8)`
systemd: add service for dispatcher (rh #948433) 2013-05-15 09:28:16 -05:00
			`[Service]`
			`Type=dbus`
			`BusName=org.freedesktop.nm_dispatcher`
dispatcher: rename executable to 'nm-dispatcher' 2014-05-14 14:51:43 -05:00			`ExecStart=@libexecdir@/nm-dispatcher`
dispatcher: fix race for exit-on-idle - exit-on-idle needs to be done correctly. Fix the race, by first notifying systemd (STOPPING=1), releasing the name, and all the while continue processing requests. - don't use g_bus_own_name_on_connection(). That one also listens to NameLost and NameAcquired signals, but we don't care about those. systemd will take care to only spawn one process at a time. And anyway, the well-known name is only important to be reachable, we don't require it to be functional. We can get the first request before RequestName completed and we can continue getting requests after releasing the name. 2021-08-03 12:58:29 +02:00			`NotifyAccess=main`
systemd: add service for dispatcher (rh #948433) 2013-05-15 09:28:16 -05:00
dispatcher: support enabling debug logging via environment variable The advantage of environment variables is that the user can use `systemctl edit NetworkManager-dispatcher.service` for setting them, without need to change the ExecStart= line. Also, enabling debugging from the start is useful, despite that debug logging can be enabled per-request. Also, there is a difference whether we want verbose logging or whether we want to log to stdout. There should be a flag, that only increases the logging verbosity, but does not change the logging backend. 2021-08-03 14:35:24 +02:00			`# Enable debug logging in dispatcher service. Note that dispatcher`
			`# also honors debug logging requests from NetworkManager, so you`
			`# can also control logging requests with`
			# `nmcli general logging domain DISPATCHER level TRACE`.
			`#Environment=NM_DISPATCHER_DEBUG_LOG=1`

dispatcher: tell systemd to not kill dispatcher children You're supposed to be able to use dispatcher scripts to spawn long-running processes, but currently systemd will kill them when nm-dispatcher exits. Fix that. https://bugzilla.gnome.org/show_bug.cgi?id=725492 2014-03-31 13:02:16 -04:00			`# We want to allow scripts to spawn long-running daemons, so tell`
			`# systemd to not clean up when nm-dispatcher exits`
			`KillMode=process`

systemd: add service for dispatcher (rh #948433) 2013-05-15 09:28:16 -05:00			`[Install]`
			`Alias=dbus-org.freedesktop.nm-dispatcher.service`