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

FreeBSD Manual Pages

  
 
  

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

NAME
     killpg -- send signal to a process group

LIBRARY
     Standard C Library (libc, -lc)

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

     int
     killpg(pid_t pgrp, int sig);

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

     The  sending process must be able to kill() at least one process in the re-
     ceiving process group.

RETURN VALUES
     The killpg() function returns the value  0  if  successful;  otherwise  the
     value  -1	is returned and the global variable errno is set to indicate the
     error.

ERRORS
     The killpg() function will fail and no signal will be sent if:

     [EINVAL]		The sig argument is not a valid signal number.

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

     [EPERM]		kill()	returns  EPERM	for all processes in the process
			group.

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

HISTORY
     The killpg() function appeared in 4.0BSD.

FreeBSD ports 15.quarterly	 March 15, 2012 		       KILLPG(2)

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

home | help