xref: /linux/include/net/inet_dscp.h (revision 249ebf3f65f8530beb2cbfb91bff1d83ba88d23c)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * inet_dscp.h: helpers for handling differentiated services codepoints (DSCP)
4  *
5  * DSCP is defined in RFC 2474:
6  *
7  *        0   1   2   3   4   5   6   7
8  *      +---+---+---+---+---+---+---+---+
9  *      |         DSCP          |  CU   |
10  *      +---+---+---+---+---+---+---+---+
11  *
12  *        DSCP: differentiated services codepoint
13  *        CU:   currently unused
14  *
15  * The whole DSCP + CU bits form the DS field.
16  * The DS field is also commonly called TOS or Traffic Class (for IPv6).
17  *
18  * Note: the CU bits are now used for Explicit Congestion Notification
19  *       (RFC 3168).
20  */
21 
22 #ifndef _INET_DSCP_H
23 #define _INET_DSCP_H
24 
25 #include <linux/types.h>
26 
27 /* Special type for storing DSCP values.
28  *
29  * A dscp_t variable stores a DS field with the CU (ECN) bits cleared.
30  * Using dscp_t allows to strictly separate DSCP and ECN bits, thus avoiding
31  * bugs where ECN bits are erroneously taken into account during FIB lookups
32  * or policy routing.
33  *
34  * Note: to get the real DSCP value contained in a dscp_t variable one would
35  * have to do a bit shift after calling inet_dscp_to_dsfield(). We could have
36  * a helper for that, but there's currently no users.
37  */
38 typedef u8 __bitwise dscp_t;
39 
40 #define INET_DSCP_MASK 0xfc
41 
42 static inline dscp_t inet_dsfield_to_dscp(__u8 dsfield)
43 {
44 	return (__force dscp_t)(dsfield & INET_DSCP_MASK);
45 }
46 
47 static inline __u8 inet_dscp_to_dsfield(dscp_t dscp)
48 {
49 	return (__force __u8)dscp;
50 }
51 
52 static inline bool inet_validate_dscp(__u8 val)
53 {
54 	return !(val & ~INET_DSCP_MASK);
55 }
56 
57 #endif /* _INET_DSCP_H */
58