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)