Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

kill(2)

getpgrp(2)

sigvec(2)

KILLPG(2)

NAME

killpg − send signal to a process group

USAGE

killpg(pgrp, sig)
int pgrp, sig;

DESCRIPTION

Killpg sends the signal sig to the process group pgrp.  See sigvec(2) for a list of signals. 

The sending process and all processes in the process group must have the same effective user ID.  The only exception is the signal SIGCONT, which killpg may always send to any child or grandchild of the current process.  In all other cases, this call is restricted to the super-user. 

RETURN VALUE

Upon successful completion, a value of zero 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 in any of the following cases:

[EINVAL] Sig is not a valid signal number. 

[ESRCH] No process was found with the specified pid. 

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

RELATED INFORMATION

kill(2), getpgrp(2), sigvec(2)

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026