2 * Copyright (c) 2008, 2010, 2011 Nicira Networks.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at:
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
17 #ifndef NETLINK_PROTOCOL_H
18 #define NETLINK_PROTOCOL_H 1
20 /* Netlink protocol definitions.
22 * Netlink is a message framing format described in RFC 3549 and used heavily
23 * in Linux to access the network stack. Open vSwitch uses AF_NETLINK sockets
24 * for this purpose on Linux. But on all platforms, Open vSwitch uses Netlink
25 * message framing internally for certain purposes.
27 * This header provides access to the Netlink message framing definitions
28 * regardless of platform. On Linux, it includes the proper headers directly;
29 * on other platforms it directly defines the structures and macros itself.
33 #include <sys/socket.h>
37 #include <linux/netlink.h>
38 #include <linux/genetlink.h>
40 /* Some Xenddks have an outdated genetlink header file which doesn't have some
41 * symbols it should. */
42 #ifndef CTRL_ATTR_MCAST_GRP_MAX
45 #define CTRL_ATTR_MAX 7
46 #define CTRL_ATTR_MCAST_GROUPS 7
49 CTRL_ATTR_MCAST_GRP_UNSPEC,
50 CTRL_ATTR_MCAST_GRP_NAME,
51 CTRL_ATTR_MCAST_GRP_ID,
52 __CTRL_ATTR_MCAST_GRP_MAX,
55 #define CTRL_ATTR_MCAST_GRP_MAX (__CTRL_ATTR_MCAST_GRP_MAX - 1)
56 #endif /* CTRL_ATTR_MCAST_GRP_MAX */
59 #define NETLINK_GENERIC 16
62 sa_family_t nl_family;
63 unsigned short int nl_pad;
67 BUILD_ASSERT_DECL(sizeof(struct sockaddr_nl) == 12);
69 /* nlmsg_flags bits. */
70 #define NLM_F_REQUEST 0x001
71 #define NLM_F_MULTI 0x002
72 #define NLM_F_ACK 0x004
73 #define NLM_F_ECHO 0x008
75 #define NLM_F_ROOT 0x100
76 #define NLM_F_MATCH 0x200
77 #define NLM_F_ATOMIC 0x400
78 #define NLM_F_DUMP (NLM_F_ROOT | NLM_F_MATCH)
80 /* nlmsg_type values. */
84 #define NLMSG_OVERRUN 4
86 #define NLMSG_MIN_TYPE 0x10
95 BUILD_ASSERT_DECL(sizeof(struct nlmsghdr) == 16);
97 #define NLMSG_ALIGNTO 4
98 #define NLMSG_ALIGN(SIZE) ROUND_UP(SIZE, NLMSG_ALIGNTO)
99 #define NLMSG_HDRLEN ((int) NLMSG_ALIGN(sizeof(struct nlmsghdr)))
106 BUILD_ASSERT_DECL(sizeof(struct nlmsgerr) == 20);
113 BUILD_ASSERT_DECL(sizeof(struct genlmsghdr) == 4);
115 #define GENL_HDRLEN NLMSG_ALIGN(sizeof(struct genlmsghdr))
121 BUILD_ASSERT_DECL(sizeof(struct nlattr) == 4);
123 #define NLA_ALIGNTO 4
124 #define NLA_ALIGN(SIZE) ROUND_UP(SIZE, NLA_ALIGNTO)
125 #define NLA_HDRLEN ((int) NLA_ALIGN(sizeof(struct nlattr)))
127 #define GENL_MIN_ID NLMSG_MIN_TYPE
128 #define GENL_MAX_ID 1023
130 #define GENL_ID_CTRL NLMSG_MIN_TYPE
143 #define CTRL_CMD_MAX (__CTRL_CMD_MAX - 1)
148 CTRL_ATTR_FAMILY_NAME,
156 #define CTRL_ATTR_MAX (__CTRL_ATTR_MAX - 1)
165 #define CTRL_ATTR_OP_MAX (__CTRL_ATTR_OP_MAX - 1)
166 #endif /* !HAVE_NETLINK */
168 /* These were introduced all together in 2.6.24. */
169 #ifndef NLA_TYPE_MASK
170 #define NLA_F_NESTED (1 << 15)
171 #define NLA_F_NET_BYTEORDER (1 << 14)
172 #define NLA_TYPE_MASK ~(NLA_F_NESTED | NLA_F_NET_BYTEORDER)
175 /* These were introduced all together in 2.6.14. (We want our programs to
176 * support the newer kernel features even if compiled with older headers.) */
177 #ifndef NETLINK_ADD_MEMBERSHIP
178 #define NETLINK_ADD_MEMBERSHIP 1
179 #define NETLINK_DROP_MEMBERSHIP 2
182 #endif /* netlink-protocol.h */