sigsend(2) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

sigsend(2)

sigsend(2)                       System Calls                       sigsend(2)

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

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
       processes  specified  by id and idtype. The signal to be sent is speci‐
       fied by sig and is either 0  or  one  of  the  values  listed  in  sig‐
       nal.h(3HEAD).  If  sig  is  0 (the null signal), error checking is per‐
       formed but no signal 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  <sys/procset.h>,  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 returned. 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 as‐
                 serted 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_SESSION}
                 privilege asserted and is  trying  to  send  a  signal  to  a
                 process  with  a different session ID, even though the effec‐
                 tive 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), sigqueue(3C),
       signal.h(3HEAD), process(5), privileges(7)

HISTORY
       The sigsend() and sigsendset() functions were added to Solaris  in  So‐
       laris 2.0.


       Support  for  the  following  idtype parameters is available in Solaris
       starting with the listed release:

       tab() box; cw(4.71i) |cw(0.79i) lw(4.71i)  |lw(0.79i)  IDTYPERELEASE  _
       P_CTID10  3/05  _ P_PROJID, P_TASKID9 _ T{ P_PID, P_PGID, P_SID, P_UID,
       P_GID, P_CID, P_ALL T}2.0


Oracle Solaris 11.4               30 Jan 2023                       sigsend(2)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3