LDPD.CONF(5)

NAME
ldpd.conf - Label Distribution Protocol daemon configuration file

DESCRIPTION
The ldpd(8) daemon implements the Label Distribution Protocol as described 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 expanded in context. Macro names must start with a letter, digit, or underscore, and may contain any of those characters. 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 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 received, even those not advertised from nexthops.

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

INTERFACES
Each interface can have several parameters configured individually, otherwise they are inherited.

    interface em0 {
    }

Interface-specific parameters are listed below.

passive
    Prevent transmission and reception of LDP packets on this interface.

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.