Kostis Netzwerkberatung
Konstantinos Kostis
Talstr. 25, D-63322 Rödermark
Tel. +49 6074 881056, FAX 881058
kosta@kostis.net, http://www.kostis.net/

You may use this software free of charge at your own risk

netdb 3.0.6 (2001-01-29)


netdb data file format

Design Goals

Definitions

Object   Meaning
netdb data file   network data in the format described below
entry   all data about one interface (properties terminated by an empty line)
property   property of an entry (eg. ipaddr)
function   value calculated from one or more property values
value   value assigned to a property between delimiter '=' and "end of line" ('\n')

Format Rules

General Format of an Entry

[hostname]
domain=
ipaddr=
ipmask=
mac=
comment=
isdnarea=
isdnnum=
x25=
ipxaddr=
ipxlan=
decnet=
location=
hubport=
user=
cnames=

Note: The entry shown above is not valid. Do you know why? No? Then read the above lines again until you do. ;)

Example

[live]
domain=.usr
ipaddr=192.168.0.254
ipmask=255.255.255.0
mac=00-00-1C-D1-D8-AA
comment=Red Hat Linux 7.0 (DNS/SMB/DHCP/i4l/netdb/etc.)
isdnarea=6074
isdnnum=881057
location=Kostis-Netzwerkberatung
hubport=Netgear DS108 Port 1
user=Kosta Kostis
cnames=ns dns

This entry would be stored in file /etc/netdb/domains/netdb.usr (since the value of property domain is ".usr" - mind the leading dot).

File Permissions

-rw-rw-r-- 1 netdb apache xxxxx Jan 29 03:06 netdb.virtual-subdomain

As you can see from the example above, machine live does not have any of the following possible properties:

Multiple IP Addresses

Network interfaces with multiple IP addresses need an entry for each IP address hence a hostname for each entry. In such a case please enter it's MAC address only once, otherwise it will cause trouble generating dhcpd.conf files. If you don't need DHCP reservations generated by netdb, go ahead and type in the same MAC address as often as you like. ;)

Unique Properties

The following properties must be unique (when not empty):

Of course hostname must be unique, too. Property domain may not have an empty value.

Virtual Subdomains

For each virtual subdomain (subnet) a corresponding file must exist. If it does not exist, it must be created by shell user netdb using /etc/netdb/bin/netdb.mkdomain.

Example

In this example we create virtual subdomain ".newdomain"

netdb.mkdomain .newdomain,192.168.1.0,255.255.255.0,Nirvana,Nowhere

Delegated Administration

Dividing netdb data into virtual subdomains and hence files allows for delegating administration. Different people can be responsible for different virtual subdomains by allowing them to administer only the virtual subdomains you want them to work on. This combines central storage and delegation which is the best of both worlds.

Administration rights are stored in /etc/netdb/allow.