MIC-IMAGE-CREATOR(1)					      General Commands Manual					      MIC-IMAGE-CREATOR(1)

NAME

       mic-image-creator -  Create various images

SYNOPSIS

       mic-image-creator [options]

DESCRIPTION

       mic-image-creator is a powerful image creating tool, it can create live CD, live USB, VMWare, KVM and VirtualBox images using a yum
       repository and a kickstart file.

       There are also many companion tools for doing various operations on images, including mic-image-convertor, mic-chroot, mic-image-writer,
       mic-livecd-iso-to-disk, etc. They are all command line tools except mic-image-writer which has GUI if current runtime environment is X.
       mic-image-manager is a more powerful GUI toolset for them.

OPTIONS

       General options:

       --version			show version number and exit

       -h, --help			show this help message and exit

       -c KSCFG, --config=KSCFG 	 Path to kickstart config file

       -f FORMAT, --format=FORMAT	 Image format, you can specify as livecd, liveusb, loop, raw, nand, mrstnand, ubi, vdi or vmdk

       -t TMPDIR, --tmpdir=TMPDIR	 Temporary directory to use (default: /var/tmp)

       -k CACHEDIR, --cache=CACHEDIR	 Cache directory to use (default: private cache)

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

       --genchecksum			 Generate checksum for image file if this option is provided

       -S SUFFIX, --suffix=SUFFIX	 Image name suffix (default: date stamp)

       -b, --build-bootstrap		 Build a bootstrap, it should be used with -B or --bootstrap together

       --mainrepo=MAINREPO		 Specify main repo name, it must be a repo name in your kickstart file

       --siteconf=SITECONF		 Specify site config file, it can be used to set tmpdir, cachedir, outputdir, it also can be used to
       remap/reroute a repo in kickstart to another equivalent repo, the default site config is ~/.mic2_site.conf.

       --repo=REPO			 Specify additional repo, it may be a simple URL or a complicated tuple string, you can specify multiple
       repos using this option multiple times

       -B BOOTSTRAP, --bootstrap=BOOTSTRAP    Use a given bootstrap env to create image

       --alt-initrd-name=ALT_INITRD_NAME  Name of alternate initrd image, if NOT to use the one from kernel package

       --record-pkgs=RECORD_PKGS	  Record the installed packages, valid values: name, content

       --local-pkgs-path=LOCAL_PKGS_PATH  Path for local pkgs (rpms) to be installed

OPTIONS For Live USB
       These options are for creating the live USB file image

       -i, --interactive		  Directly write into a USB disk.

       --fstype=FSTYPE			  File system type for live USB file image, ext3 or vfat, the default is vfat.

       --overlay-size-mb=OVERLAYSIZEMB	  overlay size in MB as unit, it means how size changes you can save in your live USB disk.

OPTIONS for MRST NAND
       These options are for creating the MRST NAND image

       --initrd-url=INITRD_URL		  URL of initrd.img, if it need to be retrieved from remote site.

       --initrd-path=INITRD_PATH	  Path of initrd.img, if it was saved in local filesystem.

       --kernel-url=KERNEL_URL		  URL of kernel file(vmlinuz), if it need to be retrieved from remote site.

       --kernel-path=KERNEL_PATH	  Path of kernel file(vmlinuz), if it was saved in local filesystem.

       --kernel-rpm-url=KERNEL_RPM_URL	  URL of kernel rpm package, if it need to be retrieved from remote site.

       --kernel-rpm-path=KERNEL_RPM_PATH  Path of kernel rpm package, if it was saved in local filesystem.

       --bootimg-only	   Create boot image only.

OPTIONS For Debug
       These options control the output of logging information during image creation

       -d, --debug	   Output debugging information

       -v, --verbose	   Output verbose progress information

       --logfile=FILE	   Save debug information to FILE

EXAMPLES

       Create a live CD image:

       mic-image-creator -f livecd -c 2.1-final.ks

EXIT STATUS

       mic-image-creator 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-convertor(1), mic-chroot(1), mic-image-writer(1), mic-livecd-iso-to-disk(1), mic-image-manager(1)

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