/* ** ** $VER: Reboot.doc 1.3 (18.3.96) ** Reboot 1.3 ** ** documentation ** ** (C) Copyright 1994-96 by Roland 'Gizzy' Mainz ** All Rights Reserved ** */ ===================== Reboot 1.3 documentation ======================== =========================================================================== A simple tool to be used with Kickstart 2.x/3.x, written by Roland 'Gizzy' Mainz, freeware, all rights reserved. No guarantee of any kind is made that the programm described below in this document is 100% reliable. You use this material on your own risk. =========================== Misc ========================================== =========================================================================== While playing with ENVOY 1.6, I need a program which allows to reboot another AMIGA through the network (by my own "RemoteNetShell") or after a given time. First I wrote a little script (using WAIT) and a C program calling exec.library/ColdReboot() to solve this problem. Switching to IAM's ENVOY 2.0 I replaced this script by this tool, adding some features (WB (including multiselect), SHELL ReadArgs(), locale support and test mode). In the first release (V1.1) were four bugs: 1. The "Abort reboot" requester couldn't be canceld 1 second before the given time. Fixed. 2. I did not read the autodocs exactly: The function BuildEasyRequest might return 0 or 1 at low mem time. Now Reboot simply fails with ERROR_NO_FREE_STORE for both 0 or 1. If 1 was returned, an enforcer hit would occur. Never happed, but fixed. 3. AttemptOpenLibrary could return (sometimes) random pointers. In fact, this never happened by me, but maybe ... Fixed. 4. While getting Reboot's environment variable, the "Abort reboot" requester might be canceled. Now we check this: Fixed. Additional, there was some code cleanup which adds support for DICE INLINE calls. The executable is now PURE and can be made resident. The time between the program checks the "Abort reboot" requester has beed decrased down to a half second. Starting with V1.3 environment variables are supported. Things set in var REBOOT (local or global) will be parsed after built-in default settings and before any user-given arguments (shell args or project icons), which can overide those settings given there. =========================== Installation ================================== =========================================================================== After unpacking this archieve: Workbench: - Drop the 'Reboot' icon in your favorite drawer (like "SYS:Utilities/"). See SHELL for copying the catalog files. Shell: - Unpack this archieve at "SYS:Utilities/" and add the following statements at your "S:user-startup" startup file: Assign Reboot: SYS:Utilities/Reboot path Reboot: ADD OR - Drop/Copy the 'Reboot' file in your favorite directory (like "Sys:Utilities"). To copy the (german) catalog files, type Copy Catalogs/#? TO="LOCALE:Catalogs/" ALL QUIET CLONE =============================== Usage ===================================== =========================================================================== NAME Reboot -- rebooting utility FORMAT Reboot [REBOOTDELAY ] [QUIET|NOREQ] [OFF] TEMPLATE REBOOTDELAY/K/N,QUIET=NOREQ/S,OFF/S TOOLTYPES REBOOTDELAY/N QUIET/S NOREQ/S OFF/S PURPOSE To reboot the computer. SPECIFICATION Reboot is used to reboot the whole computer like a "cold" system start. Unless you specify otherwise (through REBOOTDELAY option), reboot will wait 2 seconds before rebooting the system. This is used to let the system (and it's disk drives) settle. This delay time can't be less than 1 second, a REBOOTDELAY=0 will also wait this minimum time. Whenever the QUIET (or NOREQ) option is set, the verify requesters ("Are you sure#?" etc.) will be suppressed. If the OFF switch is set, the tool act like when a CTRL-C signal has been send to the tool. Variable support: The environment REBOOT variable (either LOCAL or GLOBAL) can be used for default settings. The parsing template for this variable is the same like the shell template (see above). Reboot supports workbench multiselect (e.g. project icons) ! BUGS/NOTES Shell variables longer than 255 are currently not supported. "Set Reboot OFF" (e.g. using a local variable) is only valid if you start Reboot from this shell. Running CPU FASTROM causes sometimes problems: The system reboots, but then hang atfer a while ??? =============================== TODO ====================================== =========================================================================== - AmigaGuide document "Reboot.guide" ============================== SOURCE ===================================== =========================================================================== Reboot source and catalogs may be recompiled/reprocessed (using DICE-C, SAS-C or GNU-C) by executing Reboot.c. If you would use SAS-C, you must enable the related shell statements (and the DICE ones must be disabled). Currenty the SAS-C section isn't tested. GNU-C support will be done in one future version. If you like to include a new language (like Français or Nederlands etc.), send me a filled "Reboot_blank.ct" file named "Reboot_#?.ct" (#? for your language). As an example, see "Reboot_deutsch.ct". Note that I can currently only process "Reboot_#?.ct" files whose language is supported by AmigaOS 3.1 (e.g. a CBM language driver exists). =========================== Author's Request ============================== =========================================================================== By releasing this program I do not place any obligations on you, feel free to share this program with your friends (and enemies). If you want to blame me, report any bugs, or wants a new version send your letter to: Roland Mainz Hohenstaufenstraße 8 52388 Nörvenich GERMANY EMAIL is also available: If you don't find a file "email.changed" in this archieve, my email address is: mainz@mats.gmd.de Sorry, but I can only look once a month for mails. The entire "Reboot" package may be noncommercially redistributed, provided that the package is always distributed in it's complete form (including it's documentation). A small copy fee for media costs is okay but any kind of commercial distribution is strictly forbidden! Comments and suggestions how to improve this program are generally appreciated! Thanks to Matt Dillon for his DICE, and Olaf 'Olsen' Barthel for his help, ideas and some text clips from his documentations.