Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
KILLPG(2)		    BSD	System Calls Manual		     KILLPG(2)

NAME
     killpg -- send signal to a	process	group

SYNOPSIS
     #include <sys/types.h>
     #include <signal.h>

     int
     killpg(pid_t pgrp,	int sig);

DESCRIPTION
     Killpg() sends the	signal sig to the process group	pgrp.  See
     sigaction(2) for a	list of	signals.  If pgrp is 0,	killpg() sends the
     signal to the sending process's process group.

     The sending process and members of	the process group must have the	same
     effective user ID,	or the sender must be the super-user.  As a single
     special case the continue signal SIGCONT may be sent to any process that
     is	a descendant of	the current process.

RETURN VALUES
     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of	-1 is returned and the global variable errno is	set to indicate	the
     error.

ERRORS
     Killpg() will fail	and no signal will be sent if:

     [EINVAL]		Sig is not a valid signal number.

     [ESRCH]		No process can be found	in the process group specified
			by pgrp.

     [ESRCH]		The process group was given as 0 but the sending
			process	does not have a	process	group.

     [EPERM]		The sending process is not the super-user and one or
			more of	the target processes has an effective user ID
			different from that of the sending process.

SEE ALSO
     getpgrp(2), kill(2), sigaction(2)

HISTORY
     The killpg() function call	appeared in 4.0BSD.

4th Berkeley Distribution	 June 2, 1993	     4th Berkeley Distribution

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=killpg&sektion=2&manpath=FreeBSD+2.2.6-RELEASE>

home | help