Sends a signal to a scandir. Safe wrapper around s6‑svscanctl.
66-scanctl [ -h ] [ -z ] [ -v verbosity ] [ -l live ] [ -d notif ] [ -t rescan ] [ -o owner ] start|stop|reload|quit|nuke|zombies or any s6-svscanctl options.
This program sends a signal to an already running scandir at live where by default live is at /run/66 or the resulting path provided by the ‑l option. If owner is not explicitely set with ‑o then the user of the current process will be used instead.
-h : prints this help.
-z : use color.
-v verbosity : increases/decreases the verbosity of the command.
-l live : changes the supervision directory of service to live. By default this will be /run/66. The default can also be changed at compile time by passing the --livedir=live option to ./configure. An existing absolute path is expected and should be within a writable and executable filesystem - likely a RAM filesystem—see 66-scandir.
-d notif : notify readiness on file descriptor notif. When scandir is ready to accept commands from 66‑scanctl, it will write a newline to notif. notif cannot be lesser than 3. By default, no notification is sent. If -b is set, this option have no effects.
-t rescan : perform a scan every rescan milliseconds. If rescan is set to 0 (the default), automatic scans are never performed after the first one and s6‑svscan will only detect new services by issuing either 66‑scanctl reload or s6‑svscanctl -a. It is strongly discouraged to set rescan to a positive value under 500.
-o owner : send the signal to a scandir owned by owner instead of the current owner of the process. owner needs adecuate permissions to deal with the scandir.
Any signal accepted by s6‑svscanctl can be passed but without the dash ‑ character. As a result if you wanted to send a ‑t signal, you need to use: 66‑scanctl t. Further a series of commands is also accepted in the same way: 66‑scanctl st. A few convenient keywords were added to avoid having to remember basic and useful commands:
66-scanctl reload
Updates the process supervision tree to exactly match the services listed in scandir. This command is strictly equal to:
s6-svscanctl -an /path_to_scandir