tzoupdate - TZO client for (much) any version of UNIX or Linux Version 1.00 released February 28 2007 Authors: Michael D. Foley, Scott Prive INTRODUCTION Compared to past version of TZO clients for Linux/UNIX, this release is all new and incorporates many customer requests. Technical Support questions should be sent to support@tzo.com. OEMS and developers must contact TZO at devsupport@tzo.com TZOUPDATE FEATURES * Makes No filesystem assumptions * Makes No OS/Distribution assumptions * Can operate without any config file (pure command line arguments) * Can operate from crontab entries (hourly, at 10 20 30 40 50 60 mins) * Does not require 'root' access - can be installed by any user * Forced updates every 28 days are built in * Ability to use /tmp for logging * Is driven by a shell script, tzowrapper, allowing for easy customization * standard shell exit ($?) codes (used by tzowrapper) * stdout output is grep friendly (used by tzowrapper) * contains support * GPL (v2) license INSTALLATION NOTES Please see INSTALL document for specifics. Platforms not tested by TZO may require availability of your OS documentation and an ability to tweak files. PLATFORMS SUPPORTED IN THIS RELEASE * Fedora Core 6 * Ubuntu * SuSE Enterprise Desktop Linux * RedHat 9 EXPERIMENTAL (compiles and runs, needs more testing) * Mac OS X 10.4 Intel * Mac OS X 10.2 PowerPC * Windows 32-bit, using Cygwin gcc + cygwin1.dll USAGE Invoke tzoupdate using the `tzowrapper` command. You may also use the -f [config file], or you may manually specify each TZO parameter on the command line. If tzowraper successfully runs without error, output is SILENT (it will write logs to /tmp/). If an error is encountered, the error is displayed (and also logged). Note that it is quite normal for the logs to only show the 'check ip' stage. The client is designed to monitor your Internet IP, and it will not force any update traffic to TZO unless your Internet IP has actually changed. ADVANCED USAGE OR EXTRA UTILITY You can disable quiet mode by changing tzowrapper's variable QUIETMODE from 1 to 0. Generally you do this only for interactive testing, because you are guaranteed an error message if there is a problem detected. QUIETMODE=0 will generate extra (local) mail to the 'owner' of the cron job. The verbose logs were designed to be parsed, perhaps by custom extensions you write. For example, * > < characters represent verbose/help, client HTTP GET requests, and server HTTP responses during the the 'check ip' stage. Conversely ** >> << is the same phases, but apply to the 'update' phase. The update phase is skipped if the IP has not changed since before. OEM /DEVELOPER NOTES TZO support adds value to your embedded or network appliance. Before 'embedding' this client into a distribution or firmware, please contact TZO Developer Support at devsupport@tzo.com and provide some information about your hardware device. PATCHES / USER CONTRIBUTIONS Contributions should be sent to devsupport@tzo.com, and may be credited in a future release.