                                              NSQUERY User's Manual                    October, 1992     ;           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   4           Software Version:             NSQUERY V3.0               Matthew Madison            TGV, Inc.             Santa Cruz, California                                               "           ________________________           13 October 1992   =           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.   6           DISCLAIMER: The author and TGV, Inc. 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:  9           DEC                   ULTRIX                VAX #           VAXcluster            VMS   9           MultiNet is a registered trademark of TGV, Inc.              __________8           Copyright 1992 Matthew D. Madison. 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":   0                $ 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   4           NS               authoritative name server  6           MD               mail destination (obsolete)  4           MF               mail forwarder (obsolete)  6           CNAME            canonical name for an alias  2           SOA              start of zone authority  =           MB               mailbox domain name (experimental)   ;           MG               mail group member (experimental)   2           MR               mail rename domain name)                            (experimental)   /           NULL             null resource record   9           WKS              well-known service description   .           PTR              domain name pointer  +           HINFO            host information   ;           MINFO            mailbox or mail list information   (           MX               mail exchange  '           TXT              text strings   1           AXFR             complete zone transfer       
           2-4          A                                                           NSQUERY       A           Table_2-1_(Cont.)__Resource_record_types_______________   A           Type/QType_______Description___________________________   ?           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:   A           Table_2-2__Resource_record_classes_____________________   A           Class/QClass_____Description___________________________   '           INTERNET         the Internet   5           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.         A                                                               2-5                     NSQUERY       ,           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   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 