divine.conf - configuration file for divine

/etc/divine.conf

The file /etc/divine.conf lists all the networks this machine will be used in. In particular, the file lists the IP numbers of this machine in the different networks, the network mask, one or several IP numbers to try to reach in that network, the default gateway, the DNS configuration and web proxy settings.

It needs not be world readable (but does not contain passwords or other critical information).

Each line contains (in this order, separated by colons) the following fields:

"IP/netmask

This is simply the IP and netmask of this machine in this network. The netmask is specified as the number of bits from the left that are one, so 255.255.255.0, for example, would be written as /24.

"ip[|ip...]

You have to give at least one IP number that is always up in that network, for example the standard gateway. Please note that the IP number has to be on the same LAN, since ARP requests are not routed.

"default gateway

This is the IP number of the default gateway in this network.

"alternative resolv.conf

Once divine found out in which network you are, it will unlink /etc/resolv.conf and create a symbolic link to this value. I recommend using resolv.conf.work, resolv.conf.home and similar file names for this. make install will copy your resolv.conf to resolv.conf.default so it is not accidentally lost when you play with divine.

"web proxy

This is an IP number or host name of your web proxy.

"web proxy port

This is the numeric port of the web proxy you are using (probably 3128, 80, 8080 or 8000).

"script

This is the name of a script (or other executable) that you want divine to run when this configuration is detected. Use this for stuff that I forgot, maybe having a symlink scheme like the /etc/resolv.conf one for /etc/printcap or change /etc/issue to reflect the configuration. Use your imagination.

"description

This is simply so you can keep the entries apart, and divine will display this name when it identified the network.

You can put comment lines in /etc/divine.conf if they start with a hash sign (#).

# IP/netmask:ip[|ip...]:default_gw:resolv.conf.whatever:proxy:port:description
10.0.0.2/24:10.0.0.1|10.0.0.3:10.0.0.1:resolv.conf.default:10.0.0.1:3128:Home
160.45.45.167/23:160.45.44.1:160.45.44.1:resolv.conf.mathe:http-proxy.fu-berlin.de:80:Uni

/etc/divine.conf