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 signal to the sending process's process group.

       The  sending process must be able to kill() at least one	process	in the
       receiving 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	speci-
			  fied 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	14.3			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+14.3-RELEASE+and+Ports>

home | help