home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / tracef.zip / tracefuse.txt < prev   
Text File  |  2002-06-22  |  2KB  |  52 lines
  1. TraceFilter 0.7 reads formatted trace data saved by TRACEFMT, and
  2. creates an output file which either includes or excludes events based
  3. on process ids, major event codes, and CASE-SENSITIVE strings.
  4.  
  5. Each parameter is processed as follows:
  6. Special processing is done based on the first character.
  7.   if '?', you get this help.
  8.   if '=', the rest is a string which must be in the event.
  9.   if '!', the rest is a string which must NOT be in the event.
  10.   if '-' or '/', the parameter is NOT a filename.
  11.  
  12. The first parameter not already explained is the input file name.
  13. The default input file is "TRACEFMT.SAV"  .
  14. The second parameter not already explained is the output file name.
  15. The default is stdout, and is redirectable. Once the input and
  16. output files have been named, you no longer need '-' or '/'.
  17. You may (Include or EXclude) (processes and/or event codes),
  18. but using both Include and EXclude for either one is invalid.
  19. Parameter position 1 is the include/exclude flag.
  20. To include, use 'i'; to exclude, use either 'e' or 'x'.
  21. Parameter position 2 is the process/major code flag.
  22. For processes, use 'p'; for major event codes, use 'm'.
  23. Parameter position 3 is where the hex number begins.
  24. Examples follow, please press enter.TRACEF -IPC /IPD -IPE >MYFILE
  25. Input file is 'TRACEFMT.SAV', output file is MYFILE (created);
  26. output contains only events from processes 12,13,14 (decimal).
  27.  
  28. TRACEF tracefmt.sav myfile ipd ip0000e ipc      same as above.
  29.  
  30. TRACEF what.now -IPC /IPD -IPE MYFILE
  31. Input file is 'what.now', output file is MYFILE (created);
  32.  
  33. TRACEF /xp2c -im10
  34. Input is TRACEFMT.SAV, output is stdout, and includes only major
  35. event 16 (decimal) for all processes except 44 (decimal).
  36.  
  37. TRACEF =Protection
  38. Output has only those events which contain
  39. the case-sensitive string "Protection".
  40.  
  41. Program logic follows here:
  42.  
  43. The program logic is first to find out if the event is excluded
  44. by PID, major code, or negative string. If excluded, no output.
  45. Next, if "include" is specified, and the reason for inclusion
  46. is not in this event, try the next event.
  47. Last, if no decision is yet made, output the event.
  48. Note: lines longer than 255 characters are not processed properly.
  49. Note: you may specify up to 16 PIDs, 16 Major codes,
  50. 16 positive and 16 negative strings.
  51. Experimentation with known data is recommended.
  52.