--- name: "mic" section: "1" platform: "linux" package: "mic2" version: "0.24.12-1" release: "Debian 7 (Wheezy)" platforms: ["linux"] url: "https://new.carta.tech/mic" --- # mic(1) MeeGo image command-line tool. ## NAME mic - MeeGo image command-line tool. ## 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 \ # 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 \ -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 \ # 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 \ # 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 ## SEE ALSO Type 'mic help \' for more detailed help on a specific subcommand. For additional information, see\ \* http://www.meego.com/\ \* http://moblin.org/projects/moblin-image-creator-2 ## AUTHOR mic was written by Yi Yang, Anas Nashif and Jianfeng Ding. This man page is automatically generated.