update-util

NAME

update-util - a tool to inspect. modify and unpack update packs

SYNOPSIS

update-util [file] [file file] [-t] [-l [name]...] [-x [name]...] [-s] [-p output_dir]

DESCRIPTION

update-util -h|--help
     Print this message.

update-util [updateFile]
     List the headers found in the updateFile to stdout.

update-util [oldSystemUpdateFile] [newSystemUpdateFile] [outputFile]
     Create a delta system update file with the name given for outputFile
     using oldSystemUpdateFile as the initial update calculating the changes
     necessary to get from the initial system to that in newSystemUpdateFile
     omitting unchanged apps.

update-util [updateFile] -t|--terse
     List just the names of the sections found in the update file

update-util [updateFile] -l|--list [[name] ... ]
     List the files contained in each section. If a name or list of names are given,
     only those sections will have their contents listed.

update-util [updateFile] -x|--extract [[name] ... ] [-s|--staging] [-p|--output-path output_dir]
    Unpack any of the named sections in the list of names. Sections will be unpacked
    into directories that are named as per the name found in the header. If no names
    are given then the entire update will be unpacked.

    if the option -p is given then the unpack will be done into output_dir, which will be
    created if it does not exist.

    option -s will cause the sections to be unpacked with paths and names as they are in
    the staging directory after being built and before being packed. The system, if present,
    will be unpacked into a directory named 'system' and the apps will be unpacked into an
    'apps' directory with each app in a directory named for its md5 sum.

    'system' is a pseudo name - no header contains the name system but it can be used to refer
    to the system section. Try not to create any apps named 'system' as this will confuse
    update-util.

examples:

    unpack-util update_file -x tools
    - Unpack the tools app from update_file into a directory named tools

    unpack-util update_file -x -s tools
    - Unpack the tools app to apps/xxx where xxx is the md5 sum of the tools app

    unpack-util update_file -x -s -p my_staging
    - Unpack all the sections of the update file with their staging paths into
      a directory named my_staging