Index for Section 3

Alphabetical listing for I

Bottom of page

imc_kill(3)
NAME
  imc_kill - Sends a signal to a running process

LIBRARY
  Memory Channel Application Programming Interface (API) library (libimc.a)

SYNOPSIS
  #include <sys/imc.h>
  int imc_kill (
	  char	*hostname,
	  pid_t pid,
	  int	signal );

PARAMETERS
  hostname  Specifies the host on which the target process is executing.

  pid	    Specifies the process identifier (pid) of the target process.

  signal    Specifies the signal to be sent to the target process.

DESCRIPTION
  The imc_kill() function sends a signal to a target process that is
  executing on the Memory Channel API cluster member specified by the
  hostname parameter. You can obtain a list of valid host names by calling
  the imc_getclusterinfo() function.  The pid for the target process is
  specified by the pid parameter and it must be a valid pid.  Zero and
  negative pid values are not valid.

  Processes that are executing with root privileges are not allowed to send
  signals across the cluster.

  The imc_kill() function is similar to the UNIX kill function; however, it
  does not support the sending of signals to multiple processes.

RETURN VALUES
  The imc_kill() function returns one of the following values:

  IMC_SUCCESS
	    Normal successful completion.

  IMC_BADHOST
	    The host name specified in the hostname parameter is invalid.

  IMC_BADPARM
	    The value specified in the pid parameter is invalid.

  IMC_EINVAL
	    The signal specified in the signal parameter is not a valid
	    signal number. Zero and negative PID values are not permitted.

  IMC_EINVAL
	    The signal parameter is SIGKILL, SIGSTOP, SIGTSTP, or SIGCONT and
	    the specified pid is 1 (proc1).

  IMC_EPERM The real or saved user ID does not match the real or effective
	    user ID of the receiving process, the calling process does not
	    have appropriate privilege, and the process is not sending a
	    SIGCONT signal to one of its session's processes.

  IMC_ESRCH No process can be found corresponding to that specified by the
	    pid parameter.

  IMC_NOROOT
	    Superuser signalling across the cluster is not permitted.

  IMC_NOTINIT
	    This host has not been initialized to use the Memory Channel API
	    library.

RELATED INFORMATION
  Introduction: imc(3)

  Commands: imc_init(1), imcs(1)

  Functions: imc_api_init(3), imc_getclusterinfo(3), kill(2)

  Cluster Highly Available Applications

Index for Section 3

Alphabetical listing for I

Top of page