Content-type: text/html Manpage of NKILL

NKILL

Section: PUPS commands (1)
Updated: 3rd August 2001
Index Return to Main Contents

 

NAME

NKILL - distribute signal to process on remote host.

 

SYNOPSIS

nkill [signame | signum] [+vebose] [+all] [-verbose] [-slaved] [-psrp] [-ssh <username>] [-all] [+binname] !pname-1, ... pname-i, ... pname-n! >& <log file>

 

DESCRIPTION

nkill(1) destributes signals to processes in a manner similar to kill(1). In contrast to kill(1), nkill(1) is able to translate process names to process identifiers [PID's], and thus able to signal named processes. In addition nkill(1) accepts fully qualified process names of the form <name>@<host[:<username>]> or <PID>@<host[:<username>]>. In this case, if the -psrp [use PSRP connection protocols] is specified, the xkilld(1) daemon on the specified host is contacted, and the signal is sent to the specified process. In addition, if the <username> tag is specified the remote xkilld(1) daemon will run under the UID of <username> on the remote host when propagating the signal. By default it runs under the same UID as the nkill(1) process on the initiating host. If -ssh [use secure shell connection protocols] is selected, nkill(1) uses a slaved ssh(1) client to create an encrypted tunnel to the remote host, and to start a local invocation of nkill(1) on that host to propagate the signal to the remote target process.

Signals may also be sent to named process(es) on the set of hosts defined in the host capabilities file referenced by the HOSTPOOL environment variable. In this case, the signal is distributed to the specified process(es) on all hosts specified in the host pool file.

 

OPTIONS

+verbose turns on status/error logging : status and error information is sent to stderr.

-verbose turns off status/error logging.

+all pname tells nkill(1) to send signals to all processes on a given host with process (PEN) name pname.

-all pname tells nkill(1) to send signal to process pname only if it is unique (e.g. the only process named pname running on the target host).

+binname tells nkill(1) to use the name of the load binary (rather than the process execution name) when searching for processes to kill.

-ssh username tells nkill(1) to use secure shell, ssh(1) to make an encrypted connection to any remote hosts on which processes are to be killed. If username is specified remote process must be owned by that user. Otherwise, it is assumed that the remote process is owned by the user invoking the remote nkill(1). The default remote connection protocol for nkill(1) is the ssh(1) protocol.

-slaved tells nkill(1) to write terse exit codes on stdout. This option is generally specified when nkill(1) is being slaved by a process (as opposed to being used interatively via a tty).

-psrp tells nkill(1) to use PSRP protocols to make any connections to remote hosts on which processes are to be killed. It is assumed that the remote process is owned by the user invoking the remote nkill(1).

 

AUTHENTICATION

If nkill(1) requires an authentication token, it will ask for it using the getpass(3) function.

 

EXAMPLES

nkill SIGTERM procname

send signal SIGTERM to named process (procname).

nkill SIGTERM +verbose +all procname

send signal sigterm to all processes named procname and log error/status information to stderr.

nkill SIGTERM +verbose procname@hostname

send SIGTERM to named process procname (only if it is unique) running on host, hostname. Log error/status information to stderr.

nkill SIGTERM +verbose +all procname@hostname -all procname2@hostname2 PID

Send signal SIGTERM to all processes named procname running on hostname and to named process procname2 running on hostname2 (if unique). In addition send SIGTERM to process with process identifier PID running on localhost.

nkill procname

send default signal [SIGTERM] to (unique) process procname running on localhost.

nkill -all procname@?

sends default signal [SIGTERM] to all processes called procname on all hosts specified in the host pool database referenced via the environment variable HOSTPOOL.

nkill -all procname@hostpool

sends default signal [SIGTERM] to all processes called procname on all hosts specified in the host pool databased referenced via the environment variable HOSTPOOL.

 

FILES

/etc/passwd

 

ENVIRONMENT VARIABLES

HOSTPOOL - points to host pool file, e.g. setenv HOSTPOOL hostpool tells nkill(1) to read host pool data from the file hostpool (if it exists).

NKILL_VERBOSE tells nkill(1) to behave as if +verbose has been specified prior to processing pidname list.

NKILL_ALL tells nkill(1) to bevae as if +all has been specified prior to processing pidname list.

 

BUGS

When using PSRP connection protocols, the authentication mechanism while stronger than that of rsh(1) is not strong enough. The clear text password should be revesibly encrypted in the manner of ssh(1) before it is transmitted to the remote host. To seamlessly run multi-host command pipelines the username and password must be the same on all machines, which could again compromise system security in certain situations.

 

COPYRIGHT

(C) Tumbling Dice Ltd.

 

PROGRAMMER

M.A. O'Neill.
   

SEE ALSO

rttyd(1), xrshd(1), rfifod(1), xkilld(1), rpsd(1), xrsh(1), ssh(1), ps(1), inetd(1), rupd(1), telnet(1), rsh(1), kill(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHENTICATION
EXAMPLES
FILES
ENVIRONMENT VARIABLES
BUGS
COPYRIGHT
PROGRAMMER
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 13:53:35 GMT, January 11, 2008