bionic (1) pmsignal.1.gz

Provided by: pcp_4.0.1-1_amd64 bug

NAME

       pmsignal - send a signal to one or more processes

SYNOPSIS

       $PCP_BINADM_DIR/pmsignal [-alnp] [-s signal] [PID ...|name ...]

DESCRIPTION

       pmsignal provides a cross-platform event signalling mechanism for use with tools from the Performance Co-
       Pilot toolkit.  It can be used to send a named signal (only HUP, USR1, TERM, and KILL  are  accepted)  to
       one or more processes.

       The  processes  are  specified  directly  using  PIDs  or  as  program names (with either the -a/--all or
       -p/--program options).  In the all case, the set of all running processes is searched for  a  basename(1)
       match  on  name.   In  the program case, process identifiers are extracted from files in the $PCP_RUN_DIR
       directrory where file names are matched on name.pid.

       The -n/--dry-run option reports the list of process identifiers that would have been  signalled,  but  no
       signals are actually sent.

       If  a  signal  is  not  specified,  then  the TERM signal will be sent.  The list of supported signals is
       reported when using the -l/--list option.

       On Linux and UNIX platforms, pmsignal is a simple wrapper around the kill(1) command.  On Windows, the is
       no direct equivalent to this mechanism, and so an alternate mechanism has been implemented - this is only
       honoured by PCP tools, however, not all Windows utilities.

PCP ENVIRONMENT

       Environment variables with the prefix PCP_ are used to parameterize the file and directory names used  by
       PCP.   On  each  installation, the file /etc/pcp.conf contains the local values for these variables.  The
       $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5).

SEE ALSO

       basename(1), kill(1), killall(1), pcp.conf(5) and pcp.env(5).