Sugar-update

The sugar-update.py script automates the steps for creating an Autoreinstallation image. This is a Python script, and as such requires Python to run.

Usage

sugar-update.py [-cdflLqs] [-s stream] [-b build] [directory]

Description

This script will create an autoinstallation image boot directory within the specified directory. If the boot directory already exists, it will only download the necessary image files (.img, .crc, and .rom). Any of these files already present within this boot directory will be deleted before the download begins. If no directory is specified, the current working directory will be used.

This script has also has automatic support for downgrades, and will add the necessary force.os file to the boot directory if the build image already present there is newer than the build specified.

Options

-b    Specify a build number; defaults to latest development build

-c    Create a clean auto-installation image, replacing existing boot directory

-d    Force downgrade image; implicit when a newer build exists in boot

-f    Skip firmware update

-l    Print the associated change log

-L    Print the change log for the specified build and quit

-q    Quiet; do not print progress output

-s    Download the latest stable build; overrides the -b option

-S    Specify the stream to pull a build from

Examples

If you're creating a boot directory from scratch, you'll simply want to use:

      sugar-update.py /path/to/USBdrive/

By adding the -s flag to the above, the latest stable image will be prepared instead:

      sugar-update.py -s /path/to/USBdrive/

For frequent updates it's useful to show the change log for the new builds:

      sugar-update.py -l /path/to/USBdrive/