From: Michael Kerrisk <mtk.manpages@gmail.com>
Date: Fri, 26 Jul 2019 15:10:06 +0000 (+0200)
Subject: pivot_root.2: ERRORS: EINVAL occurs if 'new_root' or its parent has shared propagation
X-Git-Tag: man-pages-5.02~18
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=1a0b1fd76b9933f0ca223ca814c7076b0fb2f75a;p=thirdparty%2Fman-pages.git

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 14904e29b3..a07b73b153 100644
--- 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