StartupControl V1.3 Copyright © 1995-1996 by Dirk Jesse this software package is distributed as MAILWARE (14.11.96) 1. Disclaimer 2. Copyright & Distribution 3. Introduction 4. Requirements 5. Installation 6. Usage 7. How do things work ? 8. History 9. Thank you 10. Author`s Address ...let us take the AMIGA, where no AMIGA was ever before... ------------------------------------------------------------------------- 1. DISCLAIMER: ************** The author cannot be held liable for the suitability or accuracy of this documentation and/or the  program it describes. Any damage directly or indirectly caused by the use or misuse of this documentation and/or the program it describes is the sole responsibility of the user her/him self. 2. COPYRIGHT & DISTRIBUTION: **************************** The program and all related files are freely distributable, but are also copyright (c) by Dirk Jesse.  They may be freely distributed as long as no more than the nominal fee is charged to cover time and copying costs. No commercial usage is permitted without the written permission from the author. Everything in this distribution must be kept togehter, in original unmodified form. !! ATTENTION - SOFTWARE-STATUS OF STARTUPCONTROL HAS CHANGED !! Since this program is released as MAILWARE with version V1.1, you have to send an E-Mail to the author in order to honour his work if you use StartupControl. If you ain`t able to do so, please send a nice postcard from your hometown. This distribution contains the following files: StartupControl_V1.3 StartupControl.doc StartupControl.doc.info StartupControl.guide StartupControl.guide.info Fred Fish and the makers of the "Aminet PD Series" have special permission to distribute this software package on their CD`s. 3. INTRODUCTION: **************** PLEASE READ THIS DOCUMENTATION CAREFULLY BEFORE USING STARTUPCONTROL FOR THE  FIRST TIME TO UNDERSTAND WHAT THE PROGRAM DOES AND WHY! StartupControl is an utility that simply gives you some more contol over the boot sequence of your dream-machine. Its usual place is on the top of the  startup-sequence. From there, StartupControl will  allow you to disable execution of User-Startup and/or all files in your WBStartup- directory. If you have OS2.1 or higher you can also disable installed monitordrivers to get a pure PAL-system that doesn`t damage a connected TV-set, which only works with 15kHz modes. To complete the variety of functions you can open a  Shell window or even directly execute a scriptfile or run an executable from StartupControl via Asl- or ReqTools filerequester. The idea for StartupControl came from Lars Eilebrechts "ShadowStart 1.2" which offers similar "disable" functions, but leaves out too many functions I needed. So  I decided to write StartupControl and that`s what you got on your screen right now. You surely will find some similarities to ShadowStart in this program but why inventing the wheel twice? I like the way ShadowStart does it`s job and so I arranged  StartupControl in same way. When activating StartupControl it opens a requester where you can choose the way things will go. (11.Jun.95) Dirk Jesse 4. REQUIREMENTS: **************** The following things you need to use StartupControl: o Any Amiga with installed OS2.04 (V37) or higher o installed AmigaDos commands: execute, lock, run, newshell o reqtools.library, if you want to use ReqTools-Filerequester o Workbench 2.1 or better for using PAL-Option 5. INSTALLATION: **************** o as StartupControl is a simple command I recommend to copy it to your "C:" directory, but of course you can place it wherever you want. o Grab your favourite editor and load your "S:Startup-sequence". Now insert the following line after the SetPatch-command: "StartupControl_V1.3". o If you want to use the new (Un)Lock option you have you have to add (Un)Lock commandline switch -> see Usage - (Un)Lock o As I remember - that`s all... I decided to add a commandline switch to use this wonderful ReqTools-File- requester when selecting files. So, if you want to use it, just write: Assign ENV: ENVARC: Startupcontrol_V1.3 -r or start "RTPatch" in front of StartupControl... (RTPatch contains to the ReqTools-Package by Nico François and can be found on Aminet or almost any other PD-Collection) The "Assign" has to be done, because reqtools.library ties to load its preferences file from ENV:. If you don`t assign ENV:, reqtools.library will use its defauts and popup a lousy requester, telling you, that ENV wasn`t found. It should be assigned to ENVARC:, because StartupControl runs very early in startup process when your contents of ENVARC: isn`t copied to RAM:ENV yet. 6. USAGE: ********* When StartupControl is installed correctly, it is easy to use. Simply hold down  left or right ALT key or press the left mousebutton after a reset or after  switching on your machine and StartupControl will open a nice requester offering a variety of functions. ___________________________________________________________________ |StartupControl V1.3 © 1995-1996 by Dirk Jesse | | _____________________________________________________________ | | | | | | | PAGE 1: ...functions for daily use... | | | | | | | | ... | | | | ... | | | | ... | | | | ... | | | | ... | | | | | | | |_____________________________________________________________| | | | | WB+User WB User Shell Script Exe PAGE 2 Cancel | |___________________________________________________________________| Second Page: ___________________________________________________________________ |StartupControl V1.3 © 1995-1996 by Dirk Jesse | | _____________________________________________________________ | | | | | | | PAGE 2: ...some additional functions... | | | | | | | | ... | | | | ... | | | | ... | | | | ... | | | | ... | | | | | | | |_____________________________________________________________| | | | | Startup Vectors (Un)Lock xxxx PAL only PAGE 1 Cancel | |___________________________________________________________________| --------------------------------------------------------------------------- WB+User -> disables both, WBStartup and User-Startup and continues startup-sequence --------------------------------------------------------------------------- WB -> only disables WBStartup and continues startup-sequence --------------------------------------------------------------------------- User -> only disables User-Startup and continues startup-sequence --------------------------------------------------------------------------- Shell -> opens a shell window, startup-sequence is paused until you send a BREAK to StartupControl by typing "break 1" in your shell-window. --------------------------------------------------------------------------- Script -> opens a filerequester to let you execute a scriptfile and returns to the StartupControl-Menu when script has finished --------------------------------------------------------------------------- Exe -> opens a filerequester to let you run an executable file in background and returns to the StartupControl-Menu. --------------------------------------------------------------------------- Startup -> opens a filerequester where you can select an alternative startup-sequence to execute. It doesn`t go back to the menu after execution. This option is only a BETA version. IT WORKS but I think, it could be coded in a better way. So I would be glad if anybody would tell me, how to code this in a more comfortable way. At time following is done !! for coders only !!: StartupControl runs the scriptfile via "Execute" command and than leans back, falls into sleep and waits for a never comming Signal. So the old startup-sequence is stopped and won`t be continued. As long as you don`t use a systemmonitor you will not realize that StartupControl is still in memory. --------------------------------------------------------------------------- (Un)Lock -> gives you the opportunity to make selected devices WRITE-DISABLED. So you can forbid any write-access to your harddrives. A further selection of this gadget removes the lock from the drives. To use this option you have to add a commandline-switch to StartupControl. This has to be done in this way: C:StartupControl (-r) -dDriveA:|DriveB:|DriveC The devices you want to write-protect have to be written directly behind the switch (-d). Various devices have to be devided by "|" to be recognised by the lock command. --------------------------------------------------------------------------- Vectors-Button: _____________________________________________________________ |System-Guru V1.0 © 1996 by Dirk Jesse | | _______________________________________________________ | | | | | | | System Vectors AutoVecInts | | | | | | | | ColdCapture $xxxxxx Level 1 ($0064) $xxxxxx | | | | CoolCapture $xxxxxx Level 2 ($0068) $xxxxxx | | | | WarmCapture $xxxxxx Level 3 ($006c) $xxxxxx | | | | KickMemPtr $xxxxxx Level 4 ($0070) $xxxxxx | | | | KickTagPtr $xxxxxx Level 5 ($0074) $xxxxxx | | | | KickCheckSum $xxxxxx Level 6 ($0078) $xxxxxx | | | | Level 7 ($007c) $xxxxxx | | | |_______________________________________________________| | | | | ColdReboot Clear Vectors Thank`s for showing | |_____________________________________________________________| ColdReboot -> This routine clears the capture-vectors and the KickTagPtr. Then it does a cold reboot of your dream-machine. You will get a clear system. Clear Vectors -> This clears the capture-vectors and the KickTagPtr. No reset will be done. -> You will get a clear system after next reboot. A small tool, I wrote in ca. 35min. But I think it is very useful here. It shows you the most interesting systemvectors, where reset-proof programs are signed in. The capture-vectors and the KickTagPtr should be at zero. Otherwise there will be a message below the list warning you towards possible danger (Virusinfection!!). --------------------------------------------------------------------------- PAL only -> disables installed monitordrivers to force a TV-friendly PAL-mode !! only available with Workbench 2.1+ !! --------------------------------------------------------------------------- Cancel -> leave StartupControl, startup-sequence is continued 7. WHAT DOES STARTUPCONTROL TO DISABLE FILES OR DIRECTORIES? ************************************************************ StartupControl renames the "WBStartup" directory, "S:User-startup" file or "Devs:Monitors"  directory to prevent them from being executed ("name" is renamed to "#name"). After changing names files stay renamed until next reset. To get  back their original names after disabling them, you can rename them yourself or run  StartupControl again. If you boot your machine without activating StartupControl all files and directories are automaticly  set to their original names. So if you wont disable something, there will be no change. When opening a shell window the Startup-sequence is paused. To continue executing startup-sequence, send a "break" command to StartupControl. If StartupControl was started directly after SetPatch, it normaly has process  number 1. Typing "Break 1" in your shell-window will quit StartupControl and execution of  startup-sequence will be continued. Don`t forget to close the shell window to allow workbench to reset its screen to its needs. When using the SCRIPT or EXE option, the program returns to the menu, after execution of a selected file to give you the possibility to do further changes like opening a shell. This can be very useful, if you want to run large, memory-hungry applications like games and demos. So, you can setup a small environment via scriptfile and then watch your favrourite amiga-demos from a shell-window. RESTRICTIONS: When pressing the ALT key too early during a reset, StartupControl maybe don`t realizes that the key was pressed. This can happen, because the harware keybuffer is cleared during reset, so the keycode is already lost before StartupControl is executed. 8. HISTORY: *********** V1.3 (11.Oct.96) o Startup-Option added o Vectors-Option added (System-Guru V1.0 included) o (Un)Lock-Option added o splitted up GUI to make all these new options possible o Code improved + cleaned up + sometimes rewritten (I hope I didn`t add a bug again!) o arranged Userguide in a better way V1.2 (29.Oct.96) o Bug removed: In some cases StartupControl used wrong a path and didn`t find files ! (I tried to do this option really safe but reached the oposite... ...that`s life!) Bug found & reported by B. Breuer V1.1 (23.May.96) o EXE-Option added o after SCRIPT- and EXE-Option, StartupControl returns to its menu to allow further selections o there are no longer two versions for OS2.0 and OS2.1+ (two in one!) o ReqTools Support and commandline-option added o StartupControl sets CurrentDir to ProgDir to help programs to find their stuff o minor code changes V1.0 (11.Juni.95) o first public release 9. Thank you! ************* On this page I want to thank all these people who mailed me last time. For more than a year on Aminet there was almost no responce. But during the last months I recieved some very nice E-Mails and letters. So there are some people around the globe who like StartupControl and honour my work. Without you StartupControl V1.3 would not exist. Thank you all for geetings, bugreports and ideas...go on with this. Discussion about including new features is or just mailing is great at all. And to all black sheep who use this this little gem and didn`t gave me a notice yet -> I STILL WAIT FOR YOUR E-MAIL OR LETTER !! 10. AUTHOR`S Address: ********************* If you have any suggestions, ideas or bug-reports, please send a mail to this Address (E-Mails prefered). Dirk Jesse Promenadenstraße 11 02827 Görlitz GERMANY E-Mail: djesse@rcs.urz.tu-dresden.de System: A1200 030/50Mhz+FPU 8MB FastRAM 850MB HDD Other programs I`ve written: SAMPack convert and compress really large 8bit IFF, WAVE, VOICE, RAW samples Aminet: /mus/edit/smp_v132.lha ... That`s all folks.