usage: bmgr [backup|restore|list|transport|run]
       bmgr backup PACKAGE
       bmgr enable BOOL

       bmgr enabled

       bmgr list transports

       bmgr list sets

       bmgr transport WHICH

       bmgr restore TOKEN
       bmgr run
       bmgr wipe PACKAGE



The 'backup' command schedules a backup pass for the named package.

Note that the backup pass will effectively be a no-op if the package

does not actually have changed data to store.



The 'enable' command enables or disables the entire backup mechanism.

If the argument is 'true' it will be enabled, otherwise it will be

disabled.  When disabled, neither backup or restore operations will

be performed.



The 'enabled' command reports the current enabled/disabled state of

the backup mechanism.



The 'list transports' command reports the names of the backup transports

currently available on the device.  These names can be passed as arguments
to the 'transport' command.  The currently selected transport is indicated

with a '*' character.



The 'list sets' command reports the token and name of each restore set

available to the device via the current transport.



The 'transport' command designates the named transport as the currently

active one.  This setting is persistent across reboots.



The 'restore' command initiates a restore operation, using the restore set

from the current transport whose token matches the argument.



The 'run' command causes any scheduled backup operation to be initiated

immediately, without the usual waiting period for batching together

data changes.



The 'wipe' command causes all backed-up data for the given package to be

erased from the current transport's storage.  The next backup operation
that the given application performs will rewrite its entire data set.

4