diff options
Diffstat (limited to 'man2/setpgid.2')
-rw-r--r-- | man2/setpgid.2 | 42 |
1 files changed, 21 insertions, 21 deletions
diff --git a/man2/setpgid.2 b/man2/setpgid.2 index d5f9bbd6b..7b0e39f72 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -39,7 +39,7 @@ Standard C library .P .RS -4 Feature Test Macro Requirements for glibc (see -.BR feature_test_macros (7)): +.MR feature_test_macros 7 ): .RE .P .BR getpgid (): @@ -70,7 +70,7 @@ All of these interfaces are available on Linux, and are used for getting and setting the process group ID (PGID) of a process. The preferred, POSIX.1-specified ways of doing this are: -.BR getpgrp (void), +.MR getpgrp void , for retrieving the calling process's PGID; and .BR setpgid (), for setting a process's PGID. @@ -93,9 +93,9 @@ If is used to move a process from one process group to another (as is done by some shells when creating pipelines), both process groups must be part of the same session (see -.BR setsid (2) +.MR setsid 2 and -.BR credentials (7)). +.MR credentials 7 ). In this case, the \fIpgid\fP specifies an existing process group to be joined and the session ID of that group must match the session ID of the joining process. @@ -195,7 +195,7 @@ is set to indicate the error. An attempt was made to change the process group ID of one of the children of the calling process and the child had already performed an -.BR execve (2) +.MR execve 2 .RB ( setpgid (), .BR setpgrp ()). .TP @@ -262,15 +262,15 @@ POSIX.1-2008 marks it as obsolete. 4.2BSD. .SH NOTES A child created via -.BR fork (2) +.MR fork 2 inherits its parent's process group ID. The PGID is preserved across an -.BR execve (2). +.MR execve 2 . .P Each process group is a member of a session and each process is a member of the session of which its process group is a member. (See -.BR credentials (7).) +.MR credentials 7 .) .P A session can have a controlling terminal. At any time, one (and only one) of the process groups @@ -282,20 +282,20 @@ interrupt key to generate .BR SIGINT ), that signal is sent to the foreground process group. (See -.BR termios (3) +.MR termios 3 for a description of the characters that generate signals.) Only the foreground process group may -.BR read (2) +.MR read 2 from the terminal; if a background process group tries to -.BR read (2) +.MR read 2 from the terminal, then the group is sent a .B SIGTTIN signal, which suspends it. The -.BR tcgetpgrp (3) +.MR tcgetpgrp 3 and -.BR tcsetpgrp (3) +.MR tcsetpgrp 3 functions are used to get/set the foreground process group of the controlling terminal. .P @@ -304,7 +304,7 @@ The and .BR getpgrp () calls are used by programs such as -.BR bash (1) +.MR bash 1 to create process groups in order to implement shell job control. .P If the termination of a process causes a process group to become orphaned, @@ -319,11 +319,11 @@ An orphaned process group is one in which the parent of every member of process group is either itself also a member of the process group or is a member of a process group in a different session (see also -.BR credentials (7)). +.MR credentials 7 ). .SH SEE ALSO -.BR getuid (2), -.BR setsid (2), -.BR tcgetpgrp (3), -.BR tcsetpgrp (3), -.BR termios (3), -.BR credentials (7) +.MR getuid 2 , +.MR setsid 2 , +.MR tcgetpgrp 3 , +.MR tcsetpgrp 3 , +.MR termios 3 , +.MR credentials 7 |