From 9f3af6b8c88fe59eb8e7fdfe15e7861535aa94e1 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Wed, 9 Oct 2019 09:37:35 +0200 Subject: [PATCH] pivot_root.2: Simplify discussion of restrictions for 'new_root' Philipp Wendler noted that the text on the restrictions for 'new_root' was slightly contradictory, and things could be clarified and simplified by describing the restrictions on 'new_root' in one place. Reported-by: Philipp Wendler Signed-off-by: Michael Kerrisk --- man2/pivot_root.2 | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/man2/pivot_root.2 b/man2/pivot_root.2 index 7b91dbc14..2317c055f 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -72,13 +72,8 @@ and .IR put_old must be directories. .IP \- -\fInew_root\fP and \fIput_old\fP must not be on the same filesystem as +\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 at or underneath \fInew_root\fP; that is, adding a nonnegative @@ -86,10 +81,13 @@ number of \fI/..\fP to the string pointed to by \fIput_old\fP must yield the same directory as \fInew_root\fP. .IP \- .I new_root -must be a mount point. -(If it is not otherwise a mount point, it suffices to bind mount +must be a mount point, but can't be +.IR """/""" . +If it is not otherwise a mount point, it suffices to bind mount .I new_root -on top of itself.) +on top of itself. +.RI ( new_root +can be a bind mounted directory on the current root filesystem.) .IP \- The propagation type of the parent mount of .IR new_root