Annotation of researchv10dc/man/man7/qns.7, revision 1.1.1.1

1.1       root        1: .TH QNS 7
                      2: .CT 1 sa_auto
                      3: .SH NAME
                      4: qns \- query name server
                      5: .SH SYNOPSIS
                      6: .B qns
                      7: [
                      8: .B -n
                      9: .I server
                     10: ] [
                     11: .I request
                     12: ]
                     13: .SH DESCRIPTION
                     14: .I Qns
                     15: retrieves information from
                     16: a database of naming information.
                     17: It is used by
                     18: .I rsh
                     19: and
                     20: .I rlogin
                     21: (see
                     22: .IR dcon (1))
                     23: to translate names to internet addresses and by
                     24: .IR mail (1)
                     25: to route electronic mail.
                     26: .PP
                     27: Entries in the database
                     28: consist of one or more
                     29: .IB value , type
                     30: pairs or simple
                     31: .I values.
                     32: A simple
                     33: .I value
                     34: declares the name of some entity.
                     35: An entry may contain no name
                     36: or several, and
                     37: different entries containing the same name
                     38: need not refer to the same entity.
                     39: .PP
                     40: These types are used:
                     41: .PP
                     42: .TF origin
                     43: .TP
                     44: .B dk
                     45: .I Value
                     46: is a Datakit address.
                     47: .TP
                     48: .B in
                     49: .I Value
                     50: is a numeric IP address.
                     51: .TP
                     52: .B dom
                     53: .I Value
                     54: is an internet domain name.
                     55: .TP
                     56: .B tel
                     57: .I Value
                     58: is a telephone number,
                     59: possibly prefixed by a
                     60: .I uucp
                     61: .B Dialcodes
                     62: name.
                     63: .TP
                     64: .B org
                     65: .I Value
                     66: is an organization name.
                     67: .TP
                     68: .B svc
                     69: .I Value
                     70: names a service.
                     71: .TP
                     72: .B origin
                     73: .I Value 
                     74: must be
                     75: .BR local ,
                     76: for sorting by `distance';
                     77: see below.
                     78: .PD
                     79: .PP
                     80: The following entries describe an entity
                     81: .B research
                     82: with a Datakit address,
                     83: an IP address and domain name,
                     84: belonging to organization
                     85: .BR att ,
                     86: and offering the
                     87: .B uucp
                     88: service:
                     89: .IP
                     90: .EX
                     91: 192.11.4.55,in research research.astro.nj.att.com.,dom att,org 
                     92: research nj/astro/research,dk uucp,svc att,org 
                     93: .EE
                     94: .PP
                     95: .I Qns
                     96: prints database entries that match
                     97: .I requests.
                     98: If a
                     99: .IR request
                    100: is supplied on the command line,
                    101: .I qns
                    102: prints the answer and exits;
                    103: otherwise it reads and answers requests from the standard input
                    104: until end-of-file.
                    105: The possible requests are:
                    106: .TP
                    107: .BI set " key" ...
                    108: Print every entry
                    109: matching
                    110: all
                    111: .IR keys .
                    112: .TP
                    113: .BI value " tlist key" ...
                    114: Examine entries matching
                    115: the
                    116: .IR keys
                    117: until a pair with type
                    118: .I tlist
                    119: is found;
                    120: print the matching value
                    121: and stop.
                    122: .I Tlist
                    123: may be a single type,
                    124: or several separated by
                    125: .LR | .
                    126: .TP
                    127: .B reset
                    128: Cause the name server
                    129: to reinitialize its database.
                    130: .TP
                    131: .B help
                    132: Print a list of requests.
                    133: .TP
                    134: .B quit
                    135: Exit
                    136: .IR qns .
                    137: .PD
                    138: .PP
                    139: A 
                    140: .I key
                    141: is a
                    142: .IB value , type
                    143: pair;
                    144: an entry matches if it contains that pair.
                    145: If
                    146: .BI , type
                    147: is omitted,
                    148: any pair with the specified
                    149: .I value
                    150: will do.
                    151: A
                    152: .B *
                    153: at the end of a
                    154: .I value
                    155: stands for an arbitrary suffix.
                    156: .PP
                    157: When a database search
                    158: returns several entries with 
                    159: .B dk
                    160: or
                    161: .B dom
                    162: types, and the database contains an entry with the conventional pair
                    163: .BR local,origin ,
                    164: the entries are sorted by increasing `distance'
                    165: from the
                    166: .B dk
                    167: or
                    168: .B dom
                    169: pairs in the
                    170: .B local,origin
                    171: entry.
                    172: Datakit names in the same exchange are nearer
                    173: than names in different exchanges in the same area,
                    174: which are nearer than names in different areas.
                    175: Domain names matching to four levels of domain hierarchy
                    176: are nearer than names matching to only three levels,
                    177: and so on.
                    178: .PP
                    179: .I Qns
                    180: expects to reach the name server
                    181: .IR ns (8);
                    182: option
                    183: .B -n
                    184: points it at service
                    185: .I server
                    186: instead.
                    187: .SH SEE ALSO
                    188: .IR ipc (3),
                    189: .IR ns (8)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.