Command-line Usage

Submitted by Bob Spencer, updated on 16 Sep 2008 - 0 comments
Moblin Image Creator

Image Creator supports a rich command-line interface. This is useful for scripting and automation.

To see the available list of command-line options, use the following command:

$ image-creator --help

Bash Completion
Moblin Image Creator installs a bash completion configuration file. This allows you to type the first part of a command-line option and then hit the Tab key to auto-complete it which can save a lot of typing with Image Creator's long option names. You will need to first install the bash-completion package for your distribution. Example for Ubuntu:

$ sudo apt-get install bash-completion

Automating with build-clean-target.sh script
Image Creator includes a script called build-clean-target.sh which is useful when scripting the creation of a project, target, and image. The following script shows how it can be used:

#!/bin/bash
PROJECT=$1
if [ -z ${PROJECT} ]; then
    echo "USAGE:  goTarget projectname"
    echo "  example:  goTarget beta2_3     (/opt/beta2_3 is created)"
    exit 1
fi
sudo ~/src/moblin-image-creator/build-clean-target.sh ${PROJECT} mccaslin-lpia /opt/${PROJECT} samsung-full-mobile-stack xephyr

Command-line Options

A listing of all command-line options is not listed here as the options may change as image-creator is improved and extended, but the current list is always readily available by running:

$ sudo image-creator --help

The following are commonly used commands:

Create a project
image-creator --command=create-project \
   --platform-name='donley' \
   --project-name='MyProject' \
   --project-desc='Example project' \
   --project-path=/usr/src/projects/myproject

Create a target
image-creator --command=create-target \
   --project-name='MyProject' \
   --target-name='MyTarget'

Add functional sets to a target
image-creator --command=install-fset \
   --platform-name='donley' \
   --project-name='MyProject' \
   --target-name='MyTarget' \
   --fset='Core' \

Create an image
image-creator --command= [create-live-usb | \
       create-live-usbrw | \
       create-install-usb] | \
       create-live-iso | \
       create-nand ]
   --project-name='Myproject' \
   --target-name='MyTraget' \
   --image-name='MyImage'