aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-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