Tinfo - A task info utility by Heiko Rath ========================================= ****************** *The legal status* ****************** This program is Copyright © 1988 by Heiko Rath and The Software Brewery. It may be freely distributed for non-profit only. The distribution must contain ALL parts, in this case the following files: Tinfo Tinfo.doc Putting it on a commercial product is usually as easy as sending a letter to the author. ****************************** *What's Tinfo supposed to do?* ****************************** It's supposed to give you a lot of infos on tasks and AmigaDOS processes. You can think of Tinfo as an extremly powerful status command. ***************** *What's the use?* ***************** It depends if you're a user or a programmer. If you're only a user then I guess you won't have a big use of Tinfo, though you might use it as an expanded status command. If you're into programming your Amiga, then some of the outputs might be familiar and useful to debug your programs or just to understand the internal interactions of the OS. ******************* *How can I use it?* ******************* Tinfo is a CLI only program, if you start it from the Workbench then it'll tell you to try again from CLI. If you're unfamiliar with the CLI then I'd propose to read the AmigaDOS user's manual or something the like. The syntax is easy: * *Use TInfo without argument to display a list of all tasks. * This will output something like this: TaskReadyList Address Type Pri IDN TDN Num ------------------------------------------------------------ TaskName $00000000 000 000 000 000 00000 TaskWaitingList Address Type Pri IDN TDN Num ------------------------------------------------------------ TaskName $00000000 000 000 000 000 00000 where TaskName is the name of the task Address is the address of the TaskStructureNode Type is the type of the task (13=process, 1=task) Pri is the priority of the task IDN is the InterruptDisableCounter TDN is the TaskDisableCounter Num is the number of the CLI process or 0 if it's not a CLI process. * *Use TInfo "name" to display infos about a task or command. * Tinfo will look for an entry with given name in the TaskReady- and Task- WaitingList. If there isn't such a task, then it scans the DOS process- table for a process with the given command name. You might get something like this: Taskname : "Background CLI" Address : $00293D08 Priority : 000 Typ : Process State : Waiting Flags : %00000000 IDNestCnt : 000 TDNestCnt : 255 SigAlloc : %10000000000000001111111111111111 SigWait : %10000000000000000000000000000000 SigRecvd : %00000000000000000000000000000000 SigExcept : %00000000000000000000000000000000 TrapAlloc : $8000 TrapAble : $0000 SPReg : $002741DE SPLower : $00293DC4 SPUpper : $00294A44 ExceptData : $00000000 ExceptCode : $00FC2FF0 TrapData : $00000000 TrapCode : $00FF47EA UserData : $00000000 MemEntry : $00293D52 Infos available only for Processes: ----------------------------------- MsgPortName: No Name Flags : %00000000 SigBit : 008 SigTask : $00293D08 Head : $00293D7C TailPred : $00293D78 SegList :*$0021F9EC StackSize : $00000C80 GlobVec : $00203520 TaskNum : $00000008 StackBase :*$00293DC4 Result2 : $00000000 CurrentDir :*$0022C35C CIS :*$002038F4 COS :*$00203924 CLI :*$00293F38 ReturnAddr : $00274238 PktWait : $00000000 WindowPtr : $00000000 ConsoleTask: $00000000 FileSystemTask: $0020471C Infos available only for CLI-Processes: --------------------------------------- CommandName:*"c:AntiVirusIV" SetName :*"RAM:" Prompt :*"%N> " CommandFile:*No Name Result2 : $00000000 StandardInput :*$0022C2FC ReturnCode : $00000000 CurrentInput :*$0022C2FC FailLevel : $0000000A StandardOutPut:*$0022C374 Module :*$0022BE8C CurrentOutput :*$0022C374 Background : $FFFFFFFF Interactive : $00000000 CommandDir :*$00000000 DefaultStack : $00000FA0 To get an explanation of all these entries look into your include files or grab a Rom Kernel manual and look them up. Entries marked with an '*' are BPtrs which are converted to normal APtrs. * *Use TInfo -P to display a list of the CLI processes. * You might get something that looks like this: Process 2: stk 20000, gv 150, pri 0, commandname: tinfo Process 4: stk 4000, gv 150, pri 0, commandname: c:faccii Process 5: stk 4000, gv 150, pri 20, commandname: c:mclk Process 8: stk 4000, gv 150, pri 0, commandname: c:AntiVirusIV where stk is the stacksize of the process gv is the global vector of the process pri is the priority of the process * *Use TInfo -Haddress to display infos about a task or command. * This is the same as Tinfo "name" except that you don't enter the name of the task or process, but the address. This is useful, if there are several tasks with the same name (e.g. trackdisk.device). The address must be hexadecimal!!! * *Use TInfo -Nnumber to get infos on a certain CLI process. * This gives the same output as Tinfo "name", but you enter only the CLI- processnumber. * *Use TInfo -A to read some messages from the author. * This will output all the stuff I could need, so if you feel like having to much money and are willing to share some of it with me, I would appreciate it. But you don't have to send me anything, I would also be pleased just to get some comments, flames or critisms on Tinfo. :-) * *Use TInfo -T to see thanks to important people. * This will output thanks to some people, groups and my favourite beer breweries. *********************************************** *How can I thank Heiko for his genius program?* *********************************************** Well, just read the messages that Tinfo displays whenever it's started with the -A option, then you should know how to please me. Tinfo is a combined effort of Heiko Rath and The Software Brewery ______ / ______\O - The Software Brewery - \\ o Sparkling, fresh software from West=Germany @@@@@ Straight from the bar to your Amiga |~~~|\ | | |/ |___| With our regards to the Software Distillery Christian Balzer alias , Lattice C, user interfaces, beer addict. Heiko Rath alias
, Assembler, ROM-Kernal stuff, Marabou & beer addict. Ralf Woitinas alias RAF, Assembler, anything, Ray-Tracing addict. Andrew Kopp alias Charlie, Aztec C, Hardware & communications, beer addict. Armin Sparr alias MARVIN, Aztec C, ARexx macros, Campari addict. Christof Bonnkirch alias KEY, Aztec C, Hardware & Devices, beer adict. Beverages: Altenmuenster Brauer Bier, Urfraenkisches Landbier, Jever. Send exotic drinks, comments, flames to: The Software Brewery Christian Balzer UUCP: decwrl!frambo.dec.com!schabacker Im Wingertsberg 45 ARPA: schabacker@frambo.dec.coms D-6108 Weiterstadt CIS : 71001,210 (be brief!) West Germany (F.R.G.) Fone: +49 6150 4151 (18:00-21:00 CET!) Send the above stuff, beautiful girls and of course MARABOU-CHOCOLATE to: Heiko Rath (HHHEEELLLPPP, I'm running out of MARABOU chocolate!!!!!!!) Raiffeisenstr.10a D-6108 Weiterstadt WEST GERMANY (F.R.G.) Doctor, Doctor, please help me my brain hurts. Well, maybe you've been staring at BPTRs to long!?