Sugar-update

From OLPC
Revision as of 02:05, 20 December 2007 by Bernie (talk | contribs) (New page: The <tt>sugar-update.py</tt> script automates the steps listed above for creating an auto-installation directory and preparing a new image. This is a python scri...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The sugar-update.py script automates the steps listed above for creating an auto-installation directory and preparing a new 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/