in order to produce the
.BR tripe.cdb (8)
database used by services and other tools.
+.
.SS "General structure"
The configuration file is line-oriented. Blank lines are ignored; lines
beginning with a hash
[parent]
detail = in parent
blurb = expand $(detail)
-
-.PP
+.VE
Apart from its effect on lookups, as just described, the
.B @inherits
key is entirely ignored. In particular, it is never written to the
database.
+.
.SS "Standard keys and their meanings"
The following keys have meanings to programs in the TrIPE suite. Other
keys may be used by separately distributed extensions or for local use.
If true, include the peer in the
.B %AUTO
record. Used by
+.BR connect (8)
+and
.BR tripe-newpeers (8);
described below.
.TP
+.B connect
+Shell command for initiating connection to this peer. Used by
+.BR connect (8).
+.TP
+.B cork
+Don't initiate immediate key exchange. Used by
+.BR connect (8).
+.TP
+.B disconnect
+Shell command for closing down connection to this peer. Used by
+.BR connect (8).
+.TP
+.B every
+Interval for checking that the peer is still alive and well. Used by
+.BR connect (8).
+.TP
+.B ifdown
+Script to bring down tunnel interface connected to the peer. Used by
+.BR connect (8).
+.TP
+.B ifname
+Interface name to set for the tunnel interface to the peer. Used by
+.BR tripe-ifup (8).
+.TP
+.B ifup
+Script to bring up tunnel interface connected to the peer. Used by
+.BR connect (8).
+.TP
+.B ifupextra
+Script containing additional interface setup. Used by
+.BR tripe-ifup (8).
+.TP
+.B laddr
+Local address for the tunnel interface to the peer. Used by
+.BR tripe-ifup (8).
+.TP
+.B keepalive
+Interval for sending keepalive pings. Used by
+.BR connect (8).
+.TP
+.B key
+Key tag to use to authenticate the peer. Used by
+.BR connect (8).
+.TP
+.B mobile
+Peer's IP address is highly volatile. Used by
+.BR connect (8).
+.TP
+.B mtu
+Maximum transmission unit for the tunnel interface. Used by
+.BR tripe-ifup (8).
+.TP
+.B nets
+Networks to be routed over the tunnel interface. Used by
+.BR tripe-ifup (8).
+.TP
+.B peer
+Network address for this peer, or
+.BR PASSIVE .
+Used by
+.BR connect (8).
+.TP
+.B priv
+Tag of the private key to use when communicating with the peer.
+Used by
+.BR connect (8).
+.TP
+.B raddr
+Remote address for the tunnel interface to the peer. Used by
+.BR tripe-ifup (8).
+.TP
+.B retries
+Number of failed ping attempts before attempting reconnection. Used by
+.BR connect (8).
+.TP
+.B timeout
+Timeout for ping probes. Used by
+.BR connect (8).
+.TP
+.B tunnel
+Tunnel driver to use when adding the peer. Used by
+.BR connect (8)).
+.TP
.B user
Peer will make active connection as
.IR user .
Used by
+.BR connect (8)
+and
.BR tripe-newpeers (8);
described below.
+.
.SS "Conversion"
This section describes how the textual
.B peers.in
.PP
.BR tripe-newpeers (8),
.BR peers.cdb (5),
+.BR connect (8),
.BR tripe-ifup (8).
.
.\"--------------------------------------------------------------------------