Commit Graph

248 Commits

Author SHA1 Message Date
Michael Kerrisk c440fe01d3 clone.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:30 +02:00
Nicolas François 8ce39f8681 clone.2: Minor fixes
"PID namespace" is what is new.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-09-28 12:46:23 +02:00
Michael Kerrisk 8722311bc5 clone.2: Fix version number for CLONE_NEWIPC
It's 2.6.19, not 2.4.19.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-07-18 06:16:12 +02:00
Michael Kerrisk 577f9b624b clone.2: Rewrite crufty text about number of args in older version of clone()
Some bit rot had crept in regarding the discussion of the
    number of arguments in older versions of this syscall.
    Simplify the text to just say that Linux 2.4 and earlier
    didn't have ptid, tls, and ctid arguments.

    See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=533868

    Reported-by: Shachar Shemesh <shachar@debian.org>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-06-21 15:30:21 +02:00
Michael Kerrisk d3dbc9b11a clone.2: Fix errors in argument names in text (ptid, ctd)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2009-06-21 15:14:28 +02:00
Michael Kerrisk a113945faa Removed trailing white space at end of lines 2008-11-25 21:44:53 -05:00
Michael Kerrisk 489f427867 clone.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Pavel Emelyanov <xemul@openvz.org>
2008-11-25 20:54:27 -05:00
Michael Kerrisk 868d9bf528 clone.2: spfix 2008-11-25 20:54:27 -05:00
Michael Kerrisk 5584229c0e clone.2: Integrate review comments from Pavel Emelyanov
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Pavel Emelyanov <xemul@openvz.org>
2008-11-25 20:54:27 -05:00
Michael Kerrisk 9cb9dcc918 clone.2: Integrate review comments from Serge Hallyn
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Serge E. Hallyn <serge@hallyn.com>
2008-11-25 20:54:27 -05:00
Serge E. Hallyn bf032425f1 clone.2: When n/w namespace is freed, physical devices return to initial namespace
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:27 -05:00
Michael Kerrisk e1b11906a0 clone.2: Changes after review by Serge Hallyn
If CLONE_NEWUTS is specified, the IDs are initialized
by duplicating from calling process.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reviewed-by: Serge E. Hallyn <serge@hallyn.com>
2008-11-25 20:54:26 -05:00
Michael Kerrisk cae2ec15f9 clone.2: minor: Add missing word, CAP_SYS_ADMIN, for CLONE_NEWNET description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:10 -05:00
Michael Kerrisk c8e18bd181 clone.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:10 -05:00
Michael Kerrisk 163bf178a9 clone.2: Document CLONE_NEWNET
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:10 -05:00
Michael Kerrisk 83c1f4b55f clone.2: IPC objects are automatically destroyed when IPC namespace is destroyed
When the last process in an IPC namespace is destroyed, the
IPC objects in that namespace are automatically destroyed.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Cedric Le Goater <clg@fr.ibm.com>
2008-11-25 20:54:10 -05:00
Michael Kerrisk 732e54dd96 clone.2, mount.2, unshare.2, proc.5, path_resolution.7: Global fix: s/mount-point namespace/mount namespace/
This is more consistent with the term "mounts namespace"
used in the 2008 ACM SIGOPS paper, "Virtual servers
and and checkpoint/restart in mainstream Linux".
(I avoided the "s", because using the plural strikes me
as klunky English, and anyway we don't talk about
the "PIDs namespace" or the "networks namespace", etc..)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:09 -05:00
Michael Kerrisk a4cc375e5a clone.2: tfix: Fix kernel version associated with CLONE_IO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Jen Axboe <jens.axboe@oracle.com>
2008-11-25 20:54:09 -05:00
Michael Kerrisk 0236bea95b clone.2: Fix terminology: s/control group/container/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Reported-by: Eric Biederman <ebiederm@xmission.com>
2008-11-25 20:54:09 -05:00
Michael Kerrisk cf1c6c8056 clone.2: srcfix: Added FIXME 2008-11-25 20:54:08 -05:00
Michael Kerrisk 6807c79ac1 clone.2: srcfix: Updated FIXME 2008-11-25 20:54:08 -05:00
Michael Kerrisk cfdc761b8f clone.2: minor: Update changelog 2008-11-25 20:54:08 -05:00
Jens Axboe 11f27a1c68 clone.2: Document CLONE_IO (new in Linux 2.6.25)
Some text also by mtk.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:08 -05:00
Michael Kerrisk 4df2eb09d1 clone.2, mount.2, unshare.2, proc.5, path_resolution.7: Global fix: s/namespace/mount-point namespace/, as appropriate
In recent times, a number of other namespace flags have been
added to clone(2).  As such, it is no longer clear to use
the generic term "namespace" to refer to the particular
namespace controlled by CLONE_NEWNS; instead, use the
term "mount-point namespace".

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:07 -05:00
Michael Kerrisk 667417b33c clone.2: Document CLONE_NEWIPC flag (new in Linux 2.6.19)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:07 -05:00
Michael Kerrisk 43ce9ddaff clone.2: Document CLONE_NEWUTS (new in Linux 2.6.19)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:06 -05:00
Michael Kerrisk af3c728ea1 clone.2: ffix 2008-11-25 20:54:06 -05:00
Michael Kerrisk 5c95e5e8ff clone.2: spfix: s/CLONE_PID/CLONE_NEWPID/ 2008-11-25 20:54:06 -05:00
Michael Kerrisk 28cad2c108 clone.2: Document EINVAL error for CLONE_NEWPID if CONFIG_PID_NS not enabled
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:05 -05:00
Michael Kerrisk 82ee147ab6 clone.2: Document CLONE_NEWPID flag (new in Linux 2.6.24)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:05 -05:00
Michael Kerrisk 88619baf22 clone.2: spfix 2008-11-25 20:54:05 -05:00
Michael Kerrisk f5dbc7c8e9 clone.2: Place list of CLONE_* flags in alphabetical order
(No content changes.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2008-11-25 20:54:05 -05:00
Michael Kerrisk a5a061ee0c clone.2: srcfix: added comment about CLONE_STOPPED going away in glibc 2.8 2008-11-07 21:32:57 -05:00
Sam Varshavchik 9291ce36fe ffix 2008-09-25 09:50:14 +02:00
Michael Kerrisk 314c8ff41d Wording fix 2008-09-23 07:22:43 +02:00
Michael Kerrisk e7d807b715 Wording fix. 2008-09-23 06:58:51 +02:00
John Reiser a1d48abb60 Fine tune discussion of getpid() caching bug.
The error by getpid() in the presence of clone() occurs
only for a fork-like clone (one that omits CLONE_VM from the flags.)
This is a low-level detail, but there is no problem [known-to-me]
for thread-like clone().
2008-09-23 06:55:29 +02:00
Michael Kerrisk c60237c9b5 Clarify text describing getpid() caching bug for clone() wrapper.
See also: http://sourceware.org/bugzilla/show_bug.cgi?id=6910
and https://bugzilla.redhat.com/show_bug.cgi?id=417521
2008-09-23 05:04:49 +02:00
Michael Kerrisk 84811e86e2 wfix 2008-07-12 11:01:09 +00:00
Michael Kerrisk c4bb193f3c s/parameter/argument/ when talking about the things given
to a function call, for consistency with majority usage.
2008-07-10 20:53:08 +00:00
Michael Kerrisk 6387216bb2 Wrap lines at sentence breaks. 2008-06-28 04:57:20 +00:00
Michael Kerrisk 53c94269ec wfix 2008-04-25 09:53:45 +00:00
Michael Kerrisk ef37eaf2e8 Added note that CLONE_STOP (which no-one ever used anyway) is now deprecated. 2008-04-14 13:03:17 +00:00
Michael Kerrisk 21a0b03de8 Added FIXMEs 2008-02-11 09:02:41 +00:00
Michael Kerrisk 8382f16db1 grfix 2007-12-25 21:28:09 +00:00
Michael Kerrisk 34ccb744ec s/x86/i386/ 2007-12-24 17:31:35 +00:00
Michael Kerrisk 0967c11fb9 s/etc/etc./ 2007-12-22 22:43:42 +00:00
Michael Kerrisk 2777b1caec Remove section numbers for page references where the
reference refers to the page itself.  (This stops man2html
producing links from a page back to itself.)
2007-11-24 10:10:39 +00:00
Michael Kerrisk 0daa9e92d0 Fix redundant formatting macros 2007-09-20 16:26:31 +00:00
Michael Kerrisk c11b1abf2e Change mtk's email address 2007-09-20 06:52:22 +00:00
Michael Kerrisk 185341d477 Added FIXME 2007-08-05 09:39:05 +00:00
Michael Kerrisk 22399250c3 Name "ia64" consistently. 2007-07-08 16:06:51 +00:00
Michael Kerrisk cc4615cc78 Added/updated glibc feature test macro requirements 2007-07-08 12:11:40 +00:00
Michael Kerrisk 360ed6b354 Added FIXMEs. 2007-06-28 06:26:09 +00:00
Michael Kerrisk 682edefb1b ffix 2007-06-22 17:16:20 +00:00
Michael Kerrisk 0b9bdf82fb ffix 2007-06-20 22:15:34 +00:00
Michael Kerrisk 9b0e0996ee the syscall is exported as "__clone2" not "clone2". 2007-06-19 20:09:36 +00:00
Michael Kerrisk d9bfdb9c21 Convert to American spelling conventions 2007-06-08 09:56:56 +00:00
Michael Kerrisk d9343c5c13 Removed version number from .TH line 2007-05-30 05:36:26 +00:00
Michael Kerrisk 735f354f03 wfix 2007-05-28 11:07:05 +00:00
Michael Kerrisk c12fd10dcb Update these pages to reflect the fact that the _syscallN() macros have
gone away.
2007-05-26 15:22:28 +00:00
Michael Kerrisk a1d5f77cc8 Reordered sections to be more consistent, in some cases renaming
sections or shifting paragraphs between sections.
2007-05-18 16:06:42 +00:00
Michael Kerrisk a759cc870f Renamed .SH AVAILABILITY to .SH VERSIONS 2007-05-16 04:53:05 +00:00
Michael Kerrisk 2e8a7fb3a8 wrappped source line 2007-05-16 04:32:48 +00:00
Michael Kerrisk 0bfa087b03 Add section numbers to references to other pages 2007-05-11 23:07:02 +00:00
Michael Kerrisk c13182efa3 Wrapped long lines, wrapped at sentence boundaries; stripped trailing
white space.
2007-04-12 22:42:49 +00:00
Michael Kerrisk cf0a9ace57 ffix 2007-04-05 12:36:57 +00:00
Michael Kerrisk 75b48e9d74 Various fixes to CONFORMING TO 2006-12-17 01:34:44 +00:00
Michael Kerrisk ff929e3b15 Added more details to prototype.
Added discussion of IA-64's clone2() system call.
2006-12-04 05:25:49 +00:00
Michael Kerrisk a5053dcb15 Reinstate text on CLONE_DETACHED, and add a few words. 2006-09-04 06:57:17 +00:00
Michael Kerrisk 953ba3f070 x 2006-08-04 08:41:13 +00:00
Michael Kerrisk c10859eb0d Fix unbalanced quotes 2006-05-31 22:16:55 +00:00
Michael Kerrisk 5cc01e9c88 Document unshare(2), new in 2.6.16. 2006-03-20 21:29:29 +00:00
Michael Kerrisk 785e717bc1 We won't add unshare(2) just yet, so remove SEE ALSO entries for now. 2006-03-20 06:38:19 +00:00
Michael Kerrisk 16718a1c3d Added comment in SYNOPSIS to note that syscall(2) may be
preferable over _syscallN (see intro(2)).
2006-03-16 00:50:08 +00:00
Michael Kerrisk d63e9a260b Added SEE ALSO for new unshare.2 2006-03-05 20:27:43 +00:00
Michael Kerrisk 82a060204c minor punctuation clarification 2006-02-16 04:55:18 +00:00
Michael Kerrisk 29546c248f Comented out crufty text describing EINVAL error
for the now obsolete CLONE_DETACHED flag.
Under CLONE_SIGHAND, noted that 'flags' must also include
CLONE_VM if CLONE_SIGHAND is specified.
2006-02-16 04:00:49 +00:00
Michael Kerrisk 2ccb99ea53 Remove duplicate CLONE_STOPPED text. 2006-02-16 03:17:12 +00:00
Michael Kerrisk 1130df606b Amend copyright notices, in particular those where I had significant
authorship.
2006-02-15 23:15:29 +00:00
Michael Kerrisk a5a997ca09 On x86, clone() should not be called through vsyscall,
but directly through "int $0x80".
2006-02-03 03:32:38 +00:00
Michael Kerrisk e511ffb6bc Automated addition of parentheses by add_parens_for_own_funcs.sh 2005-10-19 06:54:38 +00:00
Michael Kerrisk f55c92c489 Fix small error in description of CLONE_PARENT_SETTID 2005-08-16 15:13:39 +00:00
Michael Kerrisk edcc65ff8a Various minor wording improvements; some formatting fixes 2005-06-30 08:58:03 +00:00
Michael Kerrisk 561aa928db Remove duplicated CLONE_VFORK text 2005-06-13 06:09:43 +00:00
Michael Kerrisk 3616b7c0cf New pthreads.7 page 2005-06-07 12:35:32 +00:00
Michael Kerrisk de7639e575 Updated copyright date 2005-06-02 12:52:15 +00:00
Michael Kerrisk f7110f6014 Noted that any thread in a thread group can wait for a child
that one of them creates using fork().
2005-06-02 10:22:34 +00:00
Michael Kerrisk 5e4e13a313 SEE ALSO s/threads/pthreads 2005-05-30 16:47:35 +00:00
Michael Kerrisk 99408a60ee Minor fixes to CLONE_THREAD material. 2005-05-18 08:29:38 +00:00
Michael Kerrisk e2fbf61d5a Added text on CLONE_THREAD and signals. 2005-05-17 16:21:20 +00:00
Michael Kerrisk fd8a5be48e Substantially enhanced discussion of CLONE_THREAD. 2005-05-17 15:06:30 +00:00
Michael Kerrisk a69b6bda71 Added CLONE_SYSVSEM, CLONE_UNTRACED, CLONE_STOPPED. 2005-05-10 16:48:27 +00:00
Michael Kerrisk 31830ef083 Noted the PID caching behaviour of NPTL's getpid() wrapper under BUGS. 2005-04-12 08:11:06 +00:00
Michael Kerrisk f2d0bbf129 Added set_thread_area(2), tkill (2) under SEE ALSO 2005-04-11 15:10:47 +00:00
Michael Kerrisk 2b44301c2a Added futex(2) and set_tid_address(2) to SEE ALSO 2005-04-11 15:03:38 +00:00
Michael Kerrisk 305a0578bf Global change of email address for MTK (now: mtk-manpages@gmx.net) 2004-11-03 14:43:40 +00:00
Michael Kerrisk fea681dafb Import of man-pages 1.70 2004-11-03 13:51:07 +00:00