projects / thirdparty / util-linux.git / blame
| Commit | Line | Data |
|---|---|---|
| b39bd025 | 1 | .\" Karel Zak <kzak@redhat.com> |
| 232dc924 | 2 | .TH SWITCH_ROOT 8 "June 2009" "util-linux" "System Administration" |
| b39bd025 | 3 | .SH NAME |
| 232dc924 | 4 | switch_root \- switch to another filesystem as the root of the mount tree |
| b39bd025 KZ |
5 | .SH SYNOPSIS |
| 6 | .B switch_root | |
| 07de218c | 7 | .RB [ \-hV ] |
| b39bd025 KZ |
8 | .LP |
| 9 | .B switch_root | |
| 10 | .I newroot | |
| 11 | .I init | |
| 07de218c | 12 | .RI [ arg ...] |
| b39bd025 KZ |
13 | .SH DESCRIPTION |
| 14 | .B switch_root | |
| 15 | moves already mounted /proc, /dev and /sys to | |
| 16 | .I newroot | |
| 17 | and makes | |
| 18 | .I newroot | |
| 19 | the new root filesystem and starts | |
| 20 | .I init | |
| 21 | process. | |
| 22 | ||
| 23 | .B WARNING: switch_root removes recursively all files and directories on the current root filesystem. | |
| 24 | ||
| 25 | .SH OPTIONS | |
| 26 | .IP "\fB\-h, \-\-help\fP" | |
| 27 | show help and exit | |
| 28 | .IP "\fB\-V, \-\-version\fP" | |
| 29 | show version number and exit | |
| 30 | ||
| 31 | .SH RETURN VALUE | |
| 32 | .B switch_root | |
| 33 | returns 0 on success and 1 on failure. | |
| 34 | ||
| 63cb4b06 KZ |
35 | .SH NOTES |
| 36 | switch_root will fail to function if | |
| 37 | .B newroot | |
| 38 | is not the root of a mount. If you want to switch root into a directory that | |
| 39 | does not meet this requirement then you can first use a bind-mounting trick to | |
| 40 | turn any directory into a mount point: | |
| 41 | .sp | |
| 42 | .nf | |
| 43 | .RS | |
| 44 | mount --bind $DIR $DIR | |
| 45 | .RE | |
| 46 | .fi | |
| 47 | ||
| b39bd025 KZ |
48 | .SH "SEE ALSO" |
| 49 | .BR mount (8) | |
| 50 | .BR chroot (2) | |
| 51 | .BR init (8) | |
| 52 | .BR mkinitrd (8) | |
| 53 | .SH AUTHORS | |
| 54 | .nf | |
| 55 | Peter Jones <pjones@redhat.com> | |
| 56 | Jeremy Katz <katzj@redhat.com> | |
| 57 | Karel Zak <kzak@redhat.com> | |
| 58 | .fi | |
| 59 | .SH AVAILABILITY | |
| 601d12fb KZ |
60 | The switch_root command is part of the util-linux package and is available from |
| 61 | ftp://ftp.kernel.org/pub/linux/utils/util-linux/. |