README.WRI - Host version 1.0.0 Beta


Introduction

Host is a Windows Sockets 1.1 compliant  32-bit Microsoft Windows
application that resolves host name and address information.  Given a
TCP/IP host name or address this program will return the hosts' official
name, alias name(s), and address(es).


Requirements

Host is a 32-bit Microsoft Windows application.  The following must be
installed and configured correctly in order for the application to work
properly.

Operating Systems (any one of the following)

Microsoft Windows 3.1x (with Win32s version 1.30 subsystem)
Microsoft Windows for Workgroups 3.1x (with Win32s version 1.30 subsystem)
Microsoft Windows NT 3.5x
Microsoft Windows 95

Note: if you are using Windows 3.1x or Windows for Workgroups 3.1x, you
must have Win32s version 1.30 or higher successfully installed on your
system for this program to work.  If you do not have Win32s, you can obtain
it from several popular anonymous FTP sites on the Internet as well as
other places.

Note: You should be able to obtain a copy of Win32s version 1.30 at the
following URL:
"ftp://ftp.microsoft.com/Softlib/mslfiles/pw1118.exe"

TCP/IP protocol stack

Any TCP/IP protocol stack with Windows Sockets 1.1 compliant winsock.dll.


Installation

1.   Create a directory on the drive that you would like the program files
     stored under (e.g. "C:\HOST").  This drive and directory will be
     referred to as "%host%".

2.   Copy "host100b.zip" to "%host%\host100b.zip".

3.   Extract and uncompress the archive contents by executing "pkunzip -d
     host100b.zip" from the "%host%" directory.

     Note: If you do not have "pkunzip.exe" version 2.04g, you can obtain
     it from several popular anonymous FTP sites on the Internet under the
     name "pkz204g.exe", as well as other places.  Also note that you must
     specify the "-d" option on the "pkunzip" command line to restore the
     directory tree properly.
     
     Note: You should be able to obtain a copy of PKUnzip version 2.04g at
     the following URL:
     "ftp://ftp.winsite.com/pub/pc/starter/pkz204g.exe"

Caution: For the steps marked with an * (asterisk), only perform the copy
operation if the file in the "%host%\redist" directory does not exist in
the destination directory or if it has a newer modified date.  Also, only
perform the steps for the specific system that you are using.

Note: The Windows root directory is referred to as "%systemroot%".  This is
usually "WINDOWS" for Windows, Windows for Workgroups, and Windows 95, and
"WINNT35" for Windows NT.

Note: The Windows system directory is referred to as "%system%".  This is
usually "SYSTEM" for Windows, Windows for Workgroups, and Windows 95, and
"SYSTEM32" for Windows NT.

For Windows 95 and Windows NT

4.   Copy "%host%\redist\win32\ctl3d32.dll" to
"%systemroot%\%system%\ctl3d32.dll".*

For Windows and Windows for Workgroups with Win32s

4.   Copy "%host%\redist\win32s\ctl3d32.dll" to
"%systemroot%\%system%\ctl3d32.dll".*


5.   The program should now be installed.  After you have run
     "%host%\host.exe", to verify that it has been installed properly, you
     can delete the "%host%\%redist%" directory and the archive file
     "host100b.zip".


Instructions

Type a TCP/IP host name or address in the "Name or Address" edit control
and select the "Resolve" button or provide a TCP/IP host name or address as
an argument to the program to retrieve the hosts' Official Name, Alias
Name(s), and Address(es).


Miscellaneous

Included Files

host100b.zip              PKZip 2.04g Archive

host.exe                  Host Name and Address Resolution Application
readme.wri                This File
redist\win32\ctl3d32.dll  3D Controls Dynamic Link Library (for Win32)
redist\win32s\ctl3d32.dll 3D Controls Dynamic Link Library (for
Win32s)

License

This software is freely distributable (although donations or feedback are
gladly accepted) under the following conditions:

1.   This "README.WRI" file is distributed with the contents of the
     archive.
2.   The software is not to be sold for profit.

Disclaimer

This software is provided as is.  Any expressed or implied warranties of
merchantibility and fitness for a particular purpose are disclaimed.  In no
event shall the author be liable for any direct, indirect, incidental,
special, exemplary, or consequential damages (including but not limited to,
procurement of substitute goods or services, loss of use, data, or profits,
or business interruption) however caused and on any theory of liability,
whether in contract, strict liability, or tort (including negligence or
otherwise) arising in any way out of the use of this software, even if
advised of the possibility of such damage.

Bug Reports

Please send any questions, suggestions, or bug reports to
"jemiller@tsrcom.com" with a subject line of "host-bugs".

Author

Jonathan Miller

Miller Software Development
jemiller@tsrcom.com
219-962-4576