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 5036.

SECTIONS
The ldpd.conf config file is divided into four 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.

Targeted Neighbors Configuration
    Targeted neighbor 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
All interface related settings can be configured globally and per interface. The only settings that can be set globally and not overruled are listed below.

    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.

keepalive seconds
    Set the keepalive timeout 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.

    targeted-hello-accept (yes|no) If set to yes, allow LDP sessions to be established with remote neighbors that have not been specifically configured. The default is no.

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

    interface em0 {
    }

Interface-specific parameters are listed below.

link-hello-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.

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

TARGETED NEIGHBORS
Each targeted neighbor can have several parameters configured individually, otherwise they are inherited.

    targeted-neighbor A.B.C.D {
    }

Targeted-neighbor specific parameters are listed below.

targeted-hello-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 45.

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

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.