trusty (1) mic-image-creator.1.gz

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)