

The DNS resolver software is in part based upon source that is 
 
   Copyright (c) 1985, 1988 Regents of the University of California.
   All rights reserved.
  
---------------------------------

How to install
==============

You CANNOT use this software with KA9Q. You require either Acorn TCP/IP
release 2 or 4 or FreeNet or ANT !InetSuite.

If you have FreeNet, then you should already have this module and
have configured it.  See !FreeNet.Docs.Resolver for more details.


For Acorn !Internet:

1) Extract the complete InetDB directory to your hard disc.

2) Read the file called 'Resolver'.  If you don't understand what
   this file is telling you to do, read the section at the end
   of this file instead.

3) Edit both of the files inside the 'files' subdirectory (resboot
   and resconf) as per the instructions in 'Resolver'.
   YOU CANNOT USE THEM WITHOUT EDITING THEM APPROPRIATELY FOR YOUR
   MACHINE.  The bits you need to edit are:  All of resboot; the
   domain and nameserver lines in resconf.
   
4) Copy the 'files' directory over the top of !Internet.files directory
   (which will merge the resboot and resconf with your !Internet files)

5) That's it :-)


For ANT !InetSuite:

1,2) As for Acorn

3) Edit ONLY resconf, and delete resboot.

4) Copy the files directory over the top of !InetSuite.Internet.Files
   directory will will merge the resconf with your InetSuite files/

5) As for Acorn :-)
   

----Alternate instructions from those given in 'Resolver'----


In the following instructions, lines beginning >> are my comments:
You cannot put these lines in resboot or resconf.

The following files are configured for my Risc PC, delenn, which is
in the ecs.soton.ac.uk domain, and has IP address 152.78.67.42
So the full machine name is delenn.ecs.soton.ac.uk

!Freeuser.files.resboot (or !Internet.files.resboot for Acorn TCP/IP)

$ORIGIN ecs.soton.ac.uk.
>> this line tells the resolver in which domain it is running.
>> Demon users should set it to demon.co.uk.
>>
>> >>>>>>> note the trailing dot at the end of the domain  <<<<<<<
>>
delenn		IN A 152.78.67.42
>>
>> format is: YourHostName IN A YourIpAddress
>> this instructs the resolver to add a permanent entry to the
>> lookup tables for your own host IN A == INternet Address
>>
42.67.78.152.in-addr.arpa.  IN PTR  delenn
>>
>> format is YourReversedIpAddress.in-addr.arpa. IN PTR YourHostName
>> this is used for looking up the name from the IP address
>> Note that the IP address is specified ***backwards*** here


!freeuser.files.resconf (or !Internet.files.resconf)

search ecs.soton.ac.uk
>>
>> should give the same domain name as the $ORIGIN line in resboot
>> You may use the 'domain' keyword instead.  Use search if unsure.
>>
cachesize	16k
>>
>> the size of the cache.  16K is ok.  Given that DNS cache entries
>> timeout after a while anyway, you don't need to increase this
>> (unless you do an awful lot of resolving)
>>
cacheload	resboot rescache
>>
>> leave this line alone.  it tells the resolver to load resboot and
>> then rescache when it first starts (or when you RMReinit InetDB)
>>
cachesave       rescache
>>
>> leave this line alone.  it tells the resolver where to store a
>> a copy of the cache on disc when it exits
>>
retry           1
>>
>> number of retries it will make when it fails to talk to a DNS
>> server.  SLIP users may wish to increase this to 3
>>
timeout         1 1
>>
>> timeout periods for retrying and moving through the list of
>> nameservers.  SLIP users may wish to increase this to 3 12
>> since lookups cannot be satisfied within the timeout of 1
>> second so easily with a 'slow' link.
>>
lookup          file bind
>>
>> when a query is made, this tells it to look in
>> inetdbase:hosts first, and then use the DNS protocols (bind).
>> This means that if you put frequently used hosts in your
>> hosts file, they will be resolved faster, and always resolve
>> (The problem is that if the host IP is changed, you will be
>> talking to the wrong machine, though).
>>
options         ndots 1
>>
>> leave this alone.  this tells the resolver that if it is asked
>> to lookup any host name with more than 1 dot in it, then it
>> should try to look it up as a complete name first, and only
>> if that fails, should it append the 'domain' or 'search' entry
>> to it.
>>
nameserver      152.78.66.136
nameserver      152.78.64.201
nameserver      152.78.128.128
>>
>> these three lines specify the DNS server IP addresses.
>> Format is:  nameserver NameServerIPAddress       They must
>> be specified as addresses.  The three I use are suitable only for
>> my domain (ecs.soton.ac.uk).  Demon users should set these to
>> 158.152.1.58  158.152.1.43  158.152.1.72   respectively.
>> Your service provider/network manager will be able to tell you 
>> these numbers.


----
Stewart Brodie
15th January 1996
