home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / program / tostrace / tostrace.doc < prev    next >
Text File  |  1989-12-12  |  3KB  |  59 lines
  1.  
  2.            TOS TRACE TOOL - A shareware TOS system call trace program
  3.                             by Leo de Wit
  4.  
  5.  
  6.             TOS TRACE TOOL is a tool intended for ST hackers/programmers
  7.         to be able to trace (some of) the ST system calls. It catches
  8.         the GEM/GEMDOS/BIOS/XBIOS/LineA exceptions to do so (only GEMDOS
  9.         and the traps that are/have been traced, are intercepted). Of
  10.         course you can use a debugger to do the same, but I doubt it is
  11.         as easy to use.
  12.  
  13.             The trace output is presented on a separate screen, to which
  14.         you can switch back and forth using the Control-Enter key. This
  15.         output consists of the function called, with its arguments
  16.         displayed in hex. Some arguments, like the pathname in GEMDOS
  17.         Fopen(), is displayed as an ASCII string. The VDI functions are
  18.         'translated to C-usage', that is: VDI (and AES) is presented as
  19.         if the functions were system calls (though they really are
  20.         library function bindings to a lower level interface).
  21.             Output variables are marked accordingly (==>), but their
  22.         value is not given; some functions can take indefinitely to
  23.         finish (e.g. Pexec()), and it would also require to trap the
  24.         calls on exit as well (they're now trapped on entrance only).
  25.         (If this is a must, or alternatively the function's return
  26.         value is needed, I will look into that).
  27.             The trace screen is not scrolled, but wrapped to the top;
  28.         this is less tiresome for the eyes to follow. The last function
  29.         that was traced is the one above the empty line(s).
  30.  
  31.             So far all is being handled by the TOSTRACE.PRG TSR
  32.         program. The en-/disabling of specific functions is performed
  33.         by the SETTRACE.PRG program. It is possible to install
  34.         TOSTRACE.PRG by hand (or in your \AUTO folder), but SETTRACE.PRG
  35.         will install it if it isn't already present. One drawback:
  36.         SETTRACE.PRG currently looks only in the current directory for
  37.         a copy of TOSTRACE.PRG.
  38.             You can select one of the 'system call classes', as
  39.         represented in the middle upper block of the SETTRACE form;
  40.         the functions belonging to that class will be displayed with
  41.         their current trace status (tracing is marked with a 'check'
  42.         symbol). VDI has been split in two; there are so many of those.
  43.             Clicking on them toggles the trace status; note it is
  44.         only really set/reset when you switch to a different class or
  45.         exit, and you confirm the 'save' question. Clicking on Set
  46.         resp. Clear sets resp. clears all trace settings of the current
  47.         system call class.
  48.  
  49.             A lot of functions have been tested (traced), but there
  50.         will probably remain a lot of untested ones (or tested under
  51.         different conditions). I'm always willing to implement
  52.         reasonable suggestions for improvement, if I can find the
  53.         time, and feel like it (hey, this is a hobby :-).
  54.  
  55.         Enjoy!
  56.  
  57.             Leo.
  58.  
  59.