home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 199.lha / Tinfo.doc < prev    next >
Encoding:
Text File  |  1988-12-28  |  7.5 KB  |  213 lines
  1.         Tinfo - A task info utility by Heiko Rath
  2.         =========================================
  3.     
  4. ******************
  5. *The legal status*
  6. ******************
  7. This program is
  8.  
  9. Copyright © 1988 by Heiko Rath and The Software Brewery.
  10.  
  11. It may be freely distributed for non-profit only.
  12. The distribution must contain ALL parts, in this case the following
  13. files:
  14.  
  15. Tinfo
  16. Tinfo.doc
  17.  
  18. Putting it on a commercial product is usually as easy as sending
  19. a letter to the author.
  20.  
  21. ******************************
  22. *What's Tinfo supposed to do?*
  23. ******************************
  24. It's supposed to give you a lot of infos on tasks and AmigaDOS processes.
  25. You can think of Tinfo as an extremly powerful status command.
  26.  
  27. *****************
  28. *What's the use?*
  29. *****************
  30. It depends if you're a user or a programmer. If you're only a user
  31. then I guess you won't have a big use of Tinfo, though you might use
  32. it as an expanded status command. If you're into programming your Amiga,
  33. then some of the outputs might be familiar and useful to debug your
  34. programs or just to understand the internal interactions of the OS.
  35.  
  36. *******************
  37. *How can I use it?*
  38. *******************
  39. Tinfo is a CLI only program, if you start it from the Workbench then it'll
  40. tell you to try again from CLI. If you're unfamiliar with the CLI then
  41. I'd propose to read the AmigaDOS user's manual or something the like.
  42. The syntax is easy:
  43.  
  44. *
  45. *Use TInfo without argument to display a list of all tasks.
  46. *
  47. This will output something like this:
  48.  
  49. TaskReadyList                 Address Type Pri IDN TDN  Num
  50. ------------------------------------------------------------
  51. TaskName                     $00000000 000 000 000 000 00000
  52.  
  53. TaskWaitingList               Address Type Pri IDN TDN  Num
  54. ------------------------------------------------------------
  55. TaskName                     $00000000 000 000 000 000 00000
  56.  
  57. where
  58.  TaskName is the name of the task
  59.  Address is the address of the TaskStructureNode
  60.  Type is the type of the task (13=process, 1=task)
  61.  Pri is the priority of the task
  62.  IDN is the InterruptDisableCounter
  63.  TDN is the TaskDisableCounter
  64.  Num is the number of the CLI process or 0 if it's not a CLI process.
  65.  
  66. *
  67. *Use TInfo "name" to display infos about a task or command.
  68. *
  69. Tinfo will look for an entry with given name in the TaskReady- and Task-
  70. WaitingList. If there isn't such a task, then it scans the DOS process-
  71. table for a process with the given command name.
  72. You might get something like this:
  73.  
  74. Taskname   : "Background CLI"
  75. Address    : $00293D08         Priority      : 000
  76. Typ        : Process           State         : Waiting  
  77. Flags      : %00000000
  78. IDNestCnt  : 000               TDNestCnt     : 255
  79. SigAlloc   : %10000000000000001111111111111111
  80. SigWait    : %10000000000000000000000000000000
  81. SigRecvd   : %00000000000000000000000000000000
  82. SigExcept  : %00000000000000000000000000000000
  83. TrapAlloc  : $8000             TrapAble      : $0000
  84. SPReg      : $002741DE
  85. SPLower    : $00293DC4         SPUpper       : $00294A44
  86. ExceptData : $00000000         ExceptCode    : $00FC2FF0
  87. TrapData   : $00000000         TrapCode      : $00FF47EA
  88. UserData   : $00000000         MemEntry      : $00293D52
  89.  
  90. Infos available only for Processes:
  91. -----------------------------------
  92. MsgPortName: No Name
  93. Flags      : %00000000         SigBit        : 008
  94. SigTask    : $00293D08
  95. Head       : $00293D7C         TailPred      : $00293D78
  96. SegList    :*$0021F9EC         StackSize     : $00000C80
  97. GlobVec    : $00203520         TaskNum       : $00000008
  98. StackBase  :*$00293DC4         Result2       : $00000000
  99. CurrentDir :*$0022C35C
  100. CIS        :*$002038F4         COS           :*$00203924
  101. CLI        :*$00293F38         ReturnAddr    : $00274238
  102. PktWait    : $00000000         WindowPtr     : $00000000
  103. ConsoleTask: $00000000         FileSystemTask: $0020471C
  104.  
  105. Infos available only for CLI-Processes:
  106. ---------------------------------------
  107. CommandName:*"c:AntiVirusIV"
  108. SetName    :*"RAM:"
  109. Prompt     :*"%N> "
  110. CommandFile:*No Name
  111. Result2    : $00000000         StandardInput :*$0022C2FC
  112. ReturnCode : $00000000         CurrentInput  :*$0022C2FC
  113. FailLevel  : $0000000A         StandardOutPut:*$0022C374
  114. Module     :*$0022BE8C         CurrentOutput :*$0022C374
  115. Background : $FFFFFFFF         Interactive   : $00000000
  116. CommandDir :*$00000000         DefaultStack  : $00000FA0
  117.  
  118. To get an explanation of all these entries look into your include files
  119. or grab a Rom Kernel manual and look them up. Entries marked with an '*'
  120. are BPtrs which are converted to normal APtrs.
  121.  
  122. *
  123. *Use TInfo -P to display a list of the CLI processes.
  124. *
  125. You might get something that looks like this:
  126.  
  127. Process 2: stk 20000, gv 150, pri 0, commandname: tinfo
  128. Process 4: stk 4000, gv 150, pri 0, commandname: c:faccii
  129. Process 5: stk 4000, gv 150, pri 20, commandname: c:mclk
  130. Process 8: stk 4000, gv 150, pri 0, commandname: c:AntiVirusIV
  131.  
  132. where
  133. stk is the stacksize of the process
  134. gv  is the global vector of the process
  135. pri is the priority of the process
  136.  
  137. *
  138. *Use TInfo -Haddress to display infos about a task or command.
  139. *
  140. This is the same as Tinfo "name" except that you don't enter the name
  141. of the task or process, but the address. This is useful, if there are
  142. several tasks with the same name (e.g. trackdisk.device). The address
  143. must be hexadecimal!!!
  144.  
  145. *
  146. *Use TInfo -Nnumber to get infos on a certain CLI process.
  147. *
  148. This gives the same output as Tinfo "name", but you enter only the CLI-
  149. processnumber.
  150.  
  151. *
  152. *Use TInfo -A to read some messages from the author.
  153. *
  154. This will output all the stuff I could need, so if you feel like having to
  155. much money and are willing to share some of it with me, I would appreciate
  156. it. But you don't have to send me anything, I would also be pleased just
  157. to get some comments, flames or critisms on Tinfo. :-)
  158.  
  159. *
  160. *Use TInfo -T to see thanks to important people.
  161. *
  162. This will output thanks to some people, groups and my favourite beer 
  163. breweries.
  164.  
  165. ***********************************************
  166. *How can I thank Heiko for his genius program?*
  167. ***********************************************
  168. Well, just read the messages that Tinfo displays whenever it's started with
  169. the -A option, then you should know how to please me.
  170.  
  171.  
  172.  
  173. Tinfo is a combined effort of Heiko Rath and The Software Brewery
  174.  
  175.  
  176. ______  /          
  177. ______\O                     - The Software Brewery - 
  178.       \\ 
  179.        o           Sparkling, fresh software from West=Germany
  180.           
  181.      @@@@@             Straight from the bar to your Amiga
  182.      |~~~|\ 
  183.      | | |/ 
  184.      |___|        With our regards to the Software Distillery
  185.  
  186. Christian Balzer alias <CB>, Lattice C, user interfaces, beer addict. 
  187. Heiko Rath alias <HR>, Assembler, ROM-Kernal stuff, Marabou & beer addict. 
  188. Ralf Woitinas alias RAF, Assembler, anything, Ray-Tracing addict.
  189. Andrew Kopp alias Charlie, Aztec C, Hardware & communications, beer addict.
  190. Armin Sparr alias MARVIN, Aztec C, ARexx macros, Campari addict.
  191. Christof Bonnkirch alias KEY, Aztec C, Hardware & Devices, beer adict.
  192.  
  193. Beverages: Altenmuenster Brauer Bier, Urfraenkisches Landbier, Jever.
  194.  
  195. Send exotic drinks, comments, flames to:
  196.  
  197. The Software Brewery    
  198. Christian Balzer        UUCP: decwrl!frambo.dec.com!schabacker
  199. Im Wingertsberg 45        ARPA: schabacker@frambo.dec.coms
  200. D-6108 Weiterstadt        CIS : 71001,210 (be brief!)
  201. West Germany (F.R.G.)        Fone: +49 6150 4151 (18:00-21:00 CET!)
  202.  
  203. Send the above stuff, beautiful girls and of course MARABOU-CHOCOLATE to:
  204.  
  205. Heiko Rath (HHHEEELLLPPP, I'm running out of MARABOU chocolate!!!!!!!)
  206. Raiffeisenstr.10a
  207. D-6108 Weiterstadt
  208. WEST GERMANY (F.R.G.)
  209.  
  210.  
  211. Doctor, Doctor, please help me my brain hurts.
  212. Well, maybe you've been staring at BPTRs to long!?
  213.