MIC-CHROOT(1)						      General Commands Manual						     MIC-CHROOT(1)

NAME

       mc-chroot - chroot into a live image in order to do some changes

SYNOPSIS

       mic-chroot [options] <image|image fs>

       <image> is a live image file name, <image fs> is a directory path which
	contains the whole file system unpacked from a live image.

DESCRIPTION

       mic-chroot can chroot into a live image to do some changes, you can use it to unpack a live image then do some changes, once changes are
       done, you can regenerate a live image including those changes you did.

       mic-image-manager has a GUI tool for mic-chroot, you can use it if you prefer to use GUI instead of command line.

OPTIONS

       --version		      show version number

       -h, --help		      show this help message

       -s SAVETO, --save-to=SAVETO    Save unpacked filesystem to the specified path

       --unpack-only		      Just unpack an image, this is used tounpack an image with -s option together

       -b BINDMOUNTS, --bind-mounts=BINDMOUNTS	  Specify bind mount list, for example: -b "/proc:/proc;/:/parentroot"

       -c CONVERTTO, --convert-to=CONVERTTO	  Convert it to the specified type live image on exiting, the allowed value is livecd or liveusb

       --convert-only		      Just convert an image, this will skip chroot and directly convert an image/filesytem with -c option together

       -o OUTDIR, --outdir=OUTDIR     Output directory to use (default: current work dir)

EXAMPLES

       Unpack an image to a directory and chroot into it:

       mic-chroot -s /my/fs/root

EXIT STATUS

       mic-image-convertor returns  a  zero  exist  status  if it succeeds, otherwise return non-zero and print error message.

AUTHOR

       Yi Yang, Anas Nashif, Jianfeng Ding

SEE ALSO

       mic-image-creator(1), mic-convertor(1), mic-image-writer(1), mic-livecd-iso-to-disk(1), mic-image-manager(1)

perl v5.12.3							    2011-05-31							     MIC-CHROOT(1)