home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / os2trace.zip / stripapi.DOC < prev    next >
Text File  |  2001-01-10  |  3KB  |  69 lines
  1.  
  2.  
  3.           Operating System/2 API Trace Information File API Stripper
  4.  
  5.   Author       : Dave Blaschke
  6.                  IBM Austin, Texas
  7.                  Internal (Notes) - Dave Blaschke@IBMUS
  8.                  Internal (VM)    - IBMUSM26(BLASCHKE)
  9.                  External         - blaschke@us.ibm.com
  10.  
  11.   Description  : Strips API  entries and/or exits  from a trace  information
  12.                  file.
  13.  
  14.                  This feat is  accomplished by  processing each  line within
  15.                  the trace information file.  Whenever an API  entry/exit is
  16.                  encountered,  it is  dissected to  determine  which  API is
  17.                  being entered/exited.  If it is an entry/exit that does not
  18.                  match  the  requested  API,   the  complete  entry/exit  is
  19.                  displayed to standard output.
  20.  
  21.                  The user can  request to  strip API entries  from the trace
  22.                  information file by specifying the -ENTRY option.  The user
  23.                  can request to strip  API exits from the  trace information
  24.                  file by specifying the -EXIT  option.  The user can request
  25.                  to suppress displaying the program banner by specifying the
  26.                  -Q option.
  27.  
  28.                  The user can request helping  information by specifying the
  29.                  -?, -H, or -HELP option.
  30.  
  31.   Installation : Place the executable,  STRIPAPI.EXE,  in a directory  along
  32.                  the PATH environment variable.
  33.  
  34.   Usage        : STRIPAPI {-ENTRY|-EXIT}... [-Q] api file
  35.  
  36.                  Where:
  37.                    -ENTRY indicates strip API entries
  38.                    -EXIT  indicates strip API exits
  39.                    -Q     indicates suppress displaying banner
  40.                    api    indicates name of API to be stripped
  41.                    file   indicates name  of trace  information  file to  be
  42.                           stripped
  43.  
  44.                  In the following example,  all Dos32CreateQueue entries are
  45.                  stripped from TEST.TRC:
  46.  
  47.                  STRIPAPI -ENTRY DOS32CREATEQUEUE TEST.TRC
  48.  
  49.                  In  the  following  example,  the  program  banner  is  not
  50.                  displayed and all Dos32CreateQueue  exits are stripped from
  51.                  TEST.TRC:
  52.  
  53.                  STRIPAPI -EXIT -Q DOS32CREATEQUEUE TEST.TRC
  54.  
  55.                  In the following example,  all Dos32CreateQueue entries and
  56.                  exits are stripped from TEST.TRC:
  57.  
  58.                  STRIPAPI -ENTRY -EXIT DOS32CREATEQUEUE TEST.TRC
  59.  
  60.   Output       : The contents of the  trace information file  minus the  API
  61.                  entries and/or exits.
  62.  
  63.   History      : Version Date    Item
  64.                  2.45.25 03Jun00 Added trace information file API stripper
  65.  
  66.   Please direct all comments,  problems,  questions,  and suggestions to the
  67.   author above, or, if undeliverable, to deblaschke@yahoo.com.
  68.  
  69.