[mirror_frr.git] / lib / mpls.h

/*
 * MPLS definitions
 * Copyright 2015 Cumulus Networks, Inc.
 *
 * This file is part of GNU Zebra.
 *
 * GNU Zebra is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published
 * by the Free Software Foundation; either version 2, or (at your
 * option) any later version.
 *
 * GNU Zebra is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License along
 * with this program; see the file COPYING; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 */

#ifndef _QUAGGA_MPLS_H
#define _QUAGGA_MPLS_H

#include <zebra.h>
#include <arpa/inet.h>

#ifdef MPLS_LABEL_MAX
#undef MPLS_LABEL_MAX
#endif

#define MPLS_LABEL_HELPSTR                                                     \
	"Specify label(s) for this route\nOne or more "                        \
	"labels in the range (16-1048575) separated by '/'\n"

/* Well-known MPLS label values (RFC 3032 etc). */
#define MPLS_LABEL_IPV4_EXPLICIT_NULL  0       /* [RFC3032] */
#define MPLS_LABEL_ROUTER_ALERT        1       /* [RFC3032] */
#define MPLS_LABEL_IPV6_EXPLICIT_NULL  2       /* [RFC3032] */
#define MPLS_LABEL_IMPLICIT_NULL       3       /* [RFC3032] */
#define MPLS_LABEL_ELI                 7       /* [RFC6790] */
#define MPLS_LABEL_GAL                 13      /* [RFC5586] */
#define MPLS_LABEL_OAM_ALERT           14      /* [RFC3429] */
#define MPLS_LABEL_EXTENSION           15      /* [RFC7274] */
#define MPLS_LABEL_MAX                 1048575
#define MPLS_LABEL_NONE                0xFFFFFFFF /* for internal use only */

/* Minimum and maximum label values */
#define MPLS_LABEL_RESERVED_MIN            0
#define MPLS_LABEL_RESERVED_MAX            15
#define MPLS_LABEL_UNRESERVED_MIN          16
#define MPLS_LABEL_UNRESERVED_MAX          1048575

/* Default min and max SRGB label range */
/* Even if the SRGB allows to manage different Label space between routers,
 * if an operator want to use the same SRGB for all its router, we must fix
 * a common range. However, Cisco start its SRGB at 16000 and Juniper ends
 * its SRGB at 16384 for OSPF. Thus, by fixing the minimum SRGB label to
 * 8000 we could deal with both Cisco and Juniper.
 */
#define MPLS_DEFAULT_MIN_SRGB_LABEL        8000
#define MPLS_DEFAULT_MAX_SRGB_LABEL        50000
#define MPLS_DEFAULT_MIN_SRGB_SIZE         5000
#define MPLS_DEFAULT_MAX_SRGB_SIZE         20000

/* Maximum # labels that can be pushed. */
#define MPLS_MAX_LABELS                    16

#define IS_MPLS_RESERVED_LABEL(label)                                          \
	(label >= MPLS_LABEL_RESERVED_MIN && label <= MPLS_LABEL_RESERVED_MAX)

#define IS_MPLS_UNRESERVED_LABEL(label)                                        \
	(label >= MPLS_LABEL_UNRESERVED_MIN                                    \
	 && label <= MPLS_LABEL_UNRESERVED_MAX)

/* Definitions for a MPLS label stack entry (RFC 3032). This encodes the
 * label, EXP, BOS and TTL fields.
 */
typedef unsigned int mpls_lse_t;

#define MPLS_LS_LABEL_MASK             0xFFFFF000
#define MPLS_LS_LABEL_SHIFT            12
#define MPLS_LS_EXP_MASK               0x00000E00
#define MPLS_LS_EXP_SHIFT              9
#define MPLS_LS_S_MASK                 0x00000100
#define MPLS_LS_S_SHIFT                8
#define MPLS_LS_TTL_MASK               0x000000FF
#define MPLS_LS_TTL_SHIFT              0

#define MPLS_LABEL_VALUE(lse)                                                  \
	((lse & MPLS_LS_LABEL_MASK) >> MPLS_LS_LABEL_SHIFT)
#define MPLS_LABEL_EXP(lse) ((lse & MPLS_LS_EXP_MASK) >> MPLS_LS_EXP_SHIFT)
#define MPLS_LABEL_BOS(lse) ((lse & MPLS_LS_S_MASK) >> MPLS_LS_S_SHIFT)
#define MPLS_LABEL_TTL(lse) ((lse & MPLS_LS_TTL_MASK) >> MPLS_LS_TTL_SHIFT)

#define IS_MPLS_LABEL_BOS(ls)          (MPLS_LABEL_BOS(ls) == 1)

#define MPLS_LABEL_LEN_BITS            20

/* MPLS label value as a 32-bit (mostly we only care about the label value). */
typedef unsigned int mpls_label_t;

struct mpls_label_stack {
	uint8_t num_labels;
	uint8_t reserved[3];
	mpls_label_t label[0]; /* 1 or more labels */
};

/* The MPLS explicit-null label is 0 which means when you memset a mpls_label_t
 * to zero you have set that variable to explicit-null which was probably not
 * your intent. The work-around is to use one bit to indicate if the
 * mpls_label_t has been set by the user. MPLS_INVALID_LABEL has this bit clear
 * so that we can use MPLS_INVALID_LABEL to initialize mpls_label_t variables.
 */
#define MPLS_INVALID_LABEL                 0xFFFDFFFF

/* LSP types. */
enum lsp_types_t {
	ZEBRA_LSP_NONE = 0,   /* No LSP. */
	ZEBRA_LSP_STATIC = 1, /* Static LSP. */
	ZEBRA_LSP_LDP = 2,    /* LDP LSP. */
	ZEBRA_LSP_BGP = 3,    /* BGP LSP. */
	ZEBRA_LSP_SR = 4,     /* Segment Routing LSP. */
	ZEBRA_LSP_SHARP = 5,  /* Identifier for test protocol */
};

/* Functions for basic label operations. */

/* Encode a label stack entry from fields; convert to network byte-order as
 * the Netlink interface expects MPLS labels to be in this format.
 */
static inline mpls_lse_t mpls_lse_encode(mpls_label_t label, uint32_t ttl,
					 uint32_t exp, uint32_t bos)
{
	mpls_lse_t lse;
	lse = htonl((label << MPLS_LS_LABEL_SHIFT) | (exp << MPLS_LS_EXP_SHIFT)
		    | (bos ? (1 << MPLS_LS_S_SHIFT) : 0)
		    | (ttl << MPLS_LS_TTL_SHIFT));
	return lse;
}

/* Extract the fields from a label stack entry after converting to host-byte
 * order. This is expected to be called only for messages received over the
 * Netlink interface.
 */
static inline void mpls_lse_decode(mpls_lse_t lse, mpls_label_t *label,
				   uint32_t *ttl, uint32_t *exp, uint32_t *bos)
{
	mpls_lse_t local_lse;

	local_lse = ntohl(lse);
	*label = MPLS_LABEL_VALUE(local_lse);
	*exp = MPLS_LABEL_EXP(local_lse);
	*bos = MPLS_LABEL_BOS(local_lse);
	*ttl = MPLS_LABEL_TTL(local_lse);
}

/* Invalid label index value (when used with BGP Prefix-SID). Should
 * match the BGP definition.
 */
#define MPLS_INVALID_LABEL_INDEX   0xFFFFFFFF

/* Printable string for labels (with consideration for reserved values). */
static inline char *label2str(mpls_label_t label, char *buf, size_t len)
{
	switch (label) {
	case MPLS_LABEL_IPV4_EXPLICIT_NULL:
		strlcpy(buf, "IPv4 Explicit Null", len);
		return (buf);
	case MPLS_LABEL_ROUTER_ALERT:
		strlcpy(buf, "Router Alert", len);
		return (buf);
	case MPLS_LABEL_IPV6_EXPLICIT_NULL:
		strlcpy(buf, "IPv6 Explicit Null", len);
		return (buf);
	case MPLS_LABEL_IMPLICIT_NULL:
		strlcpy(buf, "implicit-null", len);
		return (buf);
	case MPLS_LABEL_ELI:
		strlcpy(buf, "Entropy Label Indicator", len);
		return (buf);
	case MPLS_LABEL_GAL:
		strlcpy(buf, "Generic Associated Channel", len);
		return (buf);
	case MPLS_LABEL_OAM_ALERT:
		strlcpy(buf, "OAM Alert", len);
		return (buf);
	case MPLS_LABEL_EXTENSION:
		strlcpy(buf, "Extension", len);
		return (buf);
	default:
		if (label < 16)
			snprintf(buf, len, "Reserved (%u)", label);
		else
			snprintf(buf, len, "%u", label);
		return (buf);
	}
}

/*
 * String to label conversion, labels separated by '/'.
 */
int mpls_str2label(const char *label_str, uint8_t *num_labels,
		   mpls_label_t *labels);

/*
 * Label to string conversion, labels in string separated by '/'.
 */
char *mpls_label2str(uint8_t num_labels, mpls_label_t *labels, char *buf,
		     int len, int pretty);

#endif
Commit	Line	Data
50f34207	1	/*
	2	* MPLS definitions
	3	* Copyright 2015 Cumulus Networks, Inc.
	4	*
	5	* This file is part of GNU Zebra.
	6	*
	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.
	11	*
	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.
	16	*
896014f4 DL	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
50f34207	20	*/
	21
	22	#ifndef _QUAGGA_MPLS_H
	23	#define _QUAGGA_MPLS_H
	24
43e52561	25	#include <zebra.h>
fea12efb	26	#include <arpa/inet.h>
fea12efb	27
70e98a7f DS	28	#ifdef MPLS_LABEL_MAX
	29	#undef MPLS_LABEL_MAX
	30	#endif
	31
f890b146 DS	32	#define MPLS_LABEL_HELPSTR \
	33	"Specify label(s) for this route\nOne or more " \
	34	"labels in the range (16-1048575) separated by '/'\n"
	35
50f34207	36	/* Well-known MPLS label values (RFC 3032 etc). */
70e98a7f DS	37	#define MPLS_LABEL_IPV4_EXPLICIT_NULL 0 /* [RFC3032] */
	38	#define MPLS_LABEL_ROUTER_ALERT 1 /* [RFC3032] */
	39	#define MPLS_LABEL_IPV6_EXPLICIT_NULL 2 /* [RFC3032] */
	40	#define MPLS_LABEL_IMPLICIT_NULL 3 /* [RFC3032] */
	41	#define MPLS_LABEL_ELI 7 /* [RFC6790] */
	42	#define MPLS_LABEL_GAL 13 /* [RFC5586] */
	43	#define MPLS_LABEL_OAM_ALERT 14 /* [RFC3429] */
	44	#define MPLS_LABEL_EXTENSION 15 /* [RFC7274] */
	45	#define MPLS_LABEL_MAX 1048575
42567e00	46	#define MPLS_LABEL_NONE 0xFFFFFFFF /* for internal use only */
50f34207	47
50f34207	48	/* Minimum and maximum label values */
70e98a7f DS	49	#define MPLS_LABEL_RESERVED_MIN 0
	50	#define MPLS_LABEL_RESERVED_MAX 15
	51	#define MPLS_LABEL_UNRESERVED_MIN 16
	52	#define MPLS_LABEL_UNRESERVED_MAX 1048575
50f34207	53
12929668	54	/* Default min and max SRGB label range */
7726c479 OD	55	/* Even if the SRGB allows to manage different Label space between routers,
	56	* if an operator want to use the same SRGB for all its router, we must fix
	57	* a common range. However, Cisco start its SRGB at 16000 and Juniper ends
	58	* its SRGB at 16384 for OSPF. Thus, by fixing the minimum SRGB label to
	59	* 8000 we could deal with both Cisco and Juniper.
	60	*/
	61	#define MPLS_DEFAULT_MIN_SRGB_LABEL 8000
cf9b9f77 OD	62	#define MPLS_DEFAULT_MAX_SRGB_LABEL 50000
	63	#define MPLS_DEFAULT_MIN_SRGB_SIZE 5000
	64	#define MPLS_DEFAULT_MAX_SRGB_SIZE 20000
12929668	65
52dd3aa4 RW	66	/* Maximum # labels that can be pushed. */
	67	#define MPLS_MAX_LABELS 16
	68
d62a17ae	69	#define IS_MPLS_RESERVED_LABEL(label) \
70e98a7f	70	(label >= MPLS_LABEL_RESERVED_MIN && label <= MPLS_LABEL_RESERVED_MAX)
50f34207	71
d62a17ae	72	#define IS_MPLS_UNRESERVED_LABEL(label) \
70e98a7f DS	73	(label >= MPLS_LABEL_UNRESERVED_MIN \
70e98a7f DS	74	&& label <= MPLS_LABEL_UNRESERVED_MAX)
50f34207	75
	76	/* Definitions for a MPLS label stack entry (RFC 3032). This encodes the
	77	* label, EXP, BOS and TTL fields.
	78	*/
	79	typedef unsigned int mpls_lse_t;
	80
	81	#define MPLS_LS_LABEL_MASK 0xFFFFF000
	82	#define MPLS_LS_LABEL_SHIFT 12
	83	#define MPLS_LS_EXP_MASK 0x00000E00
	84	#define MPLS_LS_EXP_SHIFT 9
	85	#define MPLS_LS_S_MASK 0x00000100
	86	#define MPLS_LS_S_SHIFT 8
	87	#define MPLS_LS_TTL_MASK 0x000000FF
	88	#define MPLS_LS_TTL_SHIFT 0
	89
d62a17ae	90	#define MPLS_LABEL_VALUE(lse) \
	91	((lse & MPLS_LS_LABEL_MASK) >> MPLS_LS_LABEL_SHIFT)
	92	#define MPLS_LABEL_EXP(lse) ((lse & MPLS_LS_EXP_MASK) >> MPLS_LS_EXP_SHIFT)
	93	#define MPLS_LABEL_BOS(lse) ((lse & MPLS_LS_S_MASK) >> MPLS_LS_S_SHIFT)
	94	#define MPLS_LABEL_TTL(lse) ((lse & MPLS_LS_TTL_MASK) >> MPLS_LS_TTL_SHIFT)
50f34207	95
	96	#define IS_MPLS_LABEL_BOS(ls) (MPLS_LABEL_BOS(ls) == 1)
	97
	98	#define MPLS_LABEL_LEN_BITS 20
	99
	100	/* MPLS label value as a 32-bit (mostly we only care about the label value). */
	101	typedef unsigned int mpls_label_t;
	102
8ecdb26e DS	103	struct mpls_label_stack {
	104	uint8_t num_labels;
	105	uint8_t reserved[3];
	106	mpls_label_t label[0]; /* 1 or more labels */
	107	};
	108
9bedbb1e DW	109	/* The MPLS explicit-null label is 0 which means when you memset a mpls_label_t
	110	* to zero you have set that variable to explicit-null which was probably not
	111	* your intent. The work-around is to use one bit to indicate if the
	112	* mpls_label_t has been set by the user. MPLS_INVALID_LABEL has this bit clear
	113	* so that we can use MPLS_INVALID_LABEL to initialize mpls_label_t variables.
	114	*/
	115	#define MPLS_INVALID_LABEL 0xFFFDFFFF
50f34207	116
ce549947	117	/* LSP types. */
d62a17ae	118	enum lsp_types_t {
	119	ZEBRA_LSP_NONE = 0, /* No LSP. */
	120	ZEBRA_LSP_STATIC = 1, /* Static LSP. */
	121	ZEBRA_LSP_LDP = 2, /* LDP LSP. */
cf9b9f77	122	ZEBRA_LSP_BGP = 3, /* BGP LSP. */
339e36d2 DS	123	ZEBRA_LSP_SR = 4, /* Segment Routing LSP. */
339e36d2 DS	124	ZEBRA_LSP_SHARP = 5, /* Identifier for test protocol */
ce549947 RW	125	};
ce549947 RW	126
50f34207	127	/* Functions for basic label operations. */
	128
	129	/* Encode a label stack entry from fields; convert to network byte-order as
	130	* the Netlink interface expects MPLS labels to be in this format.
	131	*/
d7c0a89a QY	132	static inline mpls_lse_t mpls_lse_encode(mpls_label_t label, uint32_t ttl,
d7c0a89a QY	133	uint32_t exp, uint32_t bos)
50f34207	134	{
d62a17ae	135	mpls_lse_t lse;
	136	lse = htonl((label << MPLS_LS_LABEL_SHIFT) \| (exp << MPLS_LS_EXP_SHIFT)
	137	\| (bos ? (1 << MPLS_LS_S_SHIFT) : 0)
	138	\| (ttl << MPLS_LS_TTL_SHIFT));
	139	return lse;
50f34207	140	}
	141
	142	/* Extract the fields from a label stack entry after converting to host-byte
	143	* order. This is expected to be called only for messages received over the
	144	* Netlink interface.
	145	*/
d62a17ae	146	static inline void mpls_lse_decode(mpls_lse_t lse, mpls_label_t *label,
d7c0a89a	147	uint32_t ttl, uint32_t exp, uint32_t *bos)
50f34207	148	{
d62a17ae	149	mpls_lse_t local_lse;
50f34207	150
d62a17ae	151	local_lse = ntohl(lse);
	152	*label = MPLS_LABEL_VALUE(local_lse);
	153	*exp = MPLS_LABEL_EXP(local_lse);
	154	*bos = MPLS_LABEL_BOS(local_lse);
	155	*ttl = MPLS_LABEL_TTL(local_lse);
50f34207	156	}
50f34207	157
28d58fd7 VV	158	/* Invalid label index value (when used with BGP Prefix-SID). Should
	159	* match the BGP definition.
	160	*/
	161	#define MPLS_INVALID_LABEL_INDEX 0xFFFFFFFF
	162
50f34207	163	/* Printable string for labels (with consideration for reserved values). */
d62a17ae	164	static inline char label2str(mpls_label_t label, char buf, size_t len)
50f34207	165	{
d62a17ae	166	switch (label) {
70e98a7f	167	case MPLS_LABEL_IPV4_EXPLICIT_NULL:
d62a17ae	168	strlcpy(buf, "IPv4 Explicit Null", len);
d62a17ae	169	return (buf);
70e98a7f	170	case MPLS_LABEL_ROUTER_ALERT:
d62a17ae	171	strlcpy(buf, "Router Alert", len);
d62a17ae	172	return (buf);
70e98a7f	173	case MPLS_LABEL_IPV6_EXPLICIT_NULL:
0437e105	174	strlcpy(buf, "IPv6 Explicit Null", len);
d62a17ae	175	return (buf);
70e98a7f	176	case MPLS_LABEL_IMPLICIT_NULL:
d62a17ae	177	strlcpy(buf, "implicit-null", len);
d62a17ae	178	return (buf);
70e98a7f	179	case MPLS_LABEL_ELI:
d62a17ae	180	strlcpy(buf, "Entropy Label Indicator", len);
d62a17ae	181	return (buf);
70e98a7f	182	case MPLS_LABEL_GAL:
d62a17ae	183	strlcpy(buf, "Generic Associated Channel", len);
d62a17ae	184	return (buf);
70e98a7f	185	case MPLS_LABEL_OAM_ALERT:
d62a17ae	186	strlcpy(buf, "OAM Alert", len);
d62a17ae	187	return (buf);
70e98a7f	188	case MPLS_LABEL_EXTENSION:
d62a17ae	189	strlcpy(buf, "Extension", len);
	190	return (buf);
	191	default:
	192	if (label < 16)
	193	snprintf(buf, len, "Reserved (%u)", label);
	194	else
	195	snprintf(buf, len, "%u", label);
	196	return (buf);
	197	}
50f34207	198	}
50f34207	199
036fdaad DS	200	/*
	201	* String to label conversion, labels separated by '/'.
	202	*/
	203	int mpls_str2label(const char label_str, uint8_t num_labels,
	204	mpls_label_t *labels);
	205
	206	/*
	207	* Label to string conversion, labels in string separated by '/'.
	208	*/
	209	char mpls_label2str(uint8_t num_labels, mpls_label_t labels, char *buf,
	210	int len, int pretty);
eac6e3f0	211
50f34207	212	#endif