HOW TO USE DOMTOOLS
		        HIGH-LEVEL NAME SERVER QUERY TOOLS
				  Version 1.6.0
				   11/21/2000
		        Copyright (c) 1993 by Paul A. Balyoz


Here are some examples of how to use this package.  All examples are
written for Bourne Shell; modify as appropriate for your favorite shell.


1. WHAT ARE ALL THE IP ADDRESSES OF yahoo.com?

	address yahoo.com.

2. WHAT ARE THE TXT RECORDS, IF ANY, FOR gopher.nau.edu.?

	txt gopher.nau.edu.

3. IF I SENT MAIL TO SOMEONE AT cse.nau.edu., WHERE WOULD IT REALLY GO?

	mx cse.nau.edu.

4. WHAT'S THE FULLY QUALIFIED DOMAIN NAME FOR HOST 134.114.64.1?

	ptr `f2iaddr 134.114.64.1`

5. JUST GIVE ME ALL KNOWN DOMAIN RECORDS FOR HOST pine.cse.nau.edu.

	any pine.cse.nau.edu.

6. WHAT DNS ZONE DOES THE COMPUTER OR DOMAIN pine.cse.nau.edu BELONG TO?

	zone pine.cse.nau.edu.

7. HOST INFO FOR bogus.cse.nau.edu. IS OUT OF DATE, WHAT'S THE SOA RECORD
   FOR WHATEVER ZONE IT LIES IN SO I CAN CONTACT THE ADMINISTRATOR?

	soa `zone bogus.cse.nau.edu.`

8. WHAT ARE ALL THE MX RECORDS I SET UP LAST WEEK FOR MY SECOND-LEVEL DOMAIN?

	mx domtools.com.

9. WHAT ARE ALL THE CURRENT ROOT DOMAIN NAME SERVERS ON THE INTERNET?

	root

10. WHAT KIND OF COMPUTER IS FTP.UU.NET.?

	hinfo FTP.UU.NET.

11. MY root.cache DATABASE FILE IS PROBABLY OUT OF DATE, WHAT CAN I DO?

	cachebuild > root.cache

12. WHAT ARE ALL THE NETWORK-GATEWAY HOSTS FOR NETWORK 134.114.68?

	gw 134.114.68

13. WHAT IP NETWORK IS pine.cse.nau.edu ON?
   (note: this method doesn't understand subnetting)

   sh:	a=`address pine.cse.nau.edu.`
	addr2net $a `addr2mask $a`

  csh:  set a = `address pine.cse.nau.edu.`
	addr2net $a `addr2mask $a`

14. GIVE ME THE NAME OF ONE ROOT DOMAIN NAME SERVER, CHOSEN AT RANDOM.

	rndarg `root` | head -1

15. GIVEN THE HOST ALIAS pin.cse.nau.edu., WHAT'S THE CANONICAL NAME?

	cname pin.cse.nau.edu.

16. IF WE WERE TO SET OUR 134.114 NETWORK'S SUBNET MASK TO 255.255.255.128,
    HOW MANY USABLE SUBNETS WOULD THAT GIVE US?

	gensubnetlist `netwithzeros 134.114` `addr2mask 134.114` \
		255.255.255.128 | wc -l

17. AND WHAT WOULD THOSE SUBNET ADDRESSES BE?

	gensubnetlist `netwithzeros 134.114` `addr2mask 134.114` \
		255.255.255.128

18. HOW MANY HOST IP ADDRESSES DO I GET OUT OF ONE OF THOSE SUBNETS,
    LIKE 134.114.150.0?

	geniplist 134.114.150.0 255.255.255.128 | wc -l

19. AND WHAT WOULD THOSE HOST IP ADDRESSES BE?

	geniplist 134.114.150.0 255.255.255.128

20. WHAT DO THE INTERNET TOP LEVEL NAME SERVERS THINK MY DOMAIN'S
    NAME SERVERS ARE?

	nsroot nau.edu.

21. WHO ARE ALL THE AUTHORITATIVE NAMESERVERS FOR DOMAIN cse.nau.edu.
    ACCORDING TO ONE OF THOSE NAMESERVERS?

	ns cse.nau.edu.

22. GIVE ME AN /etc/hosts STYLE FILE BY QUERYING DOMAIN nau.edu.:

	hosttbl nau.edu.

23. WHAT ABOUT /etc/networks, AND SUNOS'S /etc/netmasks FILES?

	networktbl -h -x cse.nau.edu.
	netmasktbl -x cse.nau.edu.

24. GIVE ME A LIST OF ALL ZONES IMMEDIATELY WITHIN THE nau.edu. ZONE:
    (NOT A RECURSIVE LIST):

	subzone nau.edu.

25. NOW GIVE ME A RECURSIVE LIST OF SUBZONES BELOW IT:

	subzone -r nau.edu.

26. GIVE ME A LIST OF HOSTS WITHIN THE aa.nau.edu. DOMAIN WITHOUT
    LOOKING IN SUBDOMAINS, IF ANY EXIST:

	hosts cse.nau.edu.

27. NOW GIVE ME A RECURSIVE LIST OF THOSE WITH ALL SUBDOMAINS:

	hosts -r cse.nau.edu.

28. GIVE ME A LIST OF ALL RECORDS IN ZONE nau.edu. (NOT RECURSIVE):

	axfr nau.edu.

29. WHAT'S MY COMPUTER'S IP ADDRESS?

	localad

30. WHAT INTERNET DOMAIN IS MY COMPUTER IN?

	localdom

31. WHAT IP NETWORK DOES MY COMPUTER BELONG TO?

   sh:	a=`localad | head -1`
	addr2net $a `addr2mask $a`

  csh:  set a = `localad | head -1`
	addr2net $a `addr2mask $a`

32. WHAT DOES THE NETWORK INFORMATION CENTER KNOW ABOUT MY COMPUTER'S NETWORK?

	a=`localad | head -1`
	m=`addr2mask $a`
	whois `addr2net $a $m`@whois.arin.net

    NOTE 1: "whois" should be an existing command already on your system.
	If it is missing or not working, the C source is available on the 'net.

    NOTE 2: you may need a different syntax, such as:
		whois `addr2net $a $m`@whois.arin.net.
	or:	whois -h whois.arin.net. `addr2net $a $m`

33. WHAT DNS ZONE IS MY WORKSTATION IN?

	zone `localdom`

34. WHAT NETWORK OR SUBNET DOES THE IP ADDRESS 1.2.3.4 BELONG TO?

	network 1.2.3.4

    (NOTE: for this to work right with subnetting, domain database must have
	RFC1101 subnetting extensions).

35. WHAT NETMASK APPLIES TO NETWORK 1.2.3.0?

	netmask 1.2.3.0

36. DOES NETWORK 1.2.3.0 HAVE A SUBNETMASK RECORD IN THE NAME SERVER OR NOT?

	subnetmask 1.2.3.0

37. TELL ME ABOUT THE SITE IN CHARGE OF DOMAIN nau.edu.

	siteinfo nau.edu.

38. CANONICALIZE HOSTNAME pine.cse.nau.edu. WHETHER IT IS A CNAME OR NOT:

	a=`address pine.cse.nau.edu. | head -1`
	ptr `f2iaddr $a`

39. SHOW ME THE OSI NSAP RECORDS FOR somehost.dom.ain.

	nsap somehost.dom.ain.

40. WHAT IS THE PARENT ZONE OF A GIVEN ZONE cse.nau.edu.?
    (because it's not always simply the parent domain...)

	outerzone=`basedomain cse.nau.edu.`
	zone $outerzone

41. LIST THE SOA RECORDS THAT EACH AUTHORITATIVE NAMESERVER HAS FOR nau.edu.
    SO I CAN SEE IF THEY ALL HAVE THE SAME VERSION NUMBER:

	soalist nau.edu.

42. DOES MY ZONE HAVE RFC 1101 COMPLIANT RECORDS? (optional; not used much today)

	check1101 nau.edu.
	check1101 134.114.0.0

43. I AM BEHIND A FIREWALL, BUT I KNOW MY LOCAL NAMESERVER IS NAMED ns1
    GIVE ME A ZONE DUMP OF MY ZONE nau.edu.

	axfr @ns1.nau.edu. nau.edu.

    NOTE: all tools now support "@nameserver" option as of version 1.4.0.

44. I HAVE A LIST OF DOMAIN NAMES, HOW CAN I SORT THEM HIERARCHICALLY?

	domsort < yourfile > newfile

45. I HAVE A LIST OF IP ADDRESSES, HOW CAN I SORT THEM IN NETWORK ORDER?

	ipsort < yourfile > newfile

46. I HAVE THE NETWORK 111.222.128.0/20, WHAT'S MY NETMASK?

	bits2mask 20

47. GIVEN A NETMASK OF 255.255.240.0, HOW MANY NETWORK BITS IS THAT?

	mask2bits 255.255.240.0

--------