mirror of https://github.com/mkerrisk/man-pages
s/current process/calling process/
This commit is contained in:
parent
edd1fa35e3
commit
a1ffe9f5a2
|
@ -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 <unistd.h>
|
||||
.sp
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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,
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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)
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 ().
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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 <signal.h>
|
||||
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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"
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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
|
||||
|
|
|
@ -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.
|
||||
|
||||
|
|
Loading…
Reference in New Issue