home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / devtools / sniff16 / read.me
Encoding:
Text File  |  1993-10-27  |  5.0 KB  |  138 lines
  1.  
  2.  
  3.         Installing and Using The 16-Bit Sniffer Utility
  4.         ===================
  5.  
  6.         Evaluation Revision 0.5, September 30, 1993
  7.  
  8.  
  9.         1) DevCon will install, in your hard drive,
  10.            the 16-Bit Sniffer Utility.For simplicity,
  11.            assume that you wish to install the 16-Bit
  12.            Sniffer Utility in the D:\SNIFF16 directory.
  13.  
  14.         2) The SNIFF16 directory structure will be as follows:
  15.  
  16.  
  17.                . ─┐             Your current working directory
  18.                   │             (by example: D:\SNIFF16)
  19.                   │
  20.                   ├─── BIN      Sniff16 executable and message file
  21.                   │             README file
  22.                   │
  23.                   ├─── TESTAPP  Test application directory
  24.                   │
  25.                   │
  26.                   └─┬─ EPM      OS/2 Enhanced Editor binaries
  27.                     │
  28.                     ├──── DLL   OS/2 Enhanced Editor dynamic link libraries
  29.                     │
  30.                     │
  31.                     └──── HELP  OS/2 Enhanced Editor help
  32.  
  33.  
  34.         3) Your OS/2 CONFIG.SYS has to be updated as follows:
  35.  
  36.              a) Set up the OS/2 Enhanced Editor path in the following
  37.                 format:
  38.  
  39.           >     SET EPMPATH=xxxx\EPM
  40.  
  41.                 where "xxxx" refers to the base directory you've
  42.                 selected.  For example, if you used the 'D:\SNIFF16'
  43.                 directory to install the 16-Bit Sniffer Utility as
  44.                 illustrated, the statement would be:
  45.  
  46.                 SET EPMPATH=D:\SNIFF16\EPM
  47.  
  48.  
  49.              b) Update your PATH statement to indicate that executable
  50.                 files reside in the BIN and EPM directories. The format
  51.                 is:
  52.  
  53.           >     SET PATH=C:\OS2;C:\OS2\SYSTEM;xxxx\BIN;xxxx\EPM;
  54.  
  55.                 where "xxxx" refers to the base installation directory
  56.                 you've selected. The 'xxxx'\BIN and 'xxxx'\EPM directories
  57.                 are to be appended to your existing PATH.  For example:
  58.  
  59.                 SET PATH=C:\OS2;C:\OS2\SYSTEM;D:\SNIFF16\BIN;D:\SNIFF16\EPM;
  60.  
  61.  
  62.              c) Update your LIBPATH statement to reference the OS/2
  63.                 Enhanced Editor's DLLs.  The following form is used:
  64.  
  65.           >     LIBPATH=C:\OS2\DLL;C:\OS2\MDOS;C:\;xxxx\EPM\DLL;
  66.  
  67.                 For example:
  68.  
  69.                 LIBPATH=C:\OS2\DLL;C:\OS2\MDOS;C:\;D:\SNIFF16\EPM\DLL;
  70.  
  71.  
  72.              d) Update your DPATH statement to find the SNIFF.MSG
  73.                 file on you hard disk.  DPATH uses the form:
  74.  
  75.           >     SET DPATH=C:\OS2;C:\OS2\SYSTEM;xxxx\BIN;
  76.  
  77.                 For example:
  78.  
  79.                 SET DPATH=C:\OS2;C:\OS2\SYSTEM;D:\SNIFF16\BIN;
  80.  
  81.  
  82.              e) Update your HELP environment variable in CONFIG.SYS
  83.                 to reference the OS/2 Enhanced Editor help file.
  84.                 The HELP variable uses the form:
  85.  
  86.           >     SET HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;xxxx\EPM\HELP;
  87.  
  88.                 For example:
  89.  
  90.                 SET HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;D:\SNIFF16\EPM\HELP;
  91.  
  92.  
  93.              f) You may wish to insert a SNIFF16PATH line in CONFIG.SYS
  94.                 which points to the path that SNIFF16 will search for
  95.                 executable files (.exe), dynamic link libraries (.dll),
  96.                 and source (.c) files.  For example:
  97.  
  98.           >     SET SNIFF16PATH=D:\DEV\DLL;D:\DEV\CSOURCE;D:\DEV;C:\MYDLLS;
  99.  
  100.  
  101.         4) Once you've updated your CONFIG.SYS file, reboot OS/2 to
  102.            recognize the changes to CONFIG.SYS.
  103.  
  104.            To test the installation of SNIFF16, change to the TESTAPP
  105.            directory under the installation directory you've chosen.
  106.            For example:
  107.  
  108.                 D:
  109.                 CD \SNIFF16\TESTAPP
  110.  
  111.            Type:
  112.  
  113.                 SNIFF16 -e WORMS.EXE
  114.  
  115.            to SNIFF the WORMS application and bring up EPM to
  116.            guide you to each 16-bit call that SNIFF16 detected. Use
  117.            the ALT-N key to move to the next 16-bit call, ALT-P to
  118.            move to the previous 16-bit call, ALT-F1 while on the
  119.            line of any 16-bit call to bring up a message box which
  120.            may give an explanation of the potential problem, and
  121.            ALT-F4 to exit EPM.
  122.  
  123.            Source code has been included for the WORMS application,
  124.            which comes from the OS/2 2.1 Toolkit.  The Makefile
  125.            from the Toolkit has been modified to include symbolic
  126.            debug information in the executable, and is included
  127.            in the TESTAPP directory. To use SNIFF16's EPM editor
  128.            interface, it is necessary to include DEBUG information
  129.            in the application executable.  You may refer to the
  130.            WORMS makefile for the compiler and linker options used
  131.            to build the sample application.
  132.  
  133.            Please refer to the READ.ME file that was installed in the
  134.            BIN directory (under the 16-Bit Sniffer Utility directory
  135.            you've chosen) for additional details and options for the
  136.            tool.
  137.  
  138.