unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

sigsend(2)                       System Calls                       sigsend(2)



NAME
       sigsend,  sigsendset  -  send  a signal to a process or a group of pro-
       cesses

SYNOPSIS
       #include <signal.h>

       int sigsend(idtype_t idtype, id_t id, int sig);

       int sigsendset(procset_t *psp, int sig);

DESCRIPTION
       The sigsend() function sends a signal to the process or group  of  pro-
       cesses  specified  by id and idtype. The signal to be sent is specified
       by sig and is either  0 or one of the values listed in signal.h(3HEAD).
       If sig is  0 (the null signal), error checking is performed but no sig-
       nal is actually sent.  This value can be used to check the validity  of
       id and  idtype.

       The  real  or  effective  user ID of the sending process must match the
       real  or  saved  user  ID  of  the  receiving   process,   unless   the
       {PRIV_PROC_OWNER}  privilege  is  asserted  in the effective set of the
       sending process or sig is SIGCONT and the sending  process has the same
       session ID as the receiving process.

       If idtype is  P_PID, sig is sent to the process with process ID id.

       If  idtype  is  P_PGID, sig is sent to all processes with process group
       ID id.

       If idtype is  P_SID, sig is sent to all processes with session ID id.

       If idtype is  P_TASKID, sig is sent to all processes with task ID id.

       If idtype is  P_UID, sig is sent to any process with effective user  ID
       id.

       If idtype is  P_GID, sig is sent to any process with effective group ID
       id.

       If idtype is  P_PROJID, sig is sent to any process with project ID id.

       If idtype is  P_CID, sig is sent to any process with   scheduler  class
       ID id (see priocntl(2)).

       If  idtype is  P_CTID, sig is sent to any process with process contract
       ID id.

       If idtype is  P_ALL, sig is sent to all processes and id is ignored.

       If id is  P_MYID, the value of id is taken from the calling process.

       The process with a process ID of 0 is  always  excluded.   The  process
       with a process ID of 1 is excluded unless idtype is equal to  P_PID.

       The  sigsendset()  function provides an alternate interface for sending
       signals to sets of processes. This function sends signals to the set of
       processes  specified  by  psp.  psp is a pointer to a structure of type
       procset_t, defined in <&lt;sys/procset.h>&gt;,  which  includes  the  following
       members:

       idop_t    p_op;
       idtype_t  p_lidtype;
       id_t      p_lid;
       idtype_t  p_ridtype;
       id_t      p_rid;


       The  p_lidtype  and  p_lid  members  specify  the ID type and ID of one
       ("left") set of processes; the p_ridtype and p_rid members specify  the
       ID type and ID of a second ("right") set of processes. ID types and IDs
       are specified just as for the idtype and id arguments to sigsend(). The
       p_op  member specifies the operation to be performed on the two sets of
       processes to get the set of processes the function is to apply to.  The
       valid values for p_op and the processes they specify are:

       POP_DIFF        Set  difference: processes in left set and not in right
                       set.



       POP_AND         Set intersection: processes  in  both  left  and  right
                       sets.



       POP_OR          Set  union:  processes  in  either left or right set or
                       both.



       POP_XOR         Set exclusive-or: processes in left or  right  set  but
                       not in both.



RETURN VALUES
       Upon successful completion, 0 is return.  Otherwise, -1 is returned and
       errno is set to indicate the error.

ERRORS
       The sigsend() and sigsendset() functions will fail if:

       EINVAL          The sig argument is not a valid signal number,  or  the
                       idtype argument is not a valid idtype field.



       EINVAL          The  sig  argument is  SIGKILL, idtype is  P_PID and id
                       is  1 (proc1).



       EPERM           The effective user of  the  calling  process  does  not
                       match  the  real  or  saved  user  ID  of the receiving
                       process,  the  calling  process  does  not   have   the
                       {PRIV_PROC_OWNER}  privilege  asserted in the effective
                       set, and the calling process is not sending SIGCONT  to
                       a process that shares the same session ID.

                       The  calling  process does not have the {PRIV_PROC_SES-
                       SION} privilege asserted and is trying to send a signal
                       to  a  process with a different session ID, even though
                       the effective user ID matches the real or saved  ID  of
                       the receiving process.



       ESRCH           No process can be found corresponding to that specified
                       by id and idtype.



       The  sigsendset() function will fail if:

       EFAULT          The psp argument points to an illegal address.



SEE ALSO
       kill(1), getpid(2), kill(2), priocntl(2), signal(3C),  signal.h(3HEAD),
       process(4), privileges(5)




SunOS 5.10                        19 Jul 2004                       sigsend(2)