OpenBSD manual page server

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.