diff options
author | Michael Kerrisk <mtk.manpages@gmail.com> | 2005-07-06 06:52:35 +0000 |
---|---|---|
committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2005-07-06 06:52:35 +0000 |
commit | bed66765fa374e99ac74001414cc7b63be26215f (patch) | |
tree | 56d5d2cd0afc01a8071870982c92f016a39e142d /man2 | |
parent | 4c8a01a695831c6845288d6efddcc4fa0f50c0a6 (diff) |
Formatting fixes
Diffstat (limited to 'man2')
-rw-r--r-- | man2/vfork.2 | 68 |
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" |