diff options
Diffstat (limited to 'sys-utils/switch_root.8.adoc')
-rw-r--r-- | sys-utils/switch_root.8.adoc | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/sys-utils/switch_root.8.adoc b/sys-utils/switch_root.8.adoc new file mode 100644 index 0000000..fdeedf3 --- /dev/null +++ b/sys-utils/switch_root.8.adoc @@ -0,0 +1,60 @@ +//po4a: entry man manual += switch_root(8) +:doctype: manpage +:man manual: System Administration +:man source: util-linux {release-version} +:page-layout: base +:command: switch_root + +== NAME + +switch_root - switch to another filesystem as the root of the mount tree + +== SYNOPSIS + +*switch_root* [*-hV*] + +*switch_root* _newroot init_ [_arg_...] + +== DESCRIPTION + +*switch_root* moves already mounted _/proc_, _/dev_, _/sys_ and _/run_ to _newroot_ and makes _newroot_ the new root filesystem and starts _init_ process. + +*WARNING: switch_root removes recursively all files and directories on the current root filesystem.* + +== OPTIONS + +include::man-common/help-version.adoc[] + +== EXIT STATUS + +*switch_root* returns 1 on failure, it never returns on success. + +== NOTES + +*switch_root* will fail to function if _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: + +.... +mount --bind $DIR $DIR +.... + +== AUTHORS + +mailto:pjones@redhat.com[Peter Jones], +mailto:katzj@redhat.com[Jeremy Katz], +mailto:kzak@redhat.com[Karel Zak] + +== SEE ALSO + +*chroot*(2), +*init*(8), +*mkinitrd*(8), +*mount*(8) + +include::man-common/bugreports.adoc[] + +include::man-common/footer.adoc[] + +ifdef::translation[] +include::man-common/translation.adoc[] +endif::[] |