kill Command

For Windows: Not Supported

The kill UNIX BASIC program sends a UNIX signal to a D3 or UNIX process. Signals can be specified by their names, rather than by their number, and D3 processes by their port numbers instead of the UNIX PIDs.

Syntax

kill {-[signo|signame]} [pid|ppib] {[pid|ppib]...}

Parameter(s)

signo

Optional signal number in decimal. If not specified, SIGTERM is sent.

signame

Optional signal name. Among the valid signal lists are: {SIG}TERM, {SIG}HUP, and {SIG}USR2. If not specified, SIGTERM is sent.

p pib

Indicates the D3 PIB (port number), prefixed by the letter p.

’kill’

Checks that none of the specified processes have a PID of 0, which would kill all processes in the group, usually resulting in an abrupt shutdown of the D3 virtual machine.

 

WARNING

Killing the flush process logs off D3 processes immediately and shuts down the entire virtual machine. Killing the flusher can be accomplished by using the form P<process.number> with a PIB number equal to -2:

kill p-2

This should not be the normal way to shut down a virtual machine, because it loses overflow. It can be used only to do an emergency shutdown, due to an imminent power failure, for instance.

Example(s)

Kills the (UNIX) process associated with port 17.

kill p17

Sends a signal, sigalrm, to the UNIX process associated with port 33 and to the UNIX process whose PID is 7143.

kill -sigalrm p33 7143

Sends a signup to port 0.

kill -1 p0

See Also

%kill() Function, d3 Command, PID, pid Command, Port Number, psr Command