]>
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 | |
8a3f29c3 | 15 | moves already mounted /proc, /dev, /sys and /run to |
b39bd025 KZ |
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" | |
b4362b6f | 27 | Display help text and exit. |
b39bd025 | 28 | .IP "\fB\-V, \-\-version\fP" |
b4362b6f | 29 | Display version information and exit. |
b39bd025 KZ |
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 | 48 | .SH "SEE ALSO" |
66083665 MF |
49 | .BR chroot (2), |
50 | .BR init (8), | |
f053ff1e MK |
51 | .BR mkinitrd (8), |
52 | .BR mount (8) | |
b39bd025 KZ |
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/. |