This archive contains the following files:
     readme.txt      This file
     ethrhost.exe    The executable
     subnets         Sample subnets file
     hosts           Sample hosts file
     ethers          Sample ethers file
     hostethr.txt    Sample output file
     bootp.ace       Sample output file for use with ulist5

Ethrhost is a utility that I wrote to combine the information from Unix style 
hosts and ethers files into one file.  As the network manager for a LAN
connected to the internet through another site.  I don't have those files on
our system and must communicate with the other site to have updates made.  I
was constantly having to download the files, then go through them to locate
our IP addresses, then have to cross-reference with the ethernet addresses.
I finally decided there must be an easier way to extract the information I
was interested in.  Ethers/hosts outputs a file (hostethr.txt) with IP
addresses, host name, and the ethernet address for selected sub-nets.  I hope
others in similar situations will find this program useful.

After downloading the program ulist and seeing what it could do, I modified 
ethrhost so that it would also output the file bootp.ace used by ulist.  
With the bootp.ace file, ulist will display IP addresses for logged in users 
rather than the ethernet address.  Thanks to Marius van Wyk for this handy 
utility.

The files necessary to run ethrhost MUST be located in f:\etc.  Output files 
are also placed in f:\etc.  Following is a description of each input and 
output file:

Input files:

subnets  --  This file contains the list of subnets that you want to parse 
	     for.  Any line beginning with the # character is considered a 
	     comment and will not be parsed.  Place the subnet IP address for 
	     each subnet you wish included in the output files on a single 
	     line. Subnet IP addresses must be in the form xxx.xxx.xxx.  See 
	     the included sample subnets file.

hosts    --  Unix style hosts file.  Any line beginning with the # character 
	     is considered a comment and will not be parsed.  Each line to 
	     be parsed contains the full IP address followed by any number 
	     of spaces and/or tabs followed by the host name and any aliases.
	     Note that only the first 30 characters of the host name are 
	     parsed.  See the included sample hosts file.

ethers   --  Unix style ethers file.  Any line beginning with the # character 
	     is considered a comment and will not be parsed.  Each line to be 
	     parsed contains the ethernet address in the form 
	     xx:xx:xx:xx:xx:xx followed by any number of spaces and/or tabs 
	     followed by the host name and any aliases.  Note that only the 
	     first 30 characters of the host name are parsed.  See the 
	     included sample ethers file.

Output files:

hostethr.txt  --  This file contains all of the IP addresses parsed from the 
		  hosts and ethers files that are in the subdomains listed in 
		  the subnets file.  Each line contains an IP address 
		  followed by the host name followed by the ethernet address, 
		  all in ASCII format.  For purposes of importing into a 
		  database application, each field is a fixed length of 
		  characters.  The first 18 characters is the IP address, the 
		  next 30 characters is the host name and alias if any, and 
		  the last 17 characters is the ethernet address.

bootp.ace     --  This files is in a form usable by ulist.  The format used 
		  is host-name <tab> Ethernet (literally) <tab> Ethernet 
		  address <tab> IP address <tab> #IP address.  The #IP 
		  address tells ulist to display IP address instead of 
		  ethernet address in it's output.
	
	Ethrhost.exe is copyright 1995 by Stanley R. McCann.  
	Ethrhost.exe is being distributed as freeware and is freely
	distibutable but I do retain all rights to the program.


	Send bug reports and/or comments to stan@nmsua.nmsu.edu.

Enjoy!
