Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ killpg(2) — Ultrix WS 2.0 VAX

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

getpgrp(2)

kill(2)

sigvec(2)

killpg(2)

NAME

killpg − send signal to process or process group

SYNTAX

killpg(pgrp, sig)
int pgrp, sig;

DESCRIPTION

The killpg system call sends the signal sig to the process group pgrp. See sigvec() for a list of signals.

The sending process and members of the process group must have the same effective user ID, otherwise this call is restricted to the superuser with the exception of the signal SIGCONT.  The signal SIGCONT can be sent to any process which si a descendant of the current process. 

RETURN VALUE

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.

DIAGNOSTICS

The killpg system call fails and a signal is not sent if any of the following occur:

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

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

[ESRCH] No process can be found corresponding to that specified by pid.

SEE ALSO

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

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