Version History:

2004-02-15 - v1.00a_r1:
Fixed a bug that limited target names to 50 characters (now it's 256).


   -------------------


Aibo Reload v1.00a, by Francesco Tamburrino, Carnegie Mellon University, 2004.
Reloading and updating utility for the Aibo platform.

      Usage:  reload [OPTIONS] [-f configfile] [Section]


Reload is a utility to update code, data and settings to or from the Aibo
platform through the wireless network, reading commands and directives from
a configuration file.

If the '-f' option is not used, Reload will look for a 'reload.cfg' file in
the current directory. See below for a description of configuration files.

Note: the RELOAD.BIN object needs to be running on the Aibo.


==============================
   Commands and directives:   
==============================

   TARGET: <ip name or address>         (Target: mypuppy1.my-aibos.net)
   MIRROR [OPTIONS] <Source> to <Dest>  (Mirror MS/OPEN-R/MW to ms:/open-r/mw)
   COPY   [OPTIONS] <Source> to <Dest>  (Copy   ms:/logs to /dogs/logs)
   SETCLOCK
   REBOOT
   SHUTDOWN

   <Source> and <Dest> can be files or directories, either local or remote.
   Paths on the remote memory stick begin with "ms:/"

   TARGET specifies which address to use for any subsequent commands. Note
       that more than one system can be updated in a single session by just
       providing any relevant commands under new TARGET statements.

   MIRROR will take care of updating or deleting files, folders and
       subfolders so as to make <Dest> an exact replica of <Source>.

   COPY will transfer files or directories. If <Source> is a directory, all
       of its contents are copied as well.  Unlike MIRROR, it will not
       delete excess files.

   SETCLOCK will set the Aibo's internal time and timezone settings to
       match those of the local system. Although file timestamps are not
       readable on the Aibo, they are kept and can be read when the memory
       stick is accessed through a pc. Setting the date will make the file
       timestamps accurate. 

   REBOOT and SHUTDOWN will respectively reboot and shutdown the Aibo.


==============
   Options:   
==============

   -s  By default Reload will refresh all specified files. Use this option
       to skip copying of files that already exist and have the same file
       size on both systems.

   -n  Copy or mirror only new files, skipping any that already exist.

   -v  Verbose. Will detail every file or directory copied, created, or
       removed.

   -A  Always replace local files. By default, Reload asks for confirmation
       before replacing or deleting files on the local system. Use this
       option to prevent such warnings.  USE WITH CAUTION.

   All these options (except -A) can also be provided on the command line
   to affect all actions executed.


=========================
   Configuration file:   
=========================

   Commands and directives are organized in sections, so that different sets
   of actions can be exectuted as needed.

   Any instructions located before the first section are always processed.

   If no section name is specified on the command line, Reload will default
   to executing the first section it finds. 

   Here is a sample configuration file:

      ----------------------------
       # Sample reload.cfg file 

       Target: 192.168.1.3

       [Object]
       Copy -v MS/OPEN-R/MW/OBJS to ms:/open-r/mw/objs

       [All]
       # If you do this, Make sure MS/OPEN-R/MW/ contains ALL needed files.
       Mirror -v ./MS/OPEN-R/MW/ to ms:/open-r/mw/
       Reboot

       [Log]
       Copy -s -A ms:/logfile to ./logs/errorlog

       [Off]
       Shutdown

       [Time]
       SetClock
      ----------------------------

   Directives and section names are not case sensitive. 

Please send any bug reports to francesco@cmu.edu.




