Open System Services System Calls Reference Manual (G06.25+, H06.03+)

kill(2) OSS System Calls Reference Manual
RETURN VALUES
Upon successful completion, the kill() function returns the value 0 (zero). Otherwise, the value
-1 is returned, errno is set to indicate the error, and no signal is sent.
ERRORS
If any of the following conditions occurs, the kill() function sets errno to the corresponding
value:
[EINVAL] The value in the signal parameter is an invalid or unsupported signal number.
[ENOTOSS] The calling process was not an OSS process. The
kill() function cannot be used
from the Guardian environment.
[EPERM] The process does not have permission to send the signal to any receiving pro-
cess.
[ESRCH] No process or process group can be found corresponding to that speci
fied by the
pid parameter.
RELATED INFORMATION
Functions: getpid(2), setpgid(2), setsid(2), sigaction(2), signal(3).
STANDARDS CONFORMANCE
The POSIX standards leave some features to the implementing vendor to define. The following
features are affected in the HP implementation:
• The mechanism that grants a process the appropriate privileges to send signals is
described under DESCRIPTION.
• The POSIX.1 standard leaves unspecified the set of system processes that does not
receive a signal when the kill() function is called with pid equal to 0 (zero), -1, or a
negative number less than -1. Applications in the HP implementation should therefore
not depend on which system processes receive signals.
• Additional restrictions are imposed by the Safeguard security mechanism on the sending
of signals. See Safeguard Considerations.
The following are HP extensions to the XPG4 Version 2 specification:
• Safeguard considerations
• The ability to send signals to named processes
• The error [ENOTOSS]
4−4 Hewlett-Packard Company 527186-003