AuroraMiddleware/glibc
1
0
Fork 0
mirror of https://sourceware.org/git/glibc.git synced 2025-01-03 16:21:06 +00:00
Code Issues Packages Projects Releases Wiki Activity

* manual/job.texi: Document MTASC-safety properties.

Browse Source
This commit is contained in:
Alexandre Oliva 2014-01-31 23:20:02 -02:00
parent a7b90ea9d1
commit 27bdc63ce3
2 changed files with 29 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
ChangeLog
View File

@ -1,3 +1,7 @@
2014-01-31 Alexandre Oliva <aoliva@redhat.com>
* manual/job.texi: Document MTASC-safety properties.
2014-01-31 Alexandre Oliva <aoliva@redhat.com> 2014-01-31 Alexandre Oliva <aoliva@redhat.com>
* manual/getopt.texi: Document MTASC-safety properties. * manual/getopt.texi: Document MTASC-safety properties.

25
manual/job.texi
View File

@ -1039,6 +1039,10 @@ The function @code{ctermid} is declared in the header file
@comment stdio.h @comment stdio.h
@comment POSIX.1 @comment POSIX.1
@deftypefun {char *} ctermid (char *@var{string}) @deftypefun {char *} ctermid (char *@var{string})
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c This function is a stub by default; the actual implementation, for
@c posix systems, returns an internal buffer if passed a NULL string,
@c but the internal buffer is always set to /dev/tty.
The @code{ctermid} function returns a string containing the file name of The @code{ctermid} function returns a string containing the file name of
the controlling terminal for the current process. If @var{string} is the controlling terminal for the current process. If @var{string} is
not a null pointer, it should be an array that can hold at least not a null pointer, it should be an array that can hold at least
@ -1075,6 +1079,12 @@ Your program should include the header files @file{sys/types.h} and
@comment unistd.h @comment unistd.h
@comment POSIX.1 @comment POSIX.1
@deftypefun pid_t setsid (void) @deftypefun pid_t setsid (void)
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c This is usually a direct syscall, but if a syscall is not available,
@c we use a stub, or Hurd- and BSD-specific implementations. The former
@c uses a mutex and a hurd critical section, and the latter issues a few
@c syscalls, so both seem safe, the locking on Hurd is safe because of
@c the critical section.
The @code{setsid} function creates a new session. The calling process The @code{setsid} function creates a new session. The calling process
becomes the session leader, and is put in a new process group whose becomes the session leader, and is put in a new process group whose
process group ID is the same as the process ID of that process. There process group ID is the same as the process ID of that process. There
@ -1098,6 +1108,8 @@ already another process group around that has the same process group ID.
@comment unistd.h @comment unistd.h
@comment SVID @comment SVID
@deftypefun pid_t getsid (pid_t @var{pid}) @deftypefun pid_t getsid (pid_t @var{pid})
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Stub or direct syscall, except on hurd, where it is equally safe.
The @code{getsid} function returns the process group ID of the session The @code{getsid} function returns the process group ID of the session
leader of the specified process. If a @var{pid} is @code{0}, the leader of the specified process. If a @var{pid} is @code{0}, the
@ -1121,6 +1133,7 @@ from the calling process.
@comment unistd.h @comment unistd.h
@comment POSIX.1 @comment POSIX.1
@deftypefun pid_t getpgrp (void) @deftypefun pid_t getpgrp (void)
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
The @code{getpgrp} function returns the process group ID of The @code{getpgrp} function returns the process group ID of
the calling process. the calling process.
@end deftypefun @end deftypefun
@ -1128,6 +1141,8 @@ the calling process.
@comment unistd.h @comment unistd.h
@comment POSIX.1 @comment POSIX.1
@deftypefun int getpgid (pid_t @var{pid}) @deftypefun int getpgid (pid_t @var{pid})
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Stub or direct syscall, except on hurd, where it is equally safe.
The @code{getpgid} function The @code{getpgid} function
returns the process group ID of the process @var{pid}. You can supply a returns the process group ID of the process @var{pid}. You can supply a
@ -1150,6 +1165,8 @@ process.
@comment unistd.h @comment unistd.h
@comment POSIX.1 @comment POSIX.1
@deftypefun int setpgid (pid_t @var{pid}, pid_t @var{pgid}) @deftypefun int setpgid (pid_t @var{pid}, pid_t @var{pgid})
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Stub or direct syscall, except on hurd, where it is equally safe.
The @code{setpgid} function puts the process @var{pid} into the process The @code{setpgid} function puts the process @var{pid} into the process
group @var{pgid}. As a special case, either @var{pid} or @var{pgid} can group @var{pgid}. As a special case, either @var{pid} or @var{pgid} can
be zero to indicate the process ID of the calling process. be zero to indicate the process ID of the calling process.
@ -1187,6 +1204,8 @@ process or a child of the calling process.
@comment unistd.h @comment unistd.h
@comment BSD @comment BSD
@deftypefun int setpgrp (pid_t @var{pid}, pid_t @var{pgid}) @deftypefun int setpgrp (pid_t @var{pid}, pid_t @var{pgid})
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Direct syscall or setpgid wrapper.
This is the BSD Unix name for @code{setpgid}. Both functions do exactly This is the BSD Unix name for @code{setpgid}. Both functions do exactly
the same thing. the same thing.
@end deftypefun @end deftypefun
@ -1209,6 +1228,8 @@ file itself and not a particular open file descriptor.
@comment unistd.h @comment unistd.h
@comment POSIX.1 @comment POSIX.1
@deftypefun pid_t tcgetpgrp (int @var{filedes}) @deftypefun pid_t tcgetpgrp (int @var{filedes})
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Stub, or ioctl on BSD and GNU/Linux.
This function returns the process group ID of the foreground process This function returns the process group ID of the foreground process
group associated with the terminal open on descriptor @var{filedes}. group associated with the terminal open on descriptor @var{filedes}.
@ -1237,6 +1258,8 @@ controlling terminal of the calling process.
@comment unistd.h @comment unistd.h
@comment POSIX.1 @comment POSIX.1
@deftypefun int tcsetpgrp (int @var{filedes}, pid_t @var{pgid}) @deftypefun int tcsetpgrp (int @var{filedes}, pid_t @var{pgid})
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Stub, or ioctl on BSD and GNU/Linux.
This function is used to set a terminal's foreground process group ID. This function is used to set a terminal's foreground process group ID.
The argument @var{filedes} is a descriptor which specifies the terminal; The argument @var{filedes} is a descriptor which specifies the terminal;
@var{pgid} specifies the process group. The calling process must be a @var{pgid} specifies the process group. The calling process must be a
@ -1276,6 +1299,8 @@ process.
@comment termios.h @comment termios.h
@comment Unix98 @comment Unix98
@deftypefun pid_t tcgetsid (int @var{fildes}) @deftypefun pid_t tcgetsid (int @var{fildes})
@safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}}
@c Ioctl call, if available, or tcgetpgrp followed by getsid.
This function is used to obtain the process group ID of the session This function is used to obtain the process group ID of the session
for which the terminal specified by @var{fildes} is the controlling terminal. for which the terminal specified by @var{fildes} is the controlling terminal.
If the call is successful the group ID is returned. Otherwise the If the call is successful the group ID is returned. Otherwise the