From a1ffe9f5a21184ac68cfabbdf40f35fc3503b48e Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Thu, 27 Dec 2007 16:06:35 +0000 Subject: [PATCH] s/current process/calling process/ --- man2/_exit.2 | 2 +- man2/chroot.2 | 2 +- man2/getgid.2 | 4 ++-- man2/getpid.2 | 4 ++-- man2/getrusage.2 | 2 +- man2/getsid.2 | 2 +- man2/gettid.2 | 4 ++-- man2/getuid.2 | 4 ++-- man2/iopl.2 | 2 +- man2/kill.2 | 6 +++--- man2/personality.2 | 2 +- man2/ptrace.2 | 4 ++-- man2/sched_setparam.2 | 4 ++-- man2/sched_setscheduler.2 | 2 +- man2/sched_yield.2 | 2 +- man2/seteuid.2 | 8 +++++--- man2/setgid.2 | 2 +- man2/setpgid.2 | 6 +++--- man2/setresuid.2 | 4 ++-- man2/setreuid.2 | 6 +++--- man2/setuid.2 | 4 ++-- man2/unlink.2 | 2 +- man2/wait.2 | 4 ++-- man3/openpty.3 | 4 ++-- man3/raise.3 | 4 ++-- man3/setlogmask.3 | 2 +- man3/sleep.3 | 2 +- man3/ttyslot.3 | 2 +- man3/ulimit.3 | 2 +- man4/tty.4 | 2 +- man4/tty_ioctl.4 | 6 +++--- man7/path_resolution.7 | 8 ++++---- 32 files changed, 58 insertions(+), 56 deletions(-) diff --git a/man2/_exit.2 b/man2/_exit.2 index d2e0fb7b7..77e410a6d 100644 --- a/man2/_exit.2 +++ b/man2/_exit.2 @@ -28,7 +28,7 @@ .\" .TH _EXIT 2 2007-07-26 "Linux" "Linux Programmer's Manual" .SH NAME -_exit, _Exit \- terminate the current process +_exit, _Exit \- terminate the calling process .SH SYNOPSIS .B #include .sp diff --git a/man2/chroot.2 b/man2/chroot.2 index 307a238d1..555d46de9 100644 --- a/man2/chroot.2 +++ b/man2/chroot.2 @@ -42,7 +42,7 @@ chroot \- change root directory changes the root directory to that specified in .IR path . This directory will be used for pathnames beginning with \fI/\fP. -The root directory is inherited by all children of the current process. +The root directory is inherited by all children of the calling process. Only a privileged process (Linux: one with the .B CAP_SYS_CHROOT diff --git a/man2/getgid.2 b/man2/getgid.2 index 0ea1fc97d..9922b54ce 100644 --- a/man2/getgid.2 +++ b/man2/getgid.2 @@ -35,10 +35,10 @@ getgid, getegid \- get group identity .B gid_t getegid(void); .SH DESCRIPTION .BR getgid () -returns the real group ID of the current process. +returns the real group ID of the calling process. .BR getegid () -returns the effective group ID of the current process. +returns the effective group ID of the calling process. .SH ERRORS These functions are always successful. .SH "CONFORMING TO" diff --git a/man2/getpid.2 b/man2/getpid.2 index 82dfd33e9..5e258818b 100644 --- a/man2/getpid.2 +++ b/man2/getpid.2 @@ -33,12 +33,12 @@ getpid, getppid \- get process identification .B pid_t getppid(void); .SH DESCRIPTION .BR getpid () -returns the process ID of the current process. +returns the process ID of the calling process. (This is often used by routines that generate unique temporary filenames.) .BR getppid () -returns the process ID of the parent of the current process. +returns the process ID of the parent of the calling process. .SH ERRORS These functions are always successful. .SH "CONFORMING TO" diff --git a/man2/getrusage.2 b/man2/getrusage.2 index f52dbbf22..5985a97c6 100644 --- a/man2/getrusage.2 +++ b/man2/getrusage.2 @@ -48,7 +48,7 @@ of either .B RUSAGE_SELF or .BR RUSAGE_CHILDREN . -The former asks for resources used by the current process, +The former asks for resources used by the calling process, the latter for resources used by those of its children that have terminated and have been waited for. .PP diff --git a/man2/getsid.2 b/man2/getsid.2 index 4e252fd0e..381fbb444 100644 --- a/man2/getsid.2 +++ b/man2/getsid.2 @@ -55,7 +55,7 @@ is set appropriately. .B EPERM A process with process ID .I p -exists, but it is not in the same session as the current process, +exists, but it is not in the same session as the calling process, and the implementation considers this an error. .TP .B ESRCH diff --git a/man2/gettid.2 b/man2/gettid.2 index 855982f92..3c90a4090 100644 --- a/man2/gettid.2 +++ b/man2/gettid.2 @@ -32,7 +32,7 @@ gettid \- get thread identification .fi .SH DESCRIPTION .BR gettid () -returns the thread ID of the current process. +returns the thread ID of the calling process. This is equal to the process ID (as returned by .BR getpid (2)), @@ -45,7 +45,7 @@ system call). All processes in the same thread group have the same PID, but each one has a unique TID. .SH "RETURN VALUE" -On success, returns the thread ID of the current process. +On success, returns the thread ID of the calling process. .SH ERRORS This call is always successful. .SH "CONFORMING TO" diff --git a/man2/getuid.2 b/man2/getuid.2 index 7b5e3815a..47cf30646 100644 --- a/man2/getuid.2 +++ b/man2/getuid.2 @@ -36,10 +36,10 @@ getuid, geteuid \- get user identity .B uid_t geteuid(void); .SH DESCRIPTION .BR getuid () -returns the real user ID of the current process. +returns the real user ID of the calling process. .BR geteuid () -returns the effective user ID of the current process. +returns the effective user ID of the calling process. .SH ERRORS These functions are always successful. .SH "CONFORMING TO" diff --git a/man2/iopl.2 b/man2/iopl.2 index 571d73a54..a734686a7 100644 --- a/man2/iopl.2 +++ b/man2/iopl.2 @@ -39,7 +39,7 @@ iopl \- change I/O privilege level .BI "int iopl(int " level ); .SH DESCRIPTION .BR iopl () -changes the I/O privilege level of the current process, as specified in +changes the I/O privilege level of the calling process, as specified in .IR level . This call is necessary to allow 8514-compatible X servers to run under diff --git a/man2/kill.2 b/man2/kill.2 index 35556981b..ad9b64524 100644 --- a/man2/kill.2 +++ b/man2/kill.2 @@ -69,7 +69,7 @@ can be used to send any signal to any process group or process. If \fIpid\fP is positive, then signal \fIsig\fP is sent to \fIpid\fP. .PP If \fIpid\fP equals 0, then \fIsig\fP is sent to every process in the -process group of the current process. +process group of the calling process. .PP If \fIpid\fP equals \-1, then \fIsig\fP is sent to every process for which the calling process has permission to send signals, @@ -124,10 +124,10 @@ This is done to assure the system is not brought down accidentally. .LP POSIX.1-2001 requires that \fIkill(\-1,sig)\fP send \fIsig\fP -to all processes that the current process may send signals to, +to all processes that the calling process may send signals to, except possibly for some implementation-defined system processes. Linux allows a process to signal itself, but on Linux the call -\fIkill(\-1,sig)\fP does not signal the current process. +\fIkill(\-1,sig)\fP does not signal the calling process. .LP POSIX.1-2001 requires that if a process sends a signal to itself, and the sending thread does not have the signal blocked, diff --git a/man2/personality.2 b/man2/personality.2 index 457eee321..1c205e61e 100644 --- a/man2/personality.2 +++ b/man2/personality.2 @@ -51,7 +51,7 @@ equals 0xffffffff. Otherwise, it will make the execution domain referenced by .I persona -the new execution domain of the current process. +the new execution domain of the calling process. .SH "RETURN VALUE" On success, the previous .I persona diff --git a/man2/ptrace.2 b/man2/ptrace.2 index fa9c9bc15..80c0acacb 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -352,10 +352,10 @@ to terminate it. .B PTRACE_ATTACH Attaches to the process specified in .IR pid , -making it a traced "child" of the current process; +making it a traced "child" of the calling process; the behavior of the child is as if it had done a .BR PTRACE_TRACEME . -The current process actually becomes the parent of the child +The calling process actually becomes the parent of the child process for most purposes (e.g., it will receive notification of child events and appears in .BR ps (1) diff --git a/man2/sched_setparam.2 b/man2/sched_setparam.2 index 7de179c8f..302ba7d14 100644 --- a/man2/sched_setparam.2 +++ b/man2/sched_setparam.2 @@ -50,7 +50,7 @@ sched_setparam, sched_getparam \- set and get scheduling parameters sets the scheduling parameters associated with the scheduling policy for the process identified by \fIpid\fP. If \fIpid\fP is zero, then -the parameters of the current process are set. +the parameters of the calling process are set. The interpretation of the parameter \fIparam\fP depends on the scheduling policy of the process identified by @@ -63,7 +63,7 @@ for a description of the scheduling policies supported under Linux. retrieves the scheduling parameters for the process identified by \fIpid\fP. If \fIpid\fP is zero, then the parameters -of the current process are retrieved. +of the calling process are retrieved. .BR sched_setparam () checks the validity of \fIparam\fP for the scheduling policy of the diff --git a/man2/sched_setscheduler.2 b/man2/sched_setscheduler.2 index 777ef0505..37bb22095 100644 --- a/man2/sched_setscheduler.2 +++ b/man2/sched_setscheduler.2 @@ -123,7 +123,7 @@ priority range for a scheduling policy in a portable way on all POSIX.1-2001 conforming systems. All scheduling is preemptive: If a process with a higher static -priority gets ready to run, the current process will be preempted and +priority gets ready to run, the calling process will be preempted and returned into its wait list. The scheduling policy only determines the ordering within the list of runnable processes with equal static diff --git a/man2/sched_yield.2 b/man2/sched_yield.2 index c44e1de20..57f8bbc32 100644 --- a/man2/sched_yield.2 +++ b/man2/sched_yield.2 @@ -40,7 +40,7 @@ A process can relinquish the processor voluntarily without blocking by calling The process will then be moved to the end of the queue for its static priority and a new process gets to run. -Note: If the current process is the only process in the highest +Note: If the calling process is the only process in the highest priority list at that time, this process will continue to run after a call to .BR sched_yield (). diff --git a/man2/seteuid.2 b/man2/seteuid.2 index 99abb784d..1b7a2f1a3 100644 --- a/man2/seteuid.2 +++ b/man2/seteuid.2 @@ -48,7 +48,7 @@ _BSD_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || _XOPEN_SOURCE\ >=\ 600 .ad b .SH DESCRIPTION .BR seteuid () -sets the effective user ID of the current process. +sets the effective user ID of the calling process. Unprivileged user processes may only set the effective user ID to the real user ID, the effective user ID or the saved set-user-ID. @@ -58,6 +58,8 @@ with "group" instead of "user". .\" When .\" .I euid .\" equals \-1, nothing is changed. +.\" (This is an artifact of the implementation in glibc of seteuid() +.\" using setresuid(2).) .SH "RETURN VALUE" On success, zero is returned. On error, \-1 is returned, and @@ -68,7 +70,7 @@ is set appropriately. .\" .B EINVAL .TP .B EPERM -The current process is not privileged (Linux: does not have the +The calling process is not privileged (Linux: does not have the .B CAP_SETUID capability in the case of .BR seteuid (), @@ -96,7 +98,7 @@ Under libc4, libc5 and glibc 2.0 is equivalent to .BI setreuid(\-1, " euid" ) and hence may change the saved set-user-ID. -Under glibc2.1 it is equivalent to +Under glibc 2.1 iand later it is equivalent to .BI setresuid(\-1, " euid" ", \-1)" and hence does not change the saved set-user-ID. Similar remarks hold for diff --git a/man2/setgid.2 b/man2/setgid.2 index dcc936a22..8c566e011 100644 --- a/man2/setgid.2 +++ b/man2/setgid.2 @@ -35,7 +35,7 @@ setgid \- set group identity .BI "int setgid(gid_t " gid ); .SH DESCRIPTION .BR setgid () -sets the effective group ID of the current process. +sets the effective group ID of the calling process. If the caller is the superuser, the real GID and saved set-group-ID are also set. diff --git a/man2/setpgid.2 b/man2/setpgid.2 index 23824587d..7a61da27e 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -97,7 +97,7 @@ to .IR pgid . If .I pid -is zero, the process ID of the current process is used. +is zero, the process ID of the calling process is used. If .I pgid is zero, the process ID of the process specified by @@ -125,7 +125,7 @@ returns the PGID of the process specified by .IR pid . If .I pid -is zero, the process ID of the current process is used. +is zero, the process ID of the calling process is used. (Retrieving the PGID of a process other than the caller is rarely necessary, and the POSIX.1 .BR getpgrp () @@ -208,7 +208,7 @@ does not match any process. For .BR setpgid (): .I pid -is not the current process and not a child of the current process. +is not the calling process and not a child of the calling process. .SH "CONFORMING TO" .BR setpgid () and the version of diff --git a/man2/setresuid.2 b/man2/setresuid.2 index 1ee09344d..b89e3c303 100644 --- a/man2/setresuid.2 +++ b/man2/setresuid.2 @@ -37,7 +37,7 @@ setresuid, setresgid \- set real, effective and saved user or group ID .SH DESCRIPTION .BR setresuid () sets the real user ID, the effective user ID, and the -saved set-user-ID of the current process. +saved set-user-ID of the calling process. Unprivileged user processes may change the real UID, @@ -58,7 +58,7 @@ value as the (possibly new) effective UID. Completely analogously, .BR setresgid () sets the real GID, effective GID, and saved set-group-ID -of the current process (and always modifies the file system GID +of the calling process (and always modifies the file system GID to be the same as the effective GID), with the same restrictions for non-privileged processes. .SH "RETURN VALUE" diff --git a/man2/setreuid.2 b/man2/setreuid.2 index 44efabd90..cae287ffe 100644 --- a/man2/setreuid.2 +++ b/man2/setreuid.2 @@ -62,7 +62,7 @@ Feature Test Macro Requirements for glibc (see _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 .SH DESCRIPTION .BR setreuid () -sets real and effective user IDs of the current process. +sets real and effective user IDs of the calling process. Supplying a value of \-1 for either the real or effective user ID forces the system to leave that ID unchanged. @@ -83,7 +83,7 @@ the saved set-user-ID will be set to the new effective user ID. Completely analogously, .BR setregid () -sets real and effective group ID's of the current process, +sets real and effective group ID's of the calling process, and all of the above holds with "group" instead of "user". .SH "RETURN VALUE" On success, zero is returned. @@ -93,7 +93,7 @@ is set appropriately. .SH ERRORS .TP .B EPERM -The current process is not privileged +The calling process is not privileged (Linux: does not have the .B CAP_SETUID capability in the case of diff --git a/man2/setuid.2 b/man2/setuid.2 index d34d7c0ab..8206e6c21 100644 --- a/man2/setuid.2 +++ b/man2/setuid.2 @@ -36,7 +36,7 @@ setuid \- set user identity .BI "int setuid(uid_t " uid ); .SH DESCRIPTION .BR setuid () -sets the effective user ID of the current process. +sets the effective user ID of the calling process. If the effective UID of the caller is root, the real UID and saved set-user-ID are also set. .PP @@ -98,7 +98,7 @@ Linux has the concept of filesystem user ID, normally equal to the effective user ID. The .BR setuid () -call also sets the filesystem user ID of the current process. +call also sets the filesystem user ID of the calling process. See .BR setfsuid (2). .PP diff --git a/man2/unlink.2 b/man2/unlink.2 index 4f5d74909..48a003ffa 100644 --- a/man2/unlink.2 +++ b/man2/unlink.2 @@ -112,7 +112,7 @@ is not, in fact, a directory. .B EPERM The system does not allow unlinking of directories, or unlinking of directories requires privileges that the -current process doesn't have. +calling process doesn't have. (This is the POSIX prescribed error return; as noted above, Linux returns .B EISDIR diff --git a/man2/wait.2 b/man2/wait.2 index aa4d44674..4e6c89399 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -93,7 +93,7 @@ calls is termed .SS "wait() and waitpid()" The .BR wait () -system call suspends execution of the current process until one of its +system call suspends execution of the calling process until one of its children terminates. The call .I wait(&status) @@ -105,7 +105,7 @@ is equivalent to: The .BR waitpid () -system call suspends execution of the current process until a +system call suspends execution of the calling process until a child specified by .I pid argument has changed state. diff --git a/man3/openpty.3 b/man3/openpty.3 index 16f826253..b97ad86a9 100644 --- a/man3/openpty.3 +++ b/man3/openpty.3 @@ -79,7 +79,7 @@ returned by .BR openpty ()) by creating a new session, making .I fd -the controlling terminal for the current process, setting +the controlling terminal for the calling process, setting .I fd to be the standard input, output, and error streams of the current process, and closing @@ -135,7 +135,7 @@ will fail if .BR ioctl (2) fails to set .I fd -to the controlling terminal of the current process. +to the controlling terminal of the calling process. .LP .BR forkpty () will fail if either diff --git a/man3/raise.3 b/man3/raise.3 index 38d18dca3..1db2af0f1 100644 --- a/man3/raise.3 +++ b/man3/raise.3 @@ -25,7 +25,7 @@ .\" .TH RAISE 3 1995-08-31 "GNU" "Linux Programmer's Manual" .SH NAME -raise \- send a signal to the current process +raise \- send a signal to the calling process .SH SYNOPSIS .nf .B #include @@ -35,7 +35,7 @@ raise \- send a signal to the current process .SH DESCRIPTION The .BR raise () -function sends a signal to the current process. +function sends a signal to the calling process. It is equivalent to .sp .RS diff --git a/man3/setlogmask.3 b/man3/setlogmask.3 index eb6b9b15c..77d8d16ce 100644 --- a/man3/setlogmask.3 +++ b/man3/setlogmask.3 @@ -41,7 +41,7 @@ The initial mask is such that logging is enabled for all priorities. .LP The .BR setlogmask () -function sets this logmask for the current process, +function sets this logmask for the calling process, and returns the previous mask. If the mask argument is 0, the current logmask is not modified. .LP diff --git a/man3/sleep.3 b/man3/sleep.3 index 5bfb224db..e3e246635 100644 --- a/man3/sleep.3 +++ b/man3/sleep.3 @@ -32,7 +32,7 @@ sleep \- Sleep for the specified number of seconds .fi .SH DESCRIPTION .BR sleep () -makes the current process sleep until +makes the calling process sleep until .I seconds seconds have elapsed or a signal arrives which is not ignored. .SH "RETURN VALUE" diff --git a/man3/ttyslot.3 b/man3/ttyslot.3 index 53b2444e1..e28f6e953 100644 --- a/man3/ttyslot.3 +++ b/man3/ttyslot.3 @@ -96,7 +96,7 @@ call to find the number of the line in .SS "The semantics of ttyslot" Thus, the function .BR ttyslot () -returns the index of the controlling terminal of the current process +returns the index of the controlling terminal of the calling process in the file .IR /etc/ttys , and that is (usually) the same as the index of the entry for the diff --git a/man3/ulimit.3 b/man3/ulimit.3 index d54d93ee0..97691b3b7 100644 --- a/man3/ulimit.3 +++ b/man3/ulimit.3 @@ -46,7 +46,7 @@ see The .BR ulimit () -call will get or set some limit for the current process. +call will get or set some limit for the calling process. The .I cmd argument can have one of the following values. diff --git a/man4/tty.4 b/man4/tty.4 index 130e1c591..d532a078e 100644 --- a/man4/tty.4 +++ b/man4/tty.4 @@ -38,7 +38,7 @@ requests supported by the device that .BR ioctl (2) request \fBTIOCNOTTY\fP is supported. .SS TIOCNOTTY -Detach the current process from its controlling terminal. +Detach the calling process from its controlling terminal. .sp If the process is the session leader, then diff --git a/man4/tty_ioctl.4 b/man4/tty_ioctl.4 index eeaebd628..c8d6ec544 100644 --- a/man4/tty_ioctl.4 +++ b/man4/tty_ioctl.4 @@ -220,8 +220,8 @@ or .SS "Controlling tty" .TP .BI "TIOCSCTTY int " arg -Make the given tty the controlling tty of the current process. -The current process must be a session leader and not have a +Make the given tty the controlling tty of the calling process. +The calling process must be a session leader and not have a controlling tty already. If this tty is already the controlling tty of a different session group then the ioctl fails with @@ -232,7 +232,7 @@ equals 1, in which case the tty is stolen, and all processes that had it as controlling tty lose it. .TP .B TIOCNOTTY void -If the given tty was the controlling tty of the current process, +If the given tty was the controlling tty of the calling process, give up this controlling tty. If the process was session leader, then send diff --git a/man7/path_resolution.7 b/man7/path_resolution.7 index 803f43246..99f2cb2e2 100644 --- a/man7/path_resolution.7 +++ b/man7/path_resolution.7 @@ -28,7 +28,7 @@ Some Unix/Linux system calls have as parameter one or more filenames. A filename (or pathname) is resolved as follows. .SS "Step 1: Start of the resolution process" If the pathname starts with the '/' character, the starting lookup directory -is the root directory of the current process. +is the root directory of the calling process. (A process inherits its root directory from its parent. Usually this will be the root directory @@ -169,11 +169,11 @@ The permission bits of a file consist of three groups of three bits, cf.\& and .BR stat (2). The first group of three is used when the effective user ID of -the current process equals the owner ID of the file. +the calling process equals the owner ID of the file. The second group of three is used when the group ID of the file either equals the -effective group ID of the current process, or is one of the -supplementary group IDs of the current process (as set by +effective group ID of the calling process, or is one of the +supplementary group IDs of the calling process (as set by .BR setgroups (2)). When neither holds, the third group is used.