RIPD.CONF(5)              OpenBSD Programmer's Manual             RIPD.CONF(5)

NAME
     ripd.conf - Routing Information Protocol daemon configuration file

DESCRIPTION
     The ripd(8) daemon implements the Routing Information Protocol version 2
     as described in RFC 2453.

SECTIONS
     The ripd.conf config file is divided into three main sections.

     Macros
           User-defined variables may be defined and used later, simplifying
           the configuration file.

     Global Configuration
           Global settings for ripd(8).

     Interfaces Configuration
           Interface-specific parameters.

MACROS
     Much like cpp(1) or m4(1), macros can be defined that will later be ex-
     panded in context.  Macro names must start with a letter, and may contain
     letters, digits, and underscores.  Macro names may not be reserved words
     (for example, cost).  Macros are not expanded inside quotes.

     For example:

           hi="2"
           interface em0 {
                   cost $hi
           }

GLOBAL CONFIGURATION
     Global settings concerns the main behaviour of the daemon.

     fib-update (yes|no)
             If set to no, do not update the Forwarding Information Base,
             a.k.a. the kernel routing table.  The default is yes.

     rdomain tableid
             Specifies the routing table ripd(8) should modify.  Table 0 is
             the default table.

     [no] redistribute (static|connected|default)
     [no] redistribute prefix
     [no] redistribute rtlabel label
             If set to connected, routes to directly attached networks will be
             announced over RIP.  If set to static, static routes will be an-
             nounced over RIP.  If set to default, a default route pointing to
             this router will be announced over RIP.  It is possible to speci-
             fy a network range with prefix; networks need to be part of that
             range to be redistributed.  Additionally it is possible to redis-
             tribute based on route labels using the rtlabel keyword.  By de-
             fault no additional routes will be announced over RIP.

             redistribute statements are evaluated in sequential order, from
             first to last.  The first matching rule decides if a route should
             be redistributed or not.  Matching rules starting with no will
             force the route to be not announced.

     split-horizon (simple|poisoned|none)
             If set to simple, do not redistribute routes to the interface
             from which they were learned.  If set to poisoned, redistribute
             routes to the interface from which they were learned, by forcing
             the metric to infinity.  Both these behaviours can resolve rout-
             ing loops when a router goes down.  The default is poisoned.

     triggered-updates (yes|no)
             Immediately trigger responses when a route changes.  The default
             is yes.

INTERFACES
     Each interface can have several parameters configured individually, oth-
     erwise they are inherited.

           interface em0 {
           }

     Interface-specific parameters are listed below.

     auth-key key
             Set the authentication key for simple authentication.  Up to 16
             characters can be specified.

     auth-md key-id key
             Set the authentication key-id and key for crypt authentication.
             The valid range for key-id is 0-255.  Up to 16 characters can be
             specified for key.  Multiple keys may be specified.

     auth-md-keyid key-id
             Configure the key-id to use for crypt authentication.  The valid
             range for key-id is 0-255.  The default key-id is 1.

     auth-type (none|simple|crypt)
             Set the authentication type.  The default is none.  Simple au-
             thentication uses a plaintext password, up to 16 characters.
             Crypt authentication uses an MD5 hash.

     cost number
             Cost of the network connected through this interface.  Values
             must be between 1 and 16, inclusive.

     demote group
             Increase the carp(4) demotion counter by 1 on the given interface
             group, usually carp, when the interface state is going down.  The
             demotion counter will be decreased when the interface state is
             active again.

     passive
             Prevent transmission and reception of RIP packets on this inter-
             face.

FILES
     /etc/ripd.conf  ripd(8) configuration file

SEE ALSO
     rc.conf.local(8), ripctl(8), ripd(8)

HISTORY
     The ripd.conf file format first appeared in OpenBSD 4.1.

OpenBSD 4.7                     January 2, 2010                              2
