solaris - chroot (1)



NAME
     chroot - change root directory for a command


SYNOPSIS
     /usr/sbin/chroot newroot command


AVAILABILITY
     SUNWcsu


DESCRIPTION
     chroot causes command to be executed  relative  to  newroot.
     The  meaning of any initial slashes (/) in the path names is
     changed  to  newroot  for  command  and  any  of  its  child
     processes.  Upon execution, the initial working directory is
     newroot.

     Notice that redirecting the output of command to a file:

          chroot newroot command >x

     will create the file x relative to the original root of com-
     mand, not the new one.

     The new root path name is always  relative  to  the  current
     root:  even  if a chroot is currently in effect, the newroot
     argument is relative to the current root of the running pro-
     cess.

     This command can be run only by the super-user.


RETURN VALUES
     The exit status of chroot is the return value of command.


EXAMPLE
     chroot provides an easy way to  extract  tar  files  written
     with absolute filenames to a different location.
          example# cp /usr/sbin/static/tar /tmp
          example# dd if=/dev/nrst0 | chroot /tmp tar xvf -
     Note that tar is statically linked, so you do  not  have  to
     copy any shared libraries to the newroot filesystem.


SEE ALSO
     cd(1), chroot(2)


NOTES
     Exercise extreme caution when referencing  device  files  in
     the new root file system.