summaryrefslogtreecommitdiff
path: root/man2
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2005-07-06 06:52:35 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2005-07-06 06:52:35 +0000
commitbed66765fa374e99ac74001414cc7b63be26215f (patch)
tree56d5d2cd0afc01a8071870982c92f016a39e142d /man2
parent4c8a01a695831c6845288d6efddcc4fa0f50c0a6 (diff)
Formatting fixes
Diffstat (limited to 'man2')
-rw-r--r--man2/vfork.268
1 files changed, 35 insertions, 33 deletions
diff --git a/man2/vfork.2 b/man2/vfork.2
index 4c951b63..8a058e89 100644
--- a/man2/vfork.2
+++ b/man2/vfork.2
@@ -35,18 +35,18 @@ vfork \- create a child process and block parent
.SH "STANDARD DESCRIPTION"
(From XPG4 / SUSv2 / POSIX draft.)
The
-.IR vfork ()
+.BR vfork ()
function has the same effect as
-.IR fork (),
+.BR fork (),
except that the behaviour is undefined if the process created by
-.IR vfork ()
+.BR vfork ()
either modifies any data other than a variable of type pid_t used
to store the return value from
-.IR vfork (),
+.BR vfork (),
or returns from the function in which
-.IR vfork ()
+.BR vfork ()
was called, or calls any other function before successfully calling
-.IR _exit ()
+.BR _exit ()
or one of the
.I exec
family of functions.
@@ -58,58 +58,60 @@ Too many processes - try again.
.B ENOMEM
There is insufficient swap space for the new process.
.SH "LINUX DESCRIPTION"
-.BR vfork ,
+.BR vfork (),
just like
.BR fork (2),
creates a child process of the calling process.
For details and return value and errors, see
.BR fork (2).
.PP
-.B vfork()
+.BR vfork ()
is a special case of
.BR clone (2).
It is used to create new processes without copying the page tables of
the parent process. It may be useful in performance sensitive applications
where a child will be created which then immediately issues an
-.IR execve() .
+.BR execve () .
.PP
-.B vfork()
+.BR vfork ()
differs from fork in that the parent is suspended until the child makes
a call to
.BR execve (2)
or
.BR _exit (2).
The child shares all memory with its parent, including the stack, until
-.I execve()
+.BR execve ()
is issued by the child. The child must not return from the
current function or call
-.IR exit() ,
+.BR exit (),
but may call
-.IR _exit() .
+.BR _exit ().
.PP
Signal handlers are inherited, but not shared. Signals to the parent
arrive after the child releases the parent.
.SH "HISTORIC DESCRIPTION"
Under Linux,
-.IR fork ()
+.BR fork ()
is implemented using copy-on-write pages, so the only penalty incurred by
-.IR fork ()
+.BR fork ()
is the time and memory required to duplicate the parent's page tables,
and to create a unique task structure for the child.
However, in the bad old days a
-.IR fork()
+.BR fork ()
would require making a complete copy of the caller's data space,
often needlessly, since usually immediately afterwards an
-.IR exec ()
+.BR exec ()
is done. Thus, for greater efficiency, BSD introduced the
-.B vfork
+.BR vfork ()
system call, that did not fully copy the address space of
the parent process, but borrowed the parent's memory and thread
of control until a call to
-.IR execve ()
+.BR execve ()
or an exit occurred. The parent process was suspended while the
child was using its resources.
-The use of vfork was tricky - for example, not modifying data
+The use of
+.BR vfork ()
+was tricky - for example, not modifying data
in the parent process depended on knowing which variables are
held in a register.
.SH BUGS
@@ -117,14 +119,14 @@ It is rather unfortunate that Linux revived this spectre from the past.
The BSD manpage states:
"This system call will be eliminated when proper system sharing mechanisms
are implemented. Users should not depend on the memory sharing semantics of
-.I vfork
+.BR vfork ()
as it will, in that case, be made synonymous to
-.IR fork .\c
+.BR fork ().\c
"
Formally speaking, the standard description given above does not allow
one to use
-.IR vfork ()
+.BR vfork ()
since a following
.IR exec
might fail, and then what happens is undefined.
@@ -133,7 +135,7 @@ Details of the signal handling are obscure and differ between systems.
The BSD manpage states:
"To avoid a possible deadlock situation, processes that are children
in the middle of a
-.I vfork
+.BR vfork ()
are never sent SIGTTOU or SIGTTIN signals; rather, output or
.IR ioctl s
are allowed and input attempts result in an end-of-file indication."
@@ -141,37 +143,37 @@ are allowed and input attempts result in an end-of-file indication."
Currently (Linux 2.3.25),
.BR strace (1)
cannot follow
-.IR vfork()
+.BR vfork ()
and requires a kernel patch.
.SH HISTORY
The
-.IR vfork ()
+.BR vfork ()
system call appeared in 3.0BSD.
.\" In the release notes for BSD 4.2 Sam Leffler wrote: `vfork: Is still
.\" present, but definitely on its way out'.
In BSD 4.4 it was made synonymous to
-.IR fork (),
+.BR fork ()
but NetBSD introduced it again,
cf. http://www.netbsd.org/Documentation/kernel/vfork.html .
In Linux, it has been equivalent to
-.IR fork ()
+.BR fork ()
until 2.2.0-pre6 or so. Since 2.2.0-pre9 (on i386, somewhat later on
other architectures) it is an independent system call. Support was
added in glibc 2.0.112.
.SH "CONFORMING TO"
The
-.B vfork
+.BR vfork ()
call may be a bit similar to calls with the same name in other
operating systems. The requirements put on
-.B vfork
+.BR vfork ()
by the standards are weaker than those put on
-.BR fork ,
+.BR fork (),
so an implementation where the two are synonymous
is compliant. In particular, the programmer cannot
rely on the parent remaining blocked until a call of
-.I execve()
+.BR execve ()
or
-.I _exit()
+.BR _exit ()
and cannot rely on any specific behaviour w.r.t. shared memory.
.\" In AIXv3.1 vfork is equivalent to fork.
.SH "SEE ALSO"