Poster of Linux kernelThe best gift for a Linux geek
ovs-kill

ovs-kill

Section: Open vSwitch Manual (8) Updated: May 2008
Local index Up

 

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.

 

SEE ALSO

ovs-switch-setup(8)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXIT CODE
BUGS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 22:02:05 GMT, April 16, 2011