From bbae63c5806f5c7fe4dc2834c63c50475b1e83e6 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 30 Jul 2019 14:14:10 +0200 Subject: [PATCH] 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 --- man2/pivot_root.2 | 14 +++++--------- 1 file changed, 5 insertions(+), 9 deletions(-) diff --git a/man2/pivot_root.2 b/man2/pivot_root.2 index 0e80b8a35..4abca563d 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