SYNOPSIS

mic [GLOBALOPTS] SUBCOMMAND [OPTS] [ARGS...]
mic help SUBCOMMAND

DESCRIPTION

MeeGo image command-line tool.

COMMANDS

chroot (ch)

chroot into an image

This command is used to chroot into a live image to do some changes.

Examples:
   mic chroot -s /fs/path <your live image>   # unpack your live image to /fs/path and chroot into it

usage:
    mic chroot [ARGS...]

Options:
    -h, --help  show this help message and exit
    --logfile=FILE
                Save debug information to FILE
    -v, --verbose
                Output verbose information
    -d, --debug
                Output debugging information
    -o OUTDIR, --outdir=OUTDIR
                Output directory to use (default: current work dir)
    --convert-only
                Just convert an image, this will skip chroot and
                directly convert an image/filesytem with -c option
                together
    -e EXECUTE, --execute=EXECUTE
                Execute the given command within the chroot instead of
                an interactive shell
    -c CONVERTTO, --convert-to=CONVERTTO
                Convert it to the specified type live image on
                exiting, the allowed value is livecd or liveusb
    -b BINDMOUNTS, --bind-mounts=BINDMOUNTS
                Specify bind mount list, for example: -b
                "/proc:/proc;/:/parentroot"
    --unpack-only
                Just unpack an image, this is used tounpack an image
                with -s option together
    -s SAVETO, --save-to=SAVETO
                Save unpacked filesystem to the specified path

convert (cv)

convert an image format to another one

This command is used to convert a live, raw, vmdk or vdi image to a live image.

Examples:
   mic convert -I <yourimage> -T liveusb    # convert your image to a live USB image

usage:
    mic convert [ARGS...]

Options:
    -h, --help  show this help message and exit
    --overlay-size-mb=OVERLAYSIZEMB
                Overlay size in MB as unit, it means how size changes
                you can save in your live USB disk.
    --fstype=FSTYPE
                File system type for live USB image, ext3 or vfat, the
                default is vfat.
    -i, --interactive
                Directly write into a USB disk.
    -S SUFFIX, --suffix=SUFFIX
                Image name suffix (default: date stamp)
    -P PREFIX, --prefix=PREFIX
                Image name prefix (default: meego)
    -o OUTDIR, --outdir=OUTDIR
                Output directory to use (default: current work dir)
    -t TMPDIR, --tmpdir=TMPDIR
                Temporary directory to use (default: /var/tmp)
    -T DSTFORMAT, --target-format=DSTFORMAT
                Target image format, possible values are: livecd and
                liveusb
    -I SRCIMG, --source-image=SRCIMG
                Source image which was created by mic-image-creator or
                an image file system.
    -F SRCFORMAT, --source-format=SRCFORMAT
                Source image format, possible values are: raw, vmdk or
                vdi (default: automatically detect image type).

create (cr)

Create an image

This command is used to create various images, including live CD, live USB, loop, raw/KVM/QEMU, VMWare/vmdk, VirtualBox/vdi, Moorestown/mrstnand, jffs2 and ubi.

Examples:
   mic create                         # create an image according to the default config
   mic create --format=liveusb        # create a live USB image

usage:
    mic create [ARGS...]

Options:
    -h, --help  show this help message and exit
    --volumeid=VOLUMEID
                Specify volume id, valid only for livecd
    --pkgmgr=PKGMGR
                Specify the package manager, the available package
                managers have zypper and yum currently.
    --save-kernel
                Save kernel image file into outdir
    --traceback
                Dump call stack
    --logfile=FILE
                Save debug information to FILE
    -v, --verbose
                Output verbose information
    -d, --debug
                Output debugging information
    --bootimg-only
                Create boot image only.
    --kernel-rpm-path=KERNEL_RPM_PATH
                Local path to kernel rpm package.
    --kernel-rpm-url=KERNEL_RPM_URL
                Remote URL of kernel rpm package.
    --kernel-path=KERNEL_PATH
                Local path of kernel file (vmlinuz).
    --kernel-url=KERNEL_URL
                Remote URL of kernel file (vmlinuz).
    --initrd-path=INITRD_PATH
                Local path of INITRD image.
    --initrd-url=INITRD_URL
                Remote URL of INITRD image.
    --overlay-size-mb=OVERLAY_SIZE_MB
                Overlay size in MB as unit, it means how size changes
                you can save in your live USB disk.
    --fstype=FSTYPE
                File system type for live USB file image, ext3 or
                vfat, the default is vfat.
    -i, --interactive
                Directly write into a USB disk.
    --include-source
                Generate a image with source rpms included
    --compress-disk-image=COMPRESS_DISK_IMAGE
                Compress the disk image that is created. When using
                --release option default is bz2, otherwise default is
                none. Supported compression methods: bz2, none
    -p PACKAGE, --package=PACKAGE
                Package format, this option will package up output
                into a given-format package, currently only tar,
                tar.gz and tar.bz2 are supported, the default is none,
                i.e. doesn't package up output
    --local-pkgs-path=LOCAL_PKGS_PATH
                Path for local pkgs (rpms) to be installed
    --record-pkgs=RECORD_PKGS
                Record the installed packages, valid values: name,
                content
    --alt-initrd-name=ALT_INITRD_NAME
                Name of alternate INITRD image, if NOT to use the one
                from kernel package
    --run-mode=RUN_MODE
                Specify run mode, 0 means legacy, 1 means bootstrap,
                by default it is gotten from config file.
    --use-comps
                Use comps instead of patterns if comps exists
    -a ARCH, --arch=ARCH
                Specify target arch of image, for example: arm
    -B BOOTSTRAP, --bootstrap=BOOTSTRAP
                Use a given bootstrap env to create image
    --default-ks=DEFAULT_KS
                Set which kickstart file from repos to select in
                advance, if specified, there isn't interaction needed
                any more.
    --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
    --ignore-siteconf
                Ignore site configs, this will ignore the default site
                configs, also ignore --siteconf option.
    --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 configs are
                /etc/mic2/mic2.conf and ~/.mic2.conf.
    --mainrepo=MAINREPO
                Specify main repo name, it must be a repo name in your
                kickstart file
    --rebuild-bootstrap
                Rebuild the bootstrap
    -b, --build-bootstrap
                Build a bootstrap, it should be used with -B or
                --bootstrap together
    -S SUFFIX, --suffix=SUFFIX
                Image name suffix (default: date stamp)
    -P PREFIX, --prefix=PREFIX
                Image name prefix (default: meego)
    --genchecksum
                Generate checksum for image file if this option is
                provided
    --release=RELEASE
                Generate a MeeGo release with all necessary files for
                publishing.
    -o OUTDIR, --outdir=OUTDIR
                Output directory to use (default: current work dir)
    -k CACHEDIR, --cache=CACHEDIR
                Cache directory to use (default: private cache)
    -t TMPDIR, --tmpdir=TMPDIR
                Temporary directory to use (default: /var/tmp)
    -f FORMAT, --format=FORMAT
                Image format, you can specify as fs, livecd, liveusb,
                loop, raw, nand, mrstnand, ubi, jffs2, vdi or vmdk
    -c CONFIG, --config=CONFIG
                Path to kickstart config file

help (?)

give detailed help on a specific sub-command

usage:
    mic help [SUBCOMMAND]

launchvm (lv)

launch a virtual machine image

This command is used to launch a virtual machine image.

Examples:
   mic launch <your vm image>   # launch a virtual machine image

usage:
    mic launchvm [ARGS...]

man

generates a man page

usage:
    mic man

write (wr)

write a live image to usb disk

This command is used to write a live image to usb disk.

Examples:
   mic write <your live image>   # write a live image to usb disk

usage:
    mic write [ARGS...]

Options:
    -h, --help  show this help message and exit
    -g, --gui   Run in GUI mode
    -c, --console
                Run in console mode

GLOBAL OPTIONS

Options:
    --version   show program's version number and exit
    -h, --help  show this help message and exit

AUTHOR

mic was written by Yi Yang, Anas Nashif and Jianfeng Ding. This man page is automatically generated.