|
|
1.1 root 1: .TH SETPGRP 2 "12 February 1983"
2: .UC 4
3: .SH NAME
4: setpgrp \- set process group
5: .SH SYNOPSIS
6: .ft B
7: setpgrp(pid, pgrp)
8: .br
9: int pid, pgrp;
10: .ft R
11: .SH DESCRIPTION
12: .I Setpgrp
13: sets the process group of the specified process
14: .I pid
15: to the specified
16: .IR pgrp .
17: If
18: .I pid
19: is zero, then the call applies to the current process.
20: .PP
21: If the invoker is not the super-user, then the affected process
22: must have the same effective user-id as the invoker or be a descendant
23: of the invoking process.
24: .SH "RETURN VALUE
25: .I Setpgrp
26: returns when the operation was successful. If
27: the request failed, \-1 is returned and the global
28: variable
29: .I errno
30: indicates the reason.
31: .SH ERRORS
32: .I Setpgrp
33: will fail and the process group will not be altered if
34: one of the following occur:
35: .TP 15
36: [ESRCH]
37: The requested process does not exist.
38: .TP 15
39: [EPERM]
40: The effective user ID of the requested process is different
41: from that of the caller and the process is not a descendent
42: of the calling process.
43: .SH "SEE ALSO"
44: getpgrp(2)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.