sys-utils/switch_root.8

   1 .\" Karel Zak <kzak@redhat.com>
   2 .TH SWITCH_ROOT 8 "June 2009" "Linux"
   3 .SH NAME
   4 switch_root \- switch to another filesystem as the root of the mount tree.
   5 .SH SYNOPSIS
   6 .B switch_root
   7 .RB [ \-hV ]
   8 .LP
   9 .B switch_root
  10 .I newroot
  11 .I init
  12 .RI [ arg ...]
  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
  35 .SH "SEE ALSO"
  36 .BR mount (8)
  37 .BR chroot (2)
  38 .BR init (8)
  39 .BR mkinitrd (8)
  40 .SH AUTHORS
  41 .nf
  42 Peter Jones <pjones@redhat.com>
  43 Jeremy Katz <katzj@redhat.com>
  44 Karel Zak <kzak@redhat.com>
  45 .fi
  46 .SH AVAILABILITY
  47 The switch_root command is part of the util-linux-ng package and is available from
  48 ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.