aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2019-07-30 14:14:10 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2019-09-23 13:11:19 +0200
commitbbae63c5806f5c7fe4dc2834c63c50475b1e83e6 (patch)
tree3f3e202b04a6ec4735aa17671999238ff8a70123
parent41d4557c091c52a592042e3c4b73b15034802bb6 (diff)
downloadman-pages-bbae63c5806f5c7fe4dc2834c63c50475b1e83e6.tar.gz
pivot_root.2: Remove BUGS section
One of these "bugs" is a philosophical point already covered elsewhere in the page, while the other is a somewhat obscure joke. Both pieces are a bit of a distraction, really. Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man2/pivot_root.214
1 files changed, 5 insertions, 9 deletions
diff --git a/man2/pivot_root.2 b/man2/pivot_root.2
index 0e80b8a358..4abca563d4 100644
--- a/man2/pivot_root.2
+++ b/man2/pivot_root.2
@@ -70,6 +70,11 @@ must be directories.
.IP \-
\fInew_root\fP and \fIput_old\fP must not be on the same filesystem as
the current root.
+In particular,
+.IR new_root
+can't be
+.IR """/"""
+(but can be a bind mounted directory on the current root filesystem).
.IP \-
\fIput_old\fP must be underneath \fInew_root\fP, that is, adding a nonzero
number of \fI/..\fP to the string pointed to by \fIput_old\fP must yield
@@ -215,15 +220,6 @@ and exec the new
.BR init (1).
Helper programs for this process exist; see
.BR switch_root (8).
-.SH BUGS
-.BR pivot_root ()
-should not have to change root and current working directory of other
-processes in the system.
-.PP
-Some of the more obscure uses of
-.BR pivot_root ()
-may quickly lead to
-insanity.
.SH EXAMPLE
.PP
The program below demonstrates the use of