pivot_root.2: ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

diff --git a/man2/pivot_root.2 b/man2/pivot_root.2
index 14904e29b3938ad6b33c40417672238aaf7eef56..a07b73b153c64642c7f0cbb2dd0c7e9308051be8 100644 (file)
--- a/man2/pivot_root.2
+++ b/man2/pivot_root.2
@@ -96,6 +96,11 @@ must be a mount point.
 (If it is not otherwise a mount point, it suffices to bind mount
 .I new_root
 on top of itself.)
+.PP
+The propagation type of
+.I new_root
+and its parent mount must not be
+.BR MS_SHARED .
 .SH RETURN VALUE
 On success, zero is returned.
 On error, \-1 is returned, and
@@ -120,6 +125,13 @@ is not a mount point.
 .B EINVAL
 The current root is on the rootfs (initial ramfs) filesystem.
 .TP
+.B EINVAL
+Either the mount point at
+.IR new_root ,
+or the parent mount of that mount point,
+has propagation type
+.BR MS_SHARED .
+.TP
 .B ENOTDIR
 \fInew_root\fP or \fIput_old\fP is not a directory.
 .TP