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

NAME
     ldpd.conf - Label Distribution Protocol daemon configuration file

DESCRIPTION
     The ldpd(8) daemon implements the Label Distribution Protocol as de-
     scribed in RFC 3036.

SECTIONS
     The ldpd.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 ldpd(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.

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

     router-id address
             Set the router ID; in combination with labelspace it forms the
             LSR-ID.

     labelspace number
             Set the label space advertised by ldpd(8).

     holdtime seconds
             Set the hello holdtime in seconds.  The maximum time ldpd(8) will
             wait between two consecutive hello messages from a peer before it
             is marked as being down.  The default value is 15.

     hello-interval seconds
             Set the hello interval in seconds.  The default value is 5; valid
             range is 1-65535.

     keepalive seconds
             Set the keepalive interval in seconds.  The default value is 180;
             valid range is 1-65535.

     distribution (independent|ordered)
             Select the distribution mode.  independent distributes labels at
             any time; ordered forces ldpd(8) to wait a mapping from nexthop
             before distributing it to peers.

     retention (liberal|conservative)
             Select the retention mode.  conservative retains just the labels
             advertised from nexthop; liberal mode retains every label re-
             ceived, even those not advertised from nexthops.

     advertisement (unsolicited|ondemand)
             Select the advertisement mode.  unsolicited advertises labels ac-
             cording to the distribution mode; ondemand advertises labels
             solely upon explicit request from peers.

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

           interface em0 {
           }

     Interface-specific parameters are listed below.

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

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

SEE ALSO
     ldpctl(8), ldpd(8), rc.conf.local(8)

HISTORY
     The ldpd.conf file format first appeared in OpenBSD 4.6.

OpenBSD 4.7                     January 2, 2010                              2
