NAME

setnok − set next-of-kin for a specified process

SYNOPSIS

int setnok(nok, pid)
int nok;
int pid;

DESCRIPTION

Setnok sets nok to be the next-of-kin for process pid by recording nok in the process table entry for process pid.  A call to setnok overwrites any previous information in the process table entry. 

The next-of-kin for a process, P, is another process, Q, that the system notifies when P dies (i.e., exits).  Notification consists of a message sent to Q containing only the process id, P. 

Both arguments to setnok must be valid process ids.  Setnok returns SYSERR to report errors in its arguments, and OK otherwise. 

SEE ALSO

kill(2)

BUGS

There is no check to ensure that the next-of-kin remains in existence between the call to setnok and the termination of a process. 

December 01, 1986  —  Xinu Programmer’s Manual