STelSock - SSL Telnet Windows Sockets
             Version 0.3.3 Mar 2, 1999
             Copyright (C) 1996-1999 NEC Corporation
             All rights reserved.


Table of contents
  1. Description
  2. Disclaimer
  3. Distribution Packge
  4. Installation
  5. Other features
  6. Bug reports, suggestions, ...


1. Description
  STelSock is a 32bit Windows Sockets DLL that makes TELNET applications
  possible to communicate with SSL telnetd. STelSock encrypts/decrypts the
  data for TELNET applications.


2. Disclaimer
  1. This software may be used without fee.
  2. NEC Corporation accepts no responsibility for damages resulting from
     the use of this software and makes no warranty.
  3. You must not sell this software package.
  4. You can redistribute this package as long as you don't modify any of
     files in this package and you deliver all the files in this package.


3. Distribution package
  These files are included in this distribution package.
    o wsock32.dll       STelSock program file for SSLeay Ver.0.8.x
    o wsock32.dll.06x   STelSock program file for SSLeay Ver.0.6.x
    o readme.txt        Release Note
    o src.zip           source files of STelSock


4. Installation
  1. Install an application to be used with STelSock in a directory.

  2. Copy wsock32.dll(STelSock) in the directory in which the executable file
     exists. If you use SSLeay Ver.0.6.x, use wsock32.dll.06x as wsock32.dll.
     STelSock is a wrapper for either ws_stel.dll or the original winsock dll
     stored in the system directory.

  3. Install SSLeay
    STelSock uses SSLeay library. Install the SSLeay 32bit DLL.
      - For SSLeay Ver.0.6.x
        1. Get SSLeay-0.6.x.tar.gz from <ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL/>
        2. Build Crypt32.DLL and SSL32.DLL
        3. Copy both of Crypt32.DLL and SSL32.DLL to the directory in which
           STelSock was installed.
        4. If MSVCRT.DLL does not exist in the PATH, copy MSCVRT40.DLL as
           MSCVRT.DLL.

      - For SSLeay Ver.0.8.x or later
        1. Get SSLeay-0.8.x.tar.gz from the above URL.
        2. Build Libeay32.DLL and SSLeay32.DLL
        3. Copy both of Libeay32.DLL and SSLeay32.DLL to the directory in
           which STelSock was installed.
        4. If MSVCRT.DLL does not exist in the PATH, copy MSCVRT40.DLL as
           MSCVRT.DLL.

  4. Change the registory as follows
     Key:
        - For Windows 95 (if you use Windows95 B or later, you needn't change.)
            HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\VxD\MSTCP
            \ServiceProvider
        - For Windows NT 3.5x
            HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip
            \ServiceProvider
     Name:  ProviderPath (REG_SZ)
     Value: wsock32.dll

  5. Setting options
     Some options can be set for each applications.
       Key:   HKEY_CURRENT_USER\Software\NEC\WinSock\STelSock
       Name:  Full path and filename for the executable file.
       Value: (REG_DWORD)
              0             8             16            24            32bit
              +------+------+------+------+------+------+------+------+
              |  --  |  --  |  --  |ErrMsg|NotSnd|VrfyDp|  --  |NgType|
              +------+------+------+------+------+------+------+------+
              o ErrMsg - Display Error Mssage
                   If ErrMsg is non-zero, splash dialog box is displayed
                   for ErrMsg (sec).
              o NotSnd - Not send certificate file
                   If NotSnd is non-zero, certificate file is not sent
                   to the peer.
              o VrfyDp - Verify depth
              o NgType - Negotiation type
                   0 - SSL telnet negotiation (default).
                   1 - SSL ftp negotiation.
                   2 - SSL only except SMTP(25) and POP(110).
       ex.) 0x30102 : Error message for 3 (sec), verify the peer and SSL only.

  6. Setting certificate files
     The certification files can be set.
       Key:   HKEY_CURRENT_USER\Software\NEC\WinSock\STelSock\certs
       Name:  cert_file (REG_SZ) Full path and filename of certificate file
              key_file  (REG_SZ) Full path and filename of private key file
                                 A Passphrase input dialog pops up when the
                                 passphrase is required.
              CAfile    (REG_SZ) Full path and filename of CA
              CApath    (REG_SZ) Full path of CA


5. Other features
  o Using with otpsock
      Rename wsock32.dll of STelSock to ws_otp.dll and copy wsock32.dll of
      otpsock in the directory in which STelSock was installed.
  o Using with Hummingbird Socks V4 Winsock
      Rename wsock32.dll of Socks Winsock to ws_stel.dll and wsock32.dll of
      original Winsock to wsock32o.dll. And copy both files in the directory
      in which stelsock was installed.


6. Bug reports, suggestions, ...
  Please let me know, if you find any bugs or have any suggestions.
  E-Mail: pochi@ccs.mt.nec.co.jp


Master site:
  <http://tama.gate.nec.co.jp/so/>
  <ftp://ftp.nec.co.jp/pub/packages/sotools/>
Mirror sites:
  <ftp://ftp.win.ne.jp/pub/network/security/sotools/>
  <ftp://starbow.st.ryukoku.ac.jp/pub/security/tool/sotools/>


Windows and WindowsNT are registered trademarks of Microsoft Corporation.