Return to ns.8 CVS log

Up to [Research Unix] / researchv10dc / man / man8

Annotation of researchv10dc/man/man8/ns.8, revision 1.1.1.1

1.1       root        1: .TH NS 8
                      2: .CT 1 sa_auto
                      3: .SH NAME
                      4: ns \- name server database
                      5: .SH SYNOPSIS
                      6: .B /usr/ipc/mgrs/ns
                      7: [
                      8: .B -m
                      9: .I server
                     10: ] [
                     11: .B -d
                     12: ]
                     13: .SH DESCRIPTION
                     14: .I Ns
                     15: maintains a database
                     16: of naming information,
                     17: accessed by
                     18: .IR qns (7)
                     19: and other programs.
                     20: It should be run once from
                     21: .IR rc (8).
                     22: .PP
                     23: The database is accessed
                     24: through local service
                     25: .BR ns ,
                     26: or service
                     27: .I server
                     28: if option
                     29: .B -m
                     30: was specified.
                     31: .PP
                     32: The file
                     33: .F /usr/ipc/lib/ns.db
                     34: contains instructions for building the database.
                     35: These instructions are lines 
                     36: of one of the following forms:
                     37: .TP \w'#include\0file\0\0\0\0'u                \" wrong fonts; near enough?
                     38: .BI #uusys " file"
                     39: Read the named
                     40: .I uucp
                     41: .B Systems
                     42: .IR file .
                     43: For entries using caller
                     44: .LR ACU ,
                     45: add a database entry containing
                     46: .RS
                     47: .IP
                     48: .I system\0
                     49: .IB telephone-number ,tel\0
                     50: .B uucp,svc
                     51: .PP
                     52: For entries using caller
                     53: .LR DK
                     54: or
                     55: .LR DKH ,
                     56: add an entry containing
                     57: .IP
                     58: .I system\0
                     59: .IB datakit-address ,dk\0
                     60: .B uucp,svc
                     61: .PP
                     62: For any other entry,
                     63: add
                     64: .IP
                     65: .I system\0
                     66: .B uucp,svc
                     67: .RE
                     68: .TP
                     69: .BI #inhost " file"
                     70: For each line in the named
                     71: 4BSD-style internet hosts
                     72: .IR file ,
                     73: add a database entry of the form
                     74: .RS
                     75: .IP
                     76: .IB ip-address ,in\0
                     77: .I hostname\0
                     78: .IB host-domain-name ,dom
                     79: .RE
                     80: .TP
                     81: .BI #innet " file"
                     82: For each line in the named
                     83: 4BSD-style internet networks
                     84: .IR file ,
                     85: add a database entry of the form
                     86: .RS
                     87: .IP
                     88: .IB ip-net-address ,in\0
                     89: .I netname
                     90: .RE
                     91: .TP
                     92: .BI #include " file"
                     93: Interpret
                     94: the contents of
                     95: .IR file
                     96: in the same format
                     97: as
                     98: .BR ns.db .
                     99: .PP
                    100: In all cases,
                    101: .I file
                    102: may be followed by
                    103: a list of
                    104: .I value,attribute
                    105: pairs to be included with any
                    106: database entries caused by that file.
                    107: If the filename doesn't begin with
                    108: .LR / ,
                    109: it is prefixed with
                    110: .BR /usr/ipc/lib .
                    111: .PP
                    112: Blank lines
                    113: and
                    114: lines beginning with
                    115: .L #
                    116: followed by a space or tab
                    117: are ignored.
                    118: .PP
                    119: Any other lines are taken as literal database entries:
                    120: a collection of
                    121: .I value,attribute
                    122: pairs separated by spaces.
                    123: Each line is a single entry.
                    124: .PP
                    125: The database is ephemeral;
                    126: it is rebuilt whenever
                    127: .I ns
                    128: starts,
                    129: when requested by
                    130: .BR "qns reset" ,
                    131: or when
                    132: .I ns
                    133: notices that
                    134: .B ns.db
                    135: or one of the files named therein
                    136: has changed.
                    137: Rebuilding can take several minutes,
                    138: especially on a busy machine.
                    139: During a rebuild,
                    140: the server appears active but does not answer requests;
                    141: calls will block until the rebuild finishes.
                    142: .PP
                    143: .I Ns
                    144: leaves remarks in file
                    145: .FR /usr/ipc/log/ns .
                    146: There are more remarks if the
                    147: .B -d
                    148: option was used.
                    149: .SH FILES
                    150: .F /usr/ipc/lib/ns.db
                    151: .SH SEE ALSO
                    152: .IR ipc (3),
                    153: .IR qns (7)

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