GURU-X 0.7b ************ Decoding program for guru numbers and Amiga Dos error codes. ©1992 by Karl-Erik Ruud This program is freeware, non-military use only. Guru-X is based on Commodore's briefly explonation of the Amiga's guru numbers. Guru-X is programmed in HiSoft Basic 1.05. Extend.library from Hisoft/Sunsmile and arp.library from AmigaDOS Resource Project are neccesary to run Guru-X. Also needed are Guru-X.pic and Helvetica 18 point. Thanks to Dave Boulton, Ralph Johnston and Betty Clay for their guru bulletins, to Daniel Bloch for bringing me all the gurus for WB 1.3 and 2.0, to Tor Willy Austerslaatt for his cli adaption and useful hints (the cli option and memory save option will be included in the next version), and to Arthur Hagen who discovered many bugs in the previous versions. Please send missing gurus and their meaning so I can include them in this program. Bug reports (I'm sure there are some) and suggestions are also welcome. My address: Karl-Erik Ruud Platous gate 27 N-0190 Oslo Norway Tel.: +47-2-174422 Included in this Lharc-archive (GURU-X.LZH): GURU-X The guru decoder (to be placed in C:) GURU-X.INFO Guru's info file (to be placed in SYS:) GURU-X.DOC This file (to be placed in SYS:) GURU-X.DOC.INFO Info file for the doc (placed in SYS:) POSTSCRIPTDRIVER Postscript printer driver (devs:printers/) GURU-X.INSTALL Install script GURU-X.INSTALL.INFO Info file for Guru.install If you are unable to unpack it, or the archive are uncomplete, please let me know, and I'll send you a correct archive. Just send me a disk that I'll return to you a working copy of the program. To use the program: Since I hate reading docs, I've done this program as simple as possible to use. You can run it from Cli/Shell or Workbench. From Cli/Shell: Just type 'Guru-X' (the options and commands will be added in the next version). From Workbench: Just double-click on Guru-X's icon. Then you have to type a Guru number of 8 characters in lenght including the 8 character long task address (a line shift will be done automaticly), or only the 8 characters long Guru number, or a 3 digit long Amiga Dos error code followed by return. The program will only allow you to type the characters 1 to 9, a to f and A to F. If you type any other character, it will not be registered or displayed by the program. F.ex. 01fj5ka2 will be registered as 01F5A2. The decoding will now be displayed on the screen (the line separation is not fixed yet with decoding of Guru's - Amiga Dos errors are displayed okay). Now you can do several things. If you click on NEW GURU, the program will decode a new number as described above. By clicking PRINT you will see a requester asking you to press OK when the printer is ready, or abort by pressing CANCEL. As you might guess, OK will dump the information to the printer installed in Preferences (you might wish to use the included POSTSCRIPTDRIVER if you have a postscript printer). SAVE will bring you a file requester. You may now choose the directory and file name for the Guru-X decoding file. If the file you have chosen exists, and it's not a Guru-X file, a requester will pop up and ask if you want to overwrite this file. OVERWRITE will overwrite it, and NO WAY! will abort the saving. If the file is an old Guru-X file, the new decoding will automaticly be added to the end of the file. QUIT will end the program. If you click any other place on the screen, information about Guru-X will be displayed in a requester. Click any of the CONTINUE buttons when you have seen the information. To get help with the program, press the HELP button on the keyboard, and click on the function you wants help with. This function is not working in this version, but will be added in the final version. The program accepts both upper and lower case - it converts all letters to upper case. Description: Specific error code -----+ +--- Task Address | | 02 01 0009 . 00009310 | | Subsystem number -+ +--- General error code This is how the guru numbers are splitted by Commodore, and I've included checks for all (exept the task address). The task address will be converted to ascii, in case the system wants to tell you something important. The time and date will be printed, saved or appended, but will not be displayed on the screen. History and bugs: Version 0.1 - 0.2: Internal versions only. Version 0.3 had one nasty bug; it didn't recognize some of the most common guru numbers, those with 7 zeroes. That was fixed in version 0.4. Version 0.4 would also tell you if the guru was recoverable or not (in some cases only). That version did not ask you about the task address, although typing it in wouldn't hurt. Version 0.5 has been totally rewritten. All the 1.3 and 2.0 gurus are included (as far as I know...). The explonation of the guru numbers has been further developed (and corrected). It now checks if the guru are recoverable or not, the error, and what caused the error. It also shows you explonations for specific error numbers. The window has been fixed so you can use it like any normal wb-window. I tried to put the program on a CLI-window, but I got into problems (a guru and some other nasty things), so I decided to let the program use its own window. Sorry about that! Version 0.6 is a bugfix of the previous version. Version 0.5 'invented' error solutions, and that have been removed from this version. The routine for decoding specific errors has been totally rewritten due to a misunderstanding in previous versions. Gurus reported by the Motorola 680x0 itself has been included. The program can't be run from a window - it's totally clionized! Sorry about that wb-fans! I'll try to fix it in the next version. The decoding can be printed, saved or appended. This file can be listed from the program if you put it in the S: directory. A help text has been included, and a hex-to-ascii table for address converting. Date and time has been included (but not for the screen display - use the common dos-commands). Version 0.6b has been fixed for some bugs reported in 0.6. The decoding has been less cryptic, and are in most cases very understandable. I think I've fixed all decoding bugs, so now you can trust the program - at last! Doc dumping has been included (if you have placed Guru.doc in S:) both to the screen and to a printer. Version 0.6c is mostly a wb-conversion of 0.6b - no menues included yet. Pause in listing the doc (only when it runs from wb) has been included, and I've fixed minor errors. It certainly runs from Cli/Shell too. Version 0.7a is a beta-version spread to a few people. A graphic interface has been added (actually a iff picture that Guru-X will look for in different directories), all Commodore three-digit error codes has been included, and also Arp library gurus. The program has changed its name to Guru-X (since there are at least two other programs called Guru). The doc reading has been removed since there are so many good programs that can display the doc file. Instead a help function will be added in the final version. Also to be added are a Cli interface and a memory save option. The program will look for all the different files and warn you if they are not found. In the final version a standard window will be started if the font or picture can't be found. The separating of decoding lines isn't finished in this version, but will be fixed for the final version. This version has been tested on an A2000 and an A600 with wb/ks 2.0. No specific 2.0 funtions are used, so it should work okay on versions 1.2 and 1.3 also. All neccesary requesters and file requesters has been included. This version needs Guru-X.pic, Helvetica 18 point, arp.library and extend.library to work with the nice screen (none of theese are required for the Cli and memory save options that will be included later). Version 0.7b is the version that I included on my first pd-disk. This version has the help-function working as it should. Status text that tell you what is happening (for example. 'Printing cancelled') at all times has been added. Unfortunately the disk has been disturbated with the doc for version 0.7a. Sorry about that! Looking into the future: I'll continue to include all the new gurus for wb 3.0. You will be able to load a guru decoding file to automatic compare several guru numbers (and addresses) or to make statistics. Guru-X will try to figure out if the task address are in chip or fast memory, and the ram block number. The program will suggest hardware errors. A new file format will be added to save valuable disk space. All graphics will be compiled (and maybe the guru wants to talk also), so external files will be unneccesary. Requesters and gadgets will use reqtools.library - arp.library and extend.library will be replaced. The source for decoding guru's will be rewritten - it is too slow now! I've heard that the start of the program seems unlogical and confusing. People also seems to miss the mouse pointer. This will be fixed. Keyboard shortcuts will be added. I hope to write the next version in HiSoft Basic 2.0 - if HiSoft will ever get it released! Guarantee: No guarantee at all - sorry! I'm not sure if all the gurus in the program are correct - although I think so... Use the program at your own risk - I may not be responsible for any errors made to your system and/or (hard-) disks or damaged/overwritten files. I do not guarantee that this program will work on Amigas and/or setups or wb/ks not mentioned in this doc. Bug reports and suggestions are very welcome! I'll try to fix the program according to your wishes - just let me know! All people giving me gurus, valuable (HiSoft) Basic sources, bug reports and suggestions will get new versions of Guru-X as they are finished, and also new versions of all my other freeware-programs for free. If anyone wants to be a beta-tester on the Guru-X project, just let me know, and I will compile a special version to include all kinds of error messages. Basic programmers may be interrested in exchanging sources of various kinds.