3 * Copyright 2015 Cumulus Networks, Inc.
5 * This file is part of GNU Zebra.
7 * GNU Zebra is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published
9 * by the Free Software Foundation; either version 2, or (at your
10 * option) any later version.
12 * GNU Zebra is distributed in the hope that it will be useful, but
13 * WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * General Public License for more details.
17 * You should have received a copy of the GNU General Public License along
18 * with this program; see the file COPYING; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
22 #ifndef _QUAGGA_MPLS_H
23 #define _QUAGGA_MPLS_H
25 #include <arpa/inet.h>
27 /* Well-known MPLS label values (RFC 3032 etc). */
28 #define MPLS_V4_EXP_NULL_LABEL 0
29 #define MPLS_RA_LABEL 1
30 #define MPLS_V6_EXP_NULL_LABEL 2
31 #define MPLS_IMP_NULL_LABEL 3
32 #define MPLS_ENTROPY_LABEL_INDICATOR 7
33 #define MPLS_GAL_LABEL 13
34 #define MPLS_OAM_ALERT_LABEL 14
35 #define MPLS_EXTENSION_LABEL 15
37 /* Minimum and maximum label values */
38 #define MPLS_MIN_RESERVED_LABEL 0
39 #define MPLS_MAX_RESERVED_LABEL 15
40 #define MPLS_MIN_UNRESERVED_LABEL 16
41 #define MPLS_MAX_UNRESERVED_LABEL 1048575
43 /* Default min and max SRGB label range */
44 #define MPLS_DEFAULT_MIN_SRGB_LABEL 16000
45 #define MPLS_DEFAULT_MAX_SRGB_LABEL 23999
47 #define IS_MPLS_RESERVED_LABEL(label) \
48 (label >= MPLS_MIN_RESERVED_LABEL && label <= MPLS_MAX_RESERVED_LABEL)
50 #define IS_MPLS_UNRESERVED_LABEL(label) \
51 (label >= MPLS_MIN_UNRESERVED_LABEL \
52 && label <= MPLS_MAX_UNRESERVED_LABEL)
54 /* Definitions for a MPLS label stack entry (RFC 3032). This encodes the
55 * label, EXP, BOS and TTL fields.
57 typedef unsigned int mpls_lse_t
;
59 #define MPLS_LS_LABEL_MASK 0xFFFFF000
60 #define MPLS_LS_LABEL_SHIFT 12
61 #define MPLS_LS_EXP_MASK 0x00000E00
62 #define MPLS_LS_EXP_SHIFT 9
63 #define MPLS_LS_S_MASK 0x00000100
64 #define MPLS_LS_S_SHIFT 8
65 #define MPLS_LS_TTL_MASK 0x000000FF
66 #define MPLS_LS_TTL_SHIFT 0
68 #define MPLS_LABEL_VALUE(lse) \
69 ((lse & MPLS_LS_LABEL_MASK) >> MPLS_LS_LABEL_SHIFT)
70 #define MPLS_LABEL_EXP(lse) ((lse & MPLS_LS_EXP_MASK) >> MPLS_LS_EXP_SHIFT)
71 #define MPLS_LABEL_BOS(lse) ((lse & MPLS_LS_S_MASK) >> MPLS_LS_S_SHIFT)
72 #define MPLS_LABEL_TTL(lse) ((lse & MPLS_LS_TTL_MASK) >> MPLS_LS_TTL_SHIFT)
74 #define IS_MPLS_LABEL_BOS(ls) (MPLS_LABEL_BOS(ls) == 1)
76 #define MPLS_LABEL_LEN_BITS 20
78 /* MPLS label value as a 32-bit (mostly we only care about the label value). */
79 typedef unsigned int mpls_label_t
;
81 /* The MPLS explicit-null label is 0 which means when you memset a mpls_label_t
82 * to zero you have set that variable to explicit-null which was probably not
83 * your intent. The work-around is to use one bit to indicate if the
84 * mpls_label_t has been set by the user. MPLS_INVALID_LABEL has this bit clear
85 * so that we can use MPLS_INVALID_LABEL to initialize mpls_label_t variables.
87 #define MPLS_INVALID_LABEL 0xFFFDFFFF
91 ZEBRA_LSP_NONE
= 0, /* No LSP. */
92 ZEBRA_LSP_STATIC
= 1, /* Static LSP. */
93 ZEBRA_LSP_LDP
= 2, /* LDP LSP. */
94 ZEBRA_LSP_BGP
= 3 /* BGP LSP. */
97 /* Functions for basic label operations. */
99 /* Encode a label stack entry from fields; convert to network byte-order as
100 * the Netlink interface expects MPLS labels to be in this format.
102 static inline mpls_lse_t
mpls_lse_encode(mpls_label_t label
, u_int32_t ttl
,
103 u_int32_t exp
, u_int32_t bos
)
106 lse
= htonl((label
<< MPLS_LS_LABEL_SHIFT
) | (exp
<< MPLS_LS_EXP_SHIFT
)
107 | (bos
? (1 << MPLS_LS_S_SHIFT
) : 0)
108 | (ttl
<< MPLS_LS_TTL_SHIFT
));
112 /* Extract the fields from a label stack entry after converting to host-byte
113 * order. This is expected to be called only for messages received over the
116 static inline void mpls_lse_decode(mpls_lse_t lse
, mpls_label_t
*label
,
117 u_int32_t
*ttl
, u_int32_t
*exp
,
120 mpls_lse_t local_lse
;
122 local_lse
= ntohl(lse
);
123 *label
= MPLS_LABEL_VALUE(local_lse
);
124 *exp
= MPLS_LABEL_EXP(local_lse
);
125 *bos
= MPLS_LABEL_BOS(local_lse
);
126 *ttl
= MPLS_LABEL_TTL(local_lse
);
129 /* Invalid label index value (when used with BGP Prefix-SID). Should
130 * match the BGP definition.
132 #define MPLS_INVALID_LABEL_INDEX 0xFFFFFFFF
134 /* Printable string for labels (with consideration for reserved values). */
135 static inline char *label2str(mpls_label_t label
, char *buf
, size_t len
)
138 case MPLS_V4_EXP_NULL_LABEL
:
139 strlcpy(buf
, "IPv4 Explicit Null", len
);
142 strlcpy(buf
, "Router Alert", len
);
144 case MPLS_V6_EXP_NULL_LABEL
:
145 strlcpy(buf
, "IPv6 Explict Null", len
);
147 case MPLS_IMP_NULL_LABEL
:
148 strlcpy(buf
, "implicit-null", len
);
150 case MPLS_ENTROPY_LABEL_INDICATOR
:
151 strlcpy(buf
, "Entropy Label Indicator", len
);
154 strlcpy(buf
, "Generic Associated Channel", len
);
156 case MPLS_OAM_ALERT_LABEL
:
157 strlcpy(buf
, "OAM Alert", len
);
159 case MPLS_EXTENSION_LABEL
:
160 strlcpy(buf
, "Extension", len
);
164 snprintf(buf
, len
, "Reserved (%u)", label
);
166 snprintf(buf
, len
, "%u", label
);
171 /* constants used by ldpd */
172 #define MPLS_LABEL_IPV4NULL 0 /* IPv4 Explicit NULL Label */
173 #define MPLS_LABEL_RTALERT 1 /* Router Alert Label */
174 #define MPLS_LABEL_IPV6NULL 2 /* IPv6 Explicit NULL Label */
175 #define MPLS_LABEL_IMPLNULL 3 /* Implicit NULL Label */
176 /* MPLS_LABEL_RESERVED 4-15 */ /* Values 4-15 are reserved */
177 #define MPLS_LABEL_RESERVED_MAX 15
178 #define MPLS_LABEL_MAX ((1 << 20) - 1)