Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 1 | #ifndef __NET_GENERIC_NETLINK_H |
| 2 | #define __NET_GENERIC_NETLINK_H |
| 3 | |
| 4 | #include <linux/genetlink.h> |
| 5 | #include <net/netlink.h> |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 6 | #include <net/net_namespace.h> |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 7 | |
| 8 | /** |
Johannes Berg | 2dbba6f | 2007-07-18 15:47:52 -0700 | [diff] [blame] | 9 | * struct genl_multicast_group - generic netlink multicast group |
| 10 | * @name: name of the multicast group, names are per-family |
| 11 | * @id: multicast group ID, assigned by the core, to use with |
| 12 | * genlmsg_multicast(). |
| 13 | * @list: list entry for linking |
| 14 | * @family: pointer to family, need not be set before registering |
| 15 | */ |
Eric Dumazet | fd2c3ef | 2009-11-03 03:26:03 +0000 | [diff] [blame] | 16 | struct genl_multicast_group { |
Johannes Berg | 2dbba6f | 2007-07-18 15:47:52 -0700 | [diff] [blame] | 17 | struct genl_family *family; /* private */ |
| 18 | struct list_head list; /* private */ |
| 19 | char name[GENL_NAMSIZ]; |
| 20 | u32 id; |
| 21 | }; |
| 22 | |
| 23 | /** |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 24 | * struct genl_family - generic netlink family |
| 25 | * @id: protocol family idenfitier |
| 26 | * @hdrsize: length of user specific header in bytes |
| 27 | * @name: name of family |
| 28 | * @version: protocol version |
| 29 | * @maxattr: maximum number of attributes supported |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 30 | * @netnsok: set to true if the family can handle network |
| 31 | * namespaces and should be presented in all of them |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 32 | * @attrbuf: buffer to store parsed attributes |
| 33 | * @ops_list: list of all assigned operations |
| 34 | * @family_list: family list |
Johannes Berg | 2dbba6f | 2007-07-18 15:47:52 -0700 | [diff] [blame] | 35 | * @mcast_groups: multicast groups list |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 36 | */ |
Eric Dumazet | fd2c3ef | 2009-11-03 03:26:03 +0000 | [diff] [blame] | 37 | struct genl_family { |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 38 | unsigned int id; |
| 39 | unsigned int hdrsize; |
| 40 | char name[GENL_NAMSIZ]; |
| 41 | unsigned int version; |
| 42 | unsigned int maxattr; |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 43 | bool netnsok; |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 44 | struct nlattr ** attrbuf; /* private */ |
| 45 | struct list_head ops_list; /* private */ |
| 46 | struct list_head family_list; /* private */ |
Johannes Berg | 2dbba6f | 2007-07-18 15:47:52 -0700 | [diff] [blame] | 47 | struct list_head mcast_groups; /* private */ |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 48 | }; |
| 49 | |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 50 | /** |
| 51 | * struct genl_info - receiving information |
| 52 | * @snd_seq: sending sequence number |
| 53 | * @snd_pid: netlink pid of sender |
| 54 | * @nlhdr: netlink message header |
| 55 | * @genlhdr: generic netlink message header |
| 56 | * @userhdr: user specific header |
| 57 | * @attrs: netlink attributes |
| 58 | */ |
Eric Dumazet | fd2c3ef | 2009-11-03 03:26:03 +0000 | [diff] [blame] | 59 | struct genl_info { |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 60 | u32 snd_seq; |
| 61 | u32 snd_pid; |
| 62 | struct nlmsghdr * nlhdr; |
| 63 | struct genlmsghdr * genlhdr; |
| 64 | void * userhdr; |
| 65 | struct nlattr ** attrs; |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 66 | #ifdef CONFIG_NET_NS |
| 67 | struct net * _net; |
| 68 | #endif |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 69 | }; |
| 70 | |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 71 | static inline struct net *genl_info_net(struct genl_info *info) |
| 72 | { |
Eric Dumazet | c2d9ba9 | 2010-06-01 06:51:19 +0000 | [diff] [blame] | 73 | return read_pnet(&info->_net); |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 74 | } |
| 75 | |
| 76 | static inline void genl_info_net_set(struct genl_info *info, struct net *net) |
| 77 | { |
Eric Dumazet | c2d9ba9 | 2010-06-01 06:51:19 +0000 | [diff] [blame] | 78 | write_pnet(&info->_net, net); |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 79 | } |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 80 | |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 81 | /** |
| 82 | * struct genl_ops - generic netlink operations |
| 83 | * @cmd: command identifier |
| 84 | * @flags: flags |
| 85 | * @policy: attribute validation policy |
| 86 | * @doit: standard command callback |
| 87 | * @dumpit: callback for dumpers |
Jamal Hadi Salim | a4d1366 | 2006-12-01 20:07:42 -0800 | [diff] [blame] | 88 | * @done: completion callback for dumps |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 89 | * @ops_list: operations list |
| 90 | */ |
Eric Dumazet | fd2c3ef | 2009-11-03 03:26:03 +0000 | [diff] [blame] | 91 | struct genl_ops { |
Per Liden | b461d2f2 | 2006-01-03 14:13:29 -0800 | [diff] [blame] | 92 | u8 cmd; |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 93 | unsigned int flags; |
Patrick McHardy | ef7c79e | 2007-06-05 12:38:30 -0700 | [diff] [blame] | 94 | const struct nla_policy *policy; |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 95 | int (*doit)(struct sk_buff *skb, |
| 96 | struct genl_info *info); |
| 97 | int (*dumpit)(struct sk_buff *skb, |
| 98 | struct netlink_callback *cb); |
Jamal Hadi Salim | a4d1366 | 2006-12-01 20:07:42 -0800 | [diff] [blame] | 99 | int (*done)(struct netlink_callback *cb); |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 100 | struct list_head ops_list; |
| 101 | }; |
| 102 | |
| 103 | extern int genl_register_family(struct genl_family *family); |
Michał Mirosław | a7b11d7 | 2009-05-21 10:34:04 +0000 | [diff] [blame] | 104 | extern int genl_register_family_with_ops(struct genl_family *family, |
| 105 | struct genl_ops *ops, size_t n_ops); |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 106 | extern int genl_unregister_family(struct genl_family *family); |
| 107 | extern int genl_register_ops(struct genl_family *, struct genl_ops *ops); |
| 108 | extern int genl_unregister_ops(struct genl_family *, struct genl_ops *ops); |
Johannes Berg | 2dbba6f | 2007-07-18 15:47:52 -0700 | [diff] [blame] | 109 | extern int genl_register_mc_group(struct genl_family *family, |
| 110 | struct genl_multicast_group *grp); |
| 111 | extern void genl_unregister_mc_group(struct genl_family *family, |
| 112 | struct genl_multicast_group *grp); |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 113 | |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 114 | /** |
| 115 | * genlmsg_put - Add generic netlink header to netlink message |
| 116 | * @skb: socket buffer holding the message |
| 117 | * @pid: netlink pid the message is addressed to |
| 118 | * @seq: sequence number (usually the one of the sender) |
Thomas Graf | 17c157c | 2006-11-14 19:46:02 -0800 | [diff] [blame] | 119 | * @family: generic netlink family |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 120 | * @flags netlink message flags |
| 121 | * @cmd: generic netlink command |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 122 | * |
| 123 | * Returns pointer to user specific header |
| 124 | */ |
| 125 | static inline void *genlmsg_put(struct sk_buff *skb, u32 pid, u32 seq, |
Thomas Graf | 17c157c | 2006-11-14 19:46:02 -0800 | [diff] [blame] | 126 | struct genl_family *family, int flags, u8 cmd) |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 127 | { |
| 128 | struct nlmsghdr *nlh; |
| 129 | struct genlmsghdr *hdr; |
| 130 | |
Thomas Graf | 17c157c | 2006-11-14 19:46:02 -0800 | [diff] [blame] | 131 | nlh = nlmsg_put(skb, pid, seq, family->id, GENL_HDRLEN + |
| 132 | family->hdrsize, flags); |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 133 | if (nlh == NULL) |
| 134 | return NULL; |
| 135 | |
| 136 | hdr = nlmsg_data(nlh); |
| 137 | hdr->cmd = cmd; |
Thomas Graf | 17c157c | 2006-11-14 19:46:02 -0800 | [diff] [blame] | 138 | hdr->version = family->version; |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 139 | hdr->reserved = 0; |
| 140 | |
| 141 | return (char *) hdr + GENL_HDRLEN; |
| 142 | } |
| 143 | |
| 144 | /** |
Thomas Graf | 17c157c | 2006-11-14 19:46:02 -0800 | [diff] [blame] | 145 | * genlmsg_put_reply - Add generic netlink header to a reply message |
| 146 | * @skb: socket buffer holding the message |
| 147 | * @info: receiver info |
| 148 | * @family: generic netlink family |
| 149 | * @flags: netlink message flags |
| 150 | * @cmd: generic netlink command |
| 151 | * |
| 152 | * Returns pointer to user specific header |
| 153 | */ |
| 154 | static inline void *genlmsg_put_reply(struct sk_buff *skb, |
| 155 | struct genl_info *info, |
| 156 | struct genl_family *family, |
| 157 | int flags, u8 cmd) |
| 158 | { |
| 159 | return genlmsg_put(skb, info->snd_pid, info->snd_seq, family, |
| 160 | flags, cmd); |
| 161 | } |
| 162 | |
| 163 | /** |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 164 | * genlmsg_end - Finalize a generic netlink message |
| 165 | * @skb: socket buffer the message is stored in |
| 166 | * @hdr: user specific header |
| 167 | */ |
| 168 | static inline int genlmsg_end(struct sk_buff *skb, void *hdr) |
| 169 | { |
| 170 | return nlmsg_end(skb, hdr - GENL_HDRLEN - NLMSG_HDRLEN); |
| 171 | } |
| 172 | |
| 173 | /** |
| 174 | * genlmsg_cancel - Cancel construction of a generic netlink message |
| 175 | * @skb: socket buffer the message is stored in |
| 176 | * @hdr: generic netlink message header |
| 177 | */ |
Thomas Graf | bc3ed28 | 2008-06-03 16:36:54 -0700 | [diff] [blame] | 178 | static inline void genlmsg_cancel(struct sk_buff *skb, void *hdr) |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 179 | { |
Thomas Graf | bc3ed28 | 2008-06-03 16:36:54 -0700 | [diff] [blame] | 180 | nlmsg_cancel(skb, hdr - GENL_HDRLEN - NLMSG_HDRLEN); |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 181 | } |
| 182 | |
| 183 | /** |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 184 | * genlmsg_multicast_netns - multicast a netlink message to a specific netns |
| 185 | * @net: the net namespace |
| 186 | * @skb: netlink message as socket buffer |
| 187 | * @pid: own netlink pid to avoid sending to yourself |
| 188 | * @group: multicast group id |
| 189 | * @flags: allocation flags |
| 190 | */ |
| 191 | static inline int genlmsg_multicast_netns(struct net *net, struct sk_buff *skb, |
| 192 | u32 pid, unsigned int group, gfp_t flags) |
| 193 | { |
| 194 | return nlmsg_multicast(net->genl_sock, skb, pid, group, flags); |
| 195 | } |
| 196 | |
| 197 | /** |
| 198 | * genlmsg_multicast - multicast a netlink message to the default netns |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 199 | * @skb: netlink message as socket buffer |
| 200 | * @pid: own netlink pid to avoid sending to yourself |
| 201 | * @group: multicast group id |
Thomas Graf | d387f6a | 2006-08-15 00:31:06 -0700 | [diff] [blame] | 202 | * @flags: allocation flags |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 203 | */ |
| 204 | static inline int genlmsg_multicast(struct sk_buff *skb, u32 pid, |
Thomas Graf | d387f6a | 2006-08-15 00:31:06 -0700 | [diff] [blame] | 205 | unsigned int group, gfp_t flags) |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 206 | { |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 207 | return genlmsg_multicast_netns(&init_net, skb, pid, group, flags); |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 208 | } |
| 209 | |
| 210 | /** |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 211 | * genlmsg_multicast_allns - multicast a netlink message to all net namespaces |
| 212 | * @skb: netlink message as socket buffer |
| 213 | * @pid: own netlink pid to avoid sending to yourself |
| 214 | * @group: multicast group id |
| 215 | * @flags: allocation flags |
| 216 | * |
| 217 | * This function must hold the RTNL or rcu_read_lock(). |
| 218 | */ |
| 219 | int genlmsg_multicast_allns(struct sk_buff *skb, u32 pid, |
| 220 | unsigned int group, gfp_t flags); |
| 221 | |
| 222 | /** |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 223 | * genlmsg_unicast - unicast a netlink message |
| 224 | * @skb: netlink message as socket buffer |
| 225 | * @pid: netlink pid of the destination socket |
| 226 | */ |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 227 | static inline int genlmsg_unicast(struct net *net, struct sk_buff *skb, u32 pid) |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 228 | { |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 229 | return nlmsg_unicast(net->genl_sock, skb, pid); |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 230 | } |
| 231 | |
Balbir Singh | fb0ba6bd | 2006-07-14 00:24:39 -0700 | [diff] [blame] | 232 | /** |
Thomas Graf | 81878d2 | 2006-11-14 19:45:27 -0800 | [diff] [blame] | 233 | * genlmsg_reply - reply to a request |
| 234 | * @skb: netlink message to be sent back |
| 235 | * @info: receiver information |
| 236 | */ |
| 237 | static inline int genlmsg_reply(struct sk_buff *skb, struct genl_info *info) |
| 238 | { |
Johannes Berg | 134e637 | 2009-07-10 09:51:34 +0000 | [diff] [blame] | 239 | return genlmsg_unicast(genl_info_net(info), skb, info->snd_pid); |
Thomas Graf | 81878d2 | 2006-11-14 19:45:27 -0800 | [diff] [blame] | 240 | } |
| 241 | |
| 242 | /** |
Balbir Singh | fb0ba6bd | 2006-07-14 00:24:39 -0700 | [diff] [blame] | 243 | * gennlmsg_data - head of message payload |
| 244 | * @gnlh: genetlink messsage header |
| 245 | */ |
| 246 | static inline void *genlmsg_data(const struct genlmsghdr *gnlh) |
| 247 | { |
| 248 | return ((unsigned char *) gnlh + GENL_HDRLEN); |
| 249 | } |
| 250 | |
| 251 | /** |
| 252 | * genlmsg_len - length of message payload |
| 253 | * @gnlh: genetlink message header |
| 254 | */ |
| 255 | static inline int genlmsg_len(const struct genlmsghdr *gnlh) |
| 256 | { |
| 257 | struct nlmsghdr *nlh = (struct nlmsghdr *)((unsigned char *)gnlh - |
| 258 | NLMSG_HDRLEN); |
| 259 | return (nlh->nlmsg_len - GENL_HDRLEN - NLMSG_HDRLEN); |
| 260 | } |
| 261 | |
Balbir Singh | 17db952 | 2006-09-30 23:28:51 -0700 | [diff] [blame] | 262 | /** |
| 263 | * genlmsg_msg_size - length of genetlink message not including padding |
| 264 | * @payload: length of message payload |
| 265 | */ |
| 266 | static inline int genlmsg_msg_size(int payload) |
| 267 | { |
| 268 | return GENL_HDRLEN + payload; |
| 269 | } |
| 270 | |
| 271 | /** |
| 272 | * genlmsg_total_size - length of genetlink message including padding |
| 273 | * @payload: length of message payload |
| 274 | */ |
| 275 | static inline int genlmsg_total_size(int payload) |
| 276 | { |
| 277 | return NLMSG_ALIGN(genlmsg_msg_size(payload)); |
| 278 | } |
| 279 | |
Thomas Graf | 3dabc71 | 2006-11-14 19:44:52 -0800 | [diff] [blame] | 280 | /** |
| 281 | * genlmsg_new - Allocate a new generic netlink message |
| 282 | * @payload: size of the message payload |
| 283 | * @flags: the type of memory to allocate. |
| 284 | */ |
| 285 | static inline struct sk_buff *genlmsg_new(size_t payload, gfp_t flags) |
| 286 | { |
| 287 | return nlmsg_new(genlmsg_total_size(payload), flags); |
| 288 | } |
| 289 | |
| 290 | |
Thomas Graf | 482a852 | 2005-11-10 02:25:56 +0100 | [diff] [blame] | 291 | #endif /* __NET_GENERIC_NETLINK_H */ |