xref: /openbsd/usr.sbin/ldpd/ldpd.8 (revision 4bdff4be)
1.\"	$OpenBSD: ldpd.8,v 1.22 2023/03/02 17:09:53 jmc Exp $
2.\"
3.\" Copyright (c) 2013, 2016 Renato Westphal <renato@openbsd.org>
4.\" Copyright (c) 2009 Michele Marchetto <michele@openbsd.org>
5.\" Copyright (c) 2004, 2005, 2006 Esben Norby <norby@openbsd.org>
6.\"
7.\" Permission to use, copy, modify, and distribute this software for any
8.\" purpose with or without fee is hereby granted, provided that the above
9.\" copyright notice and this permission notice appear in all copies.
10.\"
11.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18.\"
19.Dd $Mdocdate: March 2 2023 $
20.Dt LDPD 8
21.Os
22.Sh NAME
23.Nm ldpd
24.Nd Label Distribution Protocol (LDP) routing daemon
25.Sh SYNOPSIS
26.Nm
27.Op Fl dnv
28.Op Fl D Ar macro Ns = Ns Ar value
29.Op Fl f Ar file
30.Op Fl s Ar socket
31.Sh DESCRIPTION
32.Nm
33is the Label Distribution Protocol
34.Pq LDP
35daemon, which distributes MPLS label mappings between routers.
36.Pp
37A running
38.Nm
39can be controlled with the
40.Xr ldpctl 8
41utility.
42.Pp
43The options are as follows:
44.Bl -tag -width Ds
45.It Fl D Ar macro Ns = Ns Ar value
46Define
47.Ar macro
48to be set to
49.Ar value
50on the command line.
51Overrides the definition of
52.Ar macro
53in the configuration file.
54.It Fl d
55Do not daemonize.
56If this option is specified,
57.Nm
58will run in the foreground and log to
59.Em stderr .
60.It Fl f Ar file
61Specify an alternative configuration file.
62.It Fl n
63Configtest mode.
64Only check the configuration file for validity.
65.It Fl s Ar socket
66Use an alternate location for the default control socket.
67.It Fl v
68Produce more verbose output.
69.El
70.Sh FILES
71.Bl -tag -width "/var/run/ldpd.sockXX" -compact
72.It Pa /etc/ldpd.conf
73Default
74.Nm
75configuration file.
76.It Pa /var/run/ldpd.sock
77.Ux Ns -domain
78socket used for communication with
79.Xr ldpctl 8 .
80.El
81.Sh SEE ALSO
82.Xr mpe 4 ,
83.Xr ldpd.conf 5 ,
84.Xr ldpctl 8 ,
85.Xr rc.conf 8
86.Sh STANDARDS
87.Rs
88.%A E. Rosen
89.%A A. Viswanathan
90.%A R. Callon
91.%D January 2001
92.%R RFC 3031
93.%T Multiprotocol Label Switching Architecture
94.Re
95.Pp
96.Rs
97.%A S. Bryant
98.%A G. Swallow
99.%A L. Martini
100.%A D. McPherson
101.%D February 2006
102.%R RFC 4385
103.%T Pseudowire Emulation Edge-to-Edge (PWE3) Control Word for Use over an MPLS PSN
104.Re
105.Pp
106.Rs
107.%A L. Martini
108.%A E. Rosen
109.%A N. El-Aawar
110.%A T. Smith
111.%A G. Heron
112.%D April 2006
113.%R RFC 4447
114.%T Pseudowire Setup and Maintenance Using the Label Distribution Protocol (LDP)
115.Re
116.Pp
117.Rs
118.%A M. Lasserre
119.%A V. Kompella
120.%D January 2007
121.%R RFC 4762
122.%T Virtual Private LAN Service (VPLS) Using Label Distribution Protocol (LDP) Signaling
123.Re
124.Pp
125.Rs
126.%A L. Andersson
127.%A I. Minei
128.%A B. Thomas
129.%D October 2007
130.%R RFC 5036
131.%T LDP Specification
132.Re
133.Pp
134.Rs
135.%A B. Thomas
136.%A K. Raza
137.%A S. Aggarwal
138.%A R. Aggarwal
139.%A JL. Le Roux
140.%D July 2009
141.%R RFC 5561
142.%T LDP Capabilities
143.Re
144.Pp
145.Rs
146.%A R. Asati
147.%A I. Minei
148.%A B. Thomas
149.%D August 2010
150.%R RFC 5918
151.%T Label Distribution Protocol (LDP) 'Typed Wildcard' Forward Equivalence Class (FEC)
152.Re
153.Pp
154.Rs
155.%A R. Asati
156.%A P. Mohapatra
157.%A E. Chen
158.%A B. Thomas
159.%D August 2010
160.%R RFC 5919
161.%T Signaling LDP Label Advertisement Completion
162.Re
163.Pp
164.Rs
165.%A K. Raza
166.%A S. Boutros
167.%A C. Pignataro
168.%D July 2012
169.%R RFC 6667
170.%T LDP 'Typed Wildcard' Forwarding Equivalence Class (FEC) for PWid and Generalized PWid FEC Elements
171.Re
172.Pp
173.Rs
174.%A C. Pignataro
175.%A R. Asati
176.%D August 2012
177.%R RFC 6720
178.%T The Generalized TTL Security Mechanism (GTSM) for the Label Distribution Protocol (LDP)
179.Re
180.Pp
181.Rs
182.%A R. Asati
183.%A C. Pignataro
184.%A K. Raza
185.%A V. Manral
186.%A R. Papneja
187.%D June 2015
188.%R RFC 7552
189.%T Updates to LDP for IPv6
190.Re
191.Sh HISTORY
192The
193.Nm
194program first appeared in
195.Ox 4.6 .
196