From 2835e6c500298590269e1552f0c1470b65edf6b4 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 5 Mar 2013 10:36:45 +0100 Subject: [PATCH] mount.2: srcfix: Update FIXME Signed-off-by: Michael Kerrisk --- man2/mount.2 | 37 ++++++++++++++++++++++++++++++++----- 1 file changed, 32 insertions(+), 5 deletions(-) diff --git a/man2/mount.2 b/man2/mount.2 index 73af6d3df..5b8ed65ef 100644 --- a/man2/mount.2 +++ b/man2/mount.2 @@ -85,6 +85,24 @@ and various mount flags in the low order 16 bits: .\" FIXME 2.6.15 added flags for "shared subtree" functionality: .\" MS_UNBINDABLE, MS_PRIVATE, MS_SHARED, MS_SLAVE +.\" +.\" MS_PRIVATE. +.\" All mounts are private by default. Previously shared mouns +.\" can be remarked PRIVATE. +.\" MS_SHARED +.\" Mount points that are marked SHARED propagate mount events +.\" to one another after bing cloned. +.\" MS_SLAVE +.\" A previously shared mount point can be marked SALVE, meaning +.\" it receives propagated events, but does not propagate events. +.\" MS_UNBINDABLE +.\" mounts cannot be bound into other places, and will not be +.\" propagated into new subtrees +.\" mount --make-rshared ==> MS_SHARED | MS_REC +.\" +.\" These settings are visible in proc/mountinfo +.\" +.\" .\" These need to be documented on this page. .\" See: .\" Documentation/filesystems/sharedsubtree.txt @@ -100,6 +118,14 @@ in the low order 16 bits: .\" Shared Subtree Concept and Implementation in the Linux Kernel .\" Ram Pai .\" +.\" http://www.ibm.com/developerworks/linux/library/l-mount-namespaces/index.html +.\" Applying mount namespaces +.\" +.\" Uncover practical applications for advanced Linux mounts features +.\" Serge E. Hallyn (sergeh@us.ibm.com), Software Engineer, IBM　 +.\" Ram Pai (linuxram@us.ibm.com), Software Engineer, IBM +.\" Date: 17 Sep 2007 +.\" .\" 2.6.25 Added MS_I_VERSION, which needs to be documented. .\" .TP @@ -199,7 +225,7 @@ the file's last access time is always updated if it is more than 1 day old. .\" Matthew Garrett notes in the patch that added this behavior .\" that this lets utilities such as tmpreaper (which deletes -.\" files based on last access time) work correctly. +.\" files based on last acces time) work correctly. .TP .B MS_REMOUNT Remount an existing mount. @@ -278,7 +304,7 @@ understood by this file system. See .BR mount (8) for details of the options available for each filesystem type. -.SH RETURN VALUE +.SH "RETURN VALUE" On success, zero is returned. On error, \-1 is returned, and .I errno @@ -388,7 +414,7 @@ and were only added to glibc headers in version 2.12. .\" FIXME: Definitions of the so-far-undocumented MS_UNBINDABLE, MS_PRIVATE, .\" MS_SHARED, and MS_SLAVE were (also) only added to glibc headers in 2.12. -.SH CONFORMING TO +.SH "CONFORMING TO" This function is Linux-specific and should not be used in programs intended to be portable. .SH NOTES @@ -409,7 +435,7 @@ would fail with Since Linux 2.4 the set-user-ID and set-group-ID bits are just silently ignored in this case. .\" The change is in patch-2.4.0-prerelease. -.SS Per-process namespaces +.SS Per-process Namespaces Starting with kernel 2.4.19, Linux provides per-process mount namespaces. A mount namespace is the set of file system mounts that @@ -453,8 +479,9 @@ file exposes the list of mount points in the mount namespace of the process with the specified ID; see .BR proc (5) for details. -.SH SEE ALSO +.SH "SEE ALSO" .BR umount (2), +.BR namespaces (7), .BR path_resolution (7), .BR mount (8), .BR umount (8)