                                                  NSQUERY User's Manual                  October, 1993       ;           This manual contains information about the use of @           NSQUERY, a program for testing Internet domain service"           (RFC 1035) name servers.        A           Revision/Update Information:  This is a revised manual.   9           Operating System and Version: VMS V5.0 or later   6           Software Version:             NSQUERY V3.0-2                 Matthew Madison            MadGoat Software                                                   "           ________________________           11 October 1993   =           Permission is granted to copy and redistribute this *           document for no commercial gain.  ?           The information in this document is subject to change 9           without notice and should not be construed as a 9           commitment by the author. The author assumes no ?           responsibility for any errors that may appear in this            document.   <           DISCLAIMER: The author, the author's employer, and@           MadGoat Software make no representations or warranties>           with respect to the contents hereof and specifically?           disclaim any implied warranties of merchantability or -           fitness for any particular purpose.   ;           The following are trademarks of Digital Equipment            Corporation:  4           DEC                ULTRIX              VAX            VAXcluster         VMS  9           MultiNet is a registered trademark of TGV, Inc.              __________@           Copyright 1993 MadGoat Software. All Rights Reserved.                   A           _______________________________________________________              Preface   <           This document is intended for users of the NSQUERY>           program. The reader is expected to be familiar with,?           or at least have access to, the information about the @           Internet Domain Naming Service, such as Internet RFC's           1034 and 1035.  L           __________________________________________________________________             System Requirements   ;           NSQUERY requires VMS V5.0 or later and either TGV 9           MultiNet or another TCP/IP package supported by =           the author's NETLIB package, version V1.2 or later. >           Refer to the NETLIB release notes for information on$           supported TCP/IP products.                                            A                                                               iii                      A           _______________________________________________________       1      Installing NSQUERY      ?           NSQUERY comes in both source and object form. You may =           either recompile the program from sources or simply =           link the provided object code to create the NSQUERY            executable.   <           To just create the executable from the object code<           provided in the distribution kit, just execute the9           LINK.COM command procedure provided in the kit.   <           For rebuilding from source code, use the BUILD.COM@           command procedure provided or the MMS description file=           also in the kit. You may need to modify these files            before using them.  L           __________________________________________________________________  &    1.1    Alternate Network Transports  :           NSQUERY is provided with access routines for two6           network transports: MultiNet (using its $QIO<           interface) and NETLIB (which interfaces to several:           different TCP/IP packages). If you have a TCP/IP<           package that isn't directly supported, or you just=           don't want to install the NETLIB package to support =           it, you can write your own network access routines. ?           The files NETWORK_MULTINET.C and NETWORK_NETLIB.C can @           be used as examples or modified as needed for use with$           your TCP/IP package's API.            A                                                               1-1                      A           _______________________________________________________       2      Using NSQUERY       =           NSQUERY is designed to be invoked as a DCL "foreign            command":   <                            $ NSQ*UERY :== $disk:[dir]NSQUERY  8           The command description on the following pages@           describes the qualifiers and parameters available with           NSQUERY.                                                    A                                                               2-1                     NSQUERY           A           _______________________________________________________   ,           NSQUERY-Issue a Name Service Query    ;           This command issues a query to an Internet domain 2           server and displays the resultant reply.  A           _______________________________________________________              FORMAT  &           NSQUERY  query-name [server]  A           _______________________________________________________ )           Command Qualifiers     Defaults   )           /PORT=number           /PORT=53 .           /PROTOCOL=proto        /PROTOCOL=UDP-           /[NO]RECURSIVE         /NORECURSIVE *           /TYPE=qtype            /TYPE=ALL0           /CLASS=qclass          /CLASS=INTERNET  A           _______________________________________________________              PARAMETERS           query-name?           Name about which information should be obtained. This <           should be an internet dotted domain-style name. If>           query-name is a numeric IP address in dotted decimal>           form (e.g., 128.113.1.5), NSQUERY will automatically8           make an inverse query by reversing the address.           segments and adding ".IN-ADDR.ARPA".             server>           Server to be queried. If omitted, NSQUERY translates:           the logical name NSQ_SERVER to obtain the server=           name. If there is no such logical name or it cannot <           be translated, NSQUERY prompts for the name of the>           server. If the server's name has multiple addresses,>           all addresses are obtained and each is tried until a8           query is successfully sent and reply received.  
           2-2          A                                                           NSQUERY         A           _______________________________________________________              DESCRIPTION   6           All resource records defined in RFC 1035 are7           interpreted by NSQUERY. Refer to that RFC for 9           information about the abbreviations used in the <           resource record display. All "time-to-live" values@           are displayed as VMS delta-time strings. Authoritative?           responses and truncated messages are noted before the )           resource records are displayed.   A           _______________________________________________________              QUALIFIERS           /PORT=port@           Directs the query to the specified TCP or UDP port. If>           omitted, port 53 (the port used by most, if not all,"           domain servers) is used.             /PROTOCOL=proto <           Selects either TCP or UDP protocol. The default is?           UDP. UDP is generally used for simple domain queries; <           TCP is generally only used for major domain system)           events, such as zone transfers.              /[NO]RECURSIVE=           Sets the recursion desired bit in the query. If the >           server being queried supports recursion and does not=           have the requested information cached, it will make ;           queries of other servers on your behalf until the ;           query is answered. NSQUERY will notify you if the 4           server does not support recursive queries.             /TYPE=qtype <           Selects the type of resource record to be returned?           about the name. The default is ALL, which selects all >           available resource record types. Available types are           as follows:     A                                                               2-3                     NSQUERY           A           Table_2-1__Resource_record_types_______________________   A           Type/QType_____Description_____________________________   %           A              host address   2           NS             authoritative name server  4           MD             mail destination (obsolete)  2           MF             mail forwarder (obsolete)  4           CNAME          canonical name for an alias  0           SOA            start of zone authority  ;           MB             mailbox domain name (experimental)   9           MG             mail group member (experimental)   ?           MR             mail rename domain name (experimental)   -           NULL           null resource record   7           WKS            well-known service description   ,           PTR            domain name pointer  )           HINFO          host information   9           MINFO          mailbox or mail list information   &           MX             mail exchange  %           TXT            text strings   /           AXFR           complete zone transfer   =           MAILB          all mailbox-related records (MB, MG,                           MR)  A           MAILA__________all_mail_agent_records_(obsolete)_______   9           Refer to RFC 1035 for a complete description of =           resource record types and their uses. Note that not :           all servers support all record types. You should<           probably never attempt to use the AXFR query type.             /CLASS=qclass ?           Selects the class of resource records to be returned. ?           The default is INTERNET. Available qclass values are:   
           2-4          A                                                           NSQUERY           A           Table_2-2__Resource_record_classes_____________________   A           Class/QClass___Description_____________________________   %           INTERNET       the Internet   3           CSNET          the CSNET class (obsolete)   (           CHAOSNET       the CHAOS class  )           HESIOD         the Hesiod class   A           ALL____________all_classes_____________________________   :           For more information about resource record class9           values, see RFC 1035. Note that not all servers >           support all classes; most servers' authority extends/           only over Internet-class information.   ,           Example 2-1  Sample NSQUERY outputA           _______________________________________________________   0           $ NSQUERY RPI.EDU NETSERV1.ITS.RPI.EDU  9           %NSQUERY-I-TRYNS, trying address 128.113.1.5... 5           %NSQUERY-I-AUTHRESP, authoritative response D           %NSQUERY-I-QUERYOK, query operation completed successfully  8           QUERY  #1: QName=RPI.EDU., QType=255, QClass=1  ;           ANSWER #1: RPI.EDU., SOA, INTERNET,    0 12:00:00 "               Primary NS: rpi.edu..               Responsible: hostmaster.rpi.edu.G               Serial=600072, Refresh=   1 06:00:00, Retry=   0 00:20:00 9               Expire=  41 16:00:00, Minimum=   0 12:00:00 K           ANSWER #2: RPI.EDU., A, INTERNET,    0 12:00:00, Addr=128.113.1.7 T           ANSWER #3: RPI.EDU., NS, INTERNET,    0 12:00:00, NS=netserv1.its.rpi.edu.T           ANSWER #4: RPI.EDU., NS, INTERNET,    0 12:00:00, NS=netserv2.its.rpi.edu.L           ANSWER #5: RPI.EDU., NS, INTERNET,    0 12:00:00, NS=columbia.edu.O           ANSWER #6: RPI.EDU., NS, INTERNET,    0 12:00:00, NS=n2ngw.nyser.net. U           ANSWER #7: RPI.EDU., HINFO, INTERNET,    0 12:00:00, CPU=SUN-3/280, OS=UNIX   A           _______________________________________________________ )           Example 2-1 Cont'd on next page   A                                                               2-5                     NSQUERY         4           Example 2-1 (Cont.)  Sample NSQUERY outputA           _______________________________________________________   X           ADDTNL #1: netserv1.its.rpi.edu., A, INTERNET,    0 12:00:00, Addr=128.113.1.5X           ADDTNL #2: netserv2.its.rpi.edu., A, INTERNET,    1 00:00:00, Addr=128.113.1.3P           ADDTNL #3: columbia.edu., A, INTERNET,    0 21:27:26, Addr=128.59.16.1P           ADDTNL #4: columbia.edu., A, INTERNET,    0 21:27:26, Addr=128.59.32.1S           ADDTNL #5: n2ngw.nyser.net., A, INTERNET,    1 22:57:35, Addr=192.35.82.2 U           ADDTNL_#6:_n2ngw.nyser.net.,_A,_INTERNET,____0_00:00:56, Addr=128.145.198.2                                                                 
           2-6 