Section: Open vSwitch Manual (8)Updated: May 2008Local indexUp
NAME
ovs-kill - kills processes given their pidfiles
SYNOPSIS
ovs-kill
[options] pidfile [pidfile...]
DESCRIPTION
The ovs-kill program reads each pidfile specified on the
command line and sends a signal to the program associated with it, if
any. It reads one line of text from pidfile, which must contain
the PID of the process to kill as a text string. It then uses
fcntl(2) to verify that a process with the PID from the file
owns a lock on pidfile before it sends the signal.
A pidfile whose name begins with / is used literally.
Otherwise, /var/run/openvswitch/ is prefixed.
This program exists for use by ovs-switch-setup, which cannot
easily implement its functionality since Perl has no portable
interface to fcntl-based file locking.
OPTIONS
-s number|name, --signal=number|name
Sets the signal to be sent to each process. Signals may be given by
number (e.g. 1) or by name (e.g. HUP or SIGHUP).
By default, SIGTERM is sent.
-f, --force
Causes ovs-kill to ignore all errors without printing a message
to stderr, and to exit with return code 0.
-h, --help
Prints a brief help message to the console.
-V, --version
Prints version information to the console.
EXIT CODE
Without -f or --force, ovs-kill exits with
status 0 if at least one pidfile was given and the process
represented by every pidfile was signaled successfully,
otherwise with status 1.
With -f or --force, ovs-kill always exits with
status 0.
BUGS
There is a race between verifying the lock on pidfile and
actually killing the process.
ovs-kill does not wait for the signaled processes to die before
exiting.