[systemd-devel] Documentation error for systemctl kill?

[Alan Stern]

In systemd 208 (the version currently distributed in Fedora 20), the 
man page for the systemctl(1) kill command says:

	Send a signal to one or more processes of the unit. Use --kill-who=
	to select which process to kill. Use --kill-mode= to select the
	kill mode and --signal= to select the signal to send.

This seems peculiar, because the man page does not mention a
--kill-mode= option anywhere else.  It does mention --kill-who=,
saying:

	When used with kill, choose which processes to kill. Must be one of
	main, control or all to select whether to kill only the main
	process of the unit, the control process or all processes of the
	unit. If omitted, defaults to all.

This sounds an awful lot like the description of the KillMode= option 
documented under systemd.kill(5):

	Specifies how processes of this service shall be killed. One of
	control-group, process, none....

As far as I can tell, "main" for --kill-who= means much the same thing
as "process" for KillMode=, and "all" for --kill-who= means much the
same as "control-group" for KillMode=.

So what does "control" mean for --kill-who=?  That is, what is the
control process (as opposed to the main process) of the unit?

And what about the --kill-mode= option?  According to the output from
"systemctl --help", it doesn't exist.  Is it a relic from an earlier 
version of systemctl?

Alan Stern