summaryrefslogtreecommitdiffstats
path: root/man2/setpgid.2
diff options
context:
space:
mode:
Diffstat (limited to 'man2/setpgid.2')
-rw-r--r--man2/setpgid.242
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