home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Elysian Archive
/
AmigaElysianArchive.iso
/
printer
/
tinfo.lha
/
Tinfo.doc
< prev
Wrap
Text File
|
1988-12-07
|
8KB
|
213 lines
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 <CB>, Lattice C, user interfaces, beer addict.
Heiko Rath alias <HR>, 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!?