summaryrefslogtreecommitdiffstats
path: root/sys-utils/switch_root.8
diff options
context:
space:
mode:
authorKarel Zak2009-11-20 15:18:51 +0100
committerKarel Zak2009-11-20 15:18:51 +0100
commit63cb4b0616bd436846e490fdce5fa1df6b50d5cb (patch)
tree5f93a88bf8c736e48170a3b73097e2aee5cf89b3 /sys-utils/switch_root.8
parentRevert "switch_root: add subroot support" (diff)
downloadkernel-qcow2-util-linux-63cb4b0616bd436846e490fdce5fa1df6b50d5cb.tar.gz
kernel-qcow2-util-linux-63cb4b0616bd436846e490fdce5fa1df6b50d5cb.tar.xz
kernel-qcow2-util-linux-63cb4b0616bd436846e490fdce5fa1df6b50d5cb.zip
switch_root: add note about subroots to switch_root.8
Based on patch from Daniel Drake <dsd@laptop.org> Signed-off-by: Karel Zak <kzak@redhat.com>
Diffstat (limited to 'sys-utils/switch_root.8')
-rw-r--r--sys-utils/switch_root.813
1 files changed, 13 insertions, 0 deletions
diff --git a/sys-utils/switch_root.8 b/sys-utils/switch_root.8
index 4fdc8e945..b6712ecb1 100644
--- a/sys-utils/switch_root.8
+++ b/sys-utils/switch_root.8
@@ -32,6 +32,19 @@ show version number and exit
.B switch_root
returns 0 on success and 1 on failure.
+.SH NOTES
+switch_root will fail to function if
+.B newroot
+is not the root of a mount. If you want to switch root into a directory that
+does not meet this requirement then you can first use a bind-mounting trick to
+turn any directory into a mount point:
+.sp
+.nf
+.RS
+mount --bind $DIR $DIR
+.RE
+.fi
+
.SH "SEE ALSO"
.BR mount (8)
.BR chroot (2)