NDB(6) NDB(6)
NAME
ndb - Network database
DESCRIPTION
The network database consists of files describing machines
known to the local installation and machines known publicly.
The files comprise multi-line tuples made up of
attribute/value pairs of the form attr=value or sometimes
just attr. Each line starting without white space starts a
new tuple. Lines starting with # are comments.
The file /lib/ndb/local is the root of the database. Other
files are included in the database if a tuple with an
attribute-value pair of attribute database and no value
exists in /lib/ndb/local. Within the database tuple, each
pair with attribute file identifies a file to be included in
the database. The files are searched in the order they
appear. For example:
database=
file=/lib/ndb/common
file=/lib/ndb/local
file=/lib/ndb/global
declares the database to be composed of the three files
/lib/ndb/common, /lib/ndb/local, and /lib/ndb/global. By
default, /lib/ndb/local is searched before the others. How-
ever, /lib/ndb/local may be included in the database to
redefine its ordering.
Within tuples, pairs on the same line bind tighter than
pairs on different lines.
Programs search the database directly using the routines in
ndb(2) or indirectly using ndb/cs and ndb/dns (see ndb(8)).
Both ndb/cs and the routine ndbipinfo impose structure on
the otherwise flat database by using knowledge specific to
the network. The internet is made up of networks which can
be subnetted multiple times. A network must have an ipnet
attribute and is uniquely identified by the values of its ip
and ipmask attributes. If the ipmask is missing, the rele-
vant Class A, B or C one is used.
A search for an attribute associated with a network or host
starts at the lowest level, the entry for the host or net-
work itself, and works its way up, bit by bit, looking at
entries for nets/subnets that include the network or host.
The search ends when the attribute is found. For example,
consider the following entries:
Page 1 Plan 9 (printed 11/21/24)
NDB(6) NDB(6)
ipnet=murray-hill ip=135.104.0.0 ipmask=255.255.0.0
dns=135.104.10.1
ntp=ntp.cs.bell-labs.com
ipnet=plan9 ip=135.104.9.0 ipmask=255.255.255.0
ntp=oncore.cs.bell-labs.com
smtp=smtp1.cs.bell-labs.com
ip=135.104.9.6 sys=anna dom=anna.cs.bell-labs.com
smtp=smtp2.cs.bell-labs.com
Here anna is on the subnet plan9 which is in turn on the
class B net murray-hill. Assume that we're searching for
anna's NTP and SMTP servers. The search starts by looking
for an entry with sys=anna. We find the anna entry. Since
it has an smtp=smtp2.cs.bell-labs.com pair, we're done look-
ing for that attribute. To fulfill the NTP request, we con-
tinue by looking for networks that include anna's IP
address. We lop off the right most one bit from anna's
address and look for an ipnet= entry with ip=135.104.9.4.
Not finding one, we drop another bit and look for an ipnet=
entry with ip=135.104.9.0. There is such an entry and it
has the pair, ntp=oncore.cs.bell-labs.com, ending our
search.
Ndb/cs can be made to perform such network aware searches by
using metanames in the dialstring. A metaname is a $ fol-
lowed by an attribute name. Ndb/cs looks up the attribute
relative to the system it is running on. Thus, with the
above example, if a program called
dial("tcp!$smtp!smtp", 0, 0, 0);
the dial would connect to the SMTP port of
smtp2.cs.bell-labs.com.
A number of attributes are meaningful to programs and thus
reserved. They are:
sys system name (a short name)
dom Internet fully-qualified domain name
ip Internet address, v4 or v6.
ipv6 IPv6 Internet address. For DNS, an `AAAA'
record.
ipnet Internet network name
ipmask Internet network mask
ipgw Internet gateway (ip address)
ether Ethernet address (must be lower-case hex)
vendor Specific vendor attribute for dhcp and bootp
bootf file to download for initial bootstrap;
/386/9bootpxe to boot a PC via PXE.
tftp an TFTP server to use for PXE bootstrap
fs Plan 9 file server to be used
auth Plan 9 authentication server to be used
Page 2 Plan 9 (printed 11/21/24)
NDB(6) NDB(6)
authdom Plan 9 authentication domain. To specify an
authentication server for a particular domain,
add a tuple containing both auth and authdom
attributes and values.
rootpath the NFS root for unix machines
rootserver the NFS server used with rootpath
dnsdomain a domain name that ndb/dns adds onto any
unrooted names when doing a search. There may
be multiple dnsdomain pairs.
dns a DNS server to use (for DNS and DHCP)
ntp an NTP server to use (for DHCP)
smtp an SMTP server to use (for DHCP)
time a time server to use (for DHCP)
wins a Windows name server (for DHCP)
mx mail exchanger (for DNS and DHCP); also pref.
srv service location (for DNS); also pri, weight and
port.
soa start of area (for DNS)
tcp a TCP service name
udp a UDP service name
port a TCP or UDP port number
restricted a TCP service that can be called only by ports
numbered less than 1024
proto a protocol supported by a host. The pair
proto=il was needed by cs (see ndb(8)) in tuples
for hosts that supported the IL protocol
Cs defers to dns to translate dotted names to IP addresses,
only consulting the database files if dns cannot translate
the name.
Cs allows network entries with sys and dom attributes but no
ip attribute. Searches for the system name are resolved by
looking up the domain name with dns.
The file /lib/ndb/auth is used during authentication to
decide who has the power to `speak for' other users; see
authsrv(6).
EXAMPLES
A tuple for the CPU server, spindle.
sys=spindle
dom=spindle.research.bell-labs.com
bootf=/mips/9powerboot
ip=135.104.117.32 ether=080069020677
Entries for the network mh-astro-net and its subnets.
ipnet=mh-astro-net ip=135.104.0.0 ipmask=255.255.255.0
ipgw=r70.research.bell-labs.com
fs=bootes.research.bell-labs.com
Page 3 Plan 9 (printed 11/21/24)
NDB(6) NDB(6)
auth=p9auth.research.bell-labs.com
ipnet=unix-room ip=135.104.117.0
ipgw=135.104.117.1
ipnet=third-floor ip=135.104.51.0
ipgw=135.104.51.1
Mappings between TCP service names and port numbers.
tcp=sysmon port=401
tcp=rexec port=512 restricted
tcp=9fs port=564
FILES
/lib/ndb/local first database file searched
SEE ALSO
con(1), dial(2), ndb(2), booting(8), dhcpd(8), ipconfig(8),
ndb(8)
Page 4 Plan 9 (printed 11/21/24)