Poster of Linux kernelThe best gift for a Linux geek
MIC

MIC

Section: User Commands (1) Updated: Dec 2010
Local index Up
 

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 <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, N8x0/jffs2 and N900/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
    --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
    -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

 

SEE ALSO

Type 'mic help <subcommand>' 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.


 

Index

NAME
SYNOPSIS
DESCRIPTION
COMMANDS
GLOBAL OPTIONS
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 21:23:53 GMT, April 16, 2011