home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / os2trace.zip / CHK4TRC.DOC next >
Text File  |  2001-01-10  |  4KB  |  91 lines
  1.  
  2.  
  3.             Operating System/2 API Trace-enabled Executable Checker
  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  : Checks  for and  reports the  executable  file(s)  that are
  12.                  trace-enabled.
  13.  
  14.                  This feat is  accomplished by processing  each entry in the
  15.                  table  of  strings  within   the  executable  file(s)  that
  16.                  contains  the names  of the  imported DLLs.  If  the  entry
  17.                  represents one of the trace DLLs,  the executable file name
  18.                  is displayed to standard output.
  19.  
  20.                  The user can request  to display the DLLs  that are enabled
  21.                  for tracing in the executable  file(s) by specifying the -D
  22.                  option.  The user can  request to also check the executable
  23.                  file(s) in any subdirectories by specifying the -S option.
  24.  
  25.                  The user can request helping  information by specifying the
  26.                  -?, -H, or -HELP option.
  27.  
  28.   Installation : Place the executable, CHK4TRC.EXE, in a directory along the
  29.                  PATH environment variable.
  30.  
  31.   Usage        : CHK4TRC [-D] [-S] file
  32.  
  33.                  Where:
  34.                    -D   indicates display DLLs enabled for tracing
  35.                    -S   indicates check subdirectories
  36.                    file indicates name of  executable file(s)  to be checked
  37.                         (can include global file name characters * and ?)
  38.  
  39.                  In the following example, all DLLs in the current directory
  40.                  are checked:
  41.  
  42.                  CHK4TRC *.DLL
  43.  
  44.                  In the  following  example,  all  executable  files  in the
  45.                  C:\OS2 directory and its subdirectories are checked:
  46.  
  47.                  CHK4TRC -S C:\OS2
  48.  
  49.                  In the following example,  TEST.EXE is checked and any DLLs
  50.                  enabled for tracing are displayed:
  51.  
  52.                  CHK4TRC -D TEST.EXE
  53.  
  54.   Output       : Information similar to the following is displayed if any of
  55.                  the executable files are trace-enabled:
  56.  
  57.                  Trace-enabled executable file(s):
  58.                    filename
  59.                       :
  60.                    filename
  61.  
  62.                  n executable files checked
  63.                  n trace-enabled executable files found
  64.  
  65.                  If the  user  requests  the  display  of DLLs  enabled  for
  66.                  tracing,  information similar to the following is displayed
  67.                  if any of the executable files are trace-enabled:
  68.  
  69.                  Trace-enabled executable file(s):
  70.                    filename (DLLNAME,DLLNAME)
  71.                       :
  72.                    filename (DLLNAME)
  73.  
  74.                  n executable files checked
  75.                  n trace-enabled executable files found
  76.  
  77.                  Information similar  to the following  is displayed if none
  78.                  of the executable files are trace-enabled:
  79.  
  80.                  n executable files checked
  81.                  0 trace-enabled executable files found
  82.  
  83.   History      : Version Date    Item
  84.                  2.40.57 25Jun98 Added trace-enabled executable checker
  85.                  2.40.86 03Mar99 Added support  for executables  without DOS
  86.                                  header
  87.  
  88.   Please direct all comments,  problems,  questions,  and suggestions to the
  89.   author above, or, if undeliverable, to deblaschke@yahoo.com.
  90.  
  91.