1 /* Netfilter messages via netlink socket. Allows for user space
2 * protocol helpers and general trouble making from userspace.
4 * (C) 2001 by Jay Schulist <jschlst@samba.org>,
5 * (C) 2002-2005 by Harald Welte <laforge@gnumonks.org>
6 * (C) 2005-2017 by Pablo Neira Ayuso <pablo@netfilter.org>
8 * Initial netfilter messages via netlink development funded and
9 * generally made possible by Network Robots, Inc. (www.networkrobots.com)
11 * Further development of this code funded by Astaro AG (http://www.astaro.com)
13 * This software may be used and distributed according to the terms
14 * of the GNU General Public License, incorporated herein by reference.
17 #include <linux/module.h>
18 #include <linux/types.h>
19 #include <linux/socket.h>
20 #include <linux/kernel.h>
21 #include <linux/string.h>
22 #include <linux/sockios.h>
23 #include <linux/net.h>
24 #include <linux/skbuff.h>
25 #include <linux/uaccess.h>
27 #include <linux/init.h>
28 #include <linux/sched/signal.h>
30 #include <net/netlink.h>
31 #include <net/netns/generic.h>
32 #include <linux/netfilter/nfnetlink.h>
34 MODULE_LICENSE("GPL");
35 MODULE_AUTHOR("Harald Welte <laforge@netfilter.org>");
36 MODULE_ALIAS_NET_PF_PROTO(PF_NETLINK, NETLINK_NETFILTER);
37 MODULE_DESCRIPTION("Netfilter messages via netlink socket");
39 #define nfnl_dereference_protected(id) \
40 rcu_dereference_protected(table[(id)].subsys, \
41 lockdep_nfnl_is_held((id)))
43 #define NFNL_MAX_ATTR_COUNT 32
45 static unsigned int nfnetlink_pernet_id __read_mostly;
47 #ifdef CONFIG_NF_CONNTRACK_EVENTS
48 static DEFINE_SPINLOCK(nfnl_grp_active_lock);
57 const struct nfnetlink_subsystem __rcu *subsys;
58 } table[NFNL_SUBSYS_COUNT];
60 static struct lock_class_key nfnl_lockdep_keys[NFNL_SUBSYS_COUNT];
62 static const char *const nfnl_lockdep_names[NFNL_SUBSYS_COUNT] = {
63 [NFNL_SUBSYS_NONE] = "nfnl_subsys_none",
64 [NFNL_SUBSYS_CTNETLINK] = "nfnl_subsys_ctnetlink",
65 [NFNL_SUBSYS_CTNETLINK_EXP] = "nfnl_subsys_ctnetlink_exp",
66 [NFNL_SUBSYS_QUEUE] = "nfnl_subsys_queue",
67 [NFNL_SUBSYS_ULOG] = "nfnl_subsys_ulog",
68 [NFNL_SUBSYS_OSF] = "nfnl_subsys_osf",
69 [NFNL_SUBSYS_IPSET] = "nfnl_subsys_ipset",
70 [NFNL_SUBSYS_ACCT] = "nfnl_subsys_acct",
71 [NFNL_SUBSYS_CTNETLINK_TIMEOUT] = "nfnl_subsys_cttimeout",
72 [NFNL_SUBSYS_CTHELPER] = "nfnl_subsys_cthelper",
73 [NFNL_SUBSYS_NFTABLES] = "nfnl_subsys_nftables",
74 [NFNL_SUBSYS_NFT_COMPAT] = "nfnl_subsys_nftcompat",
75 [NFNL_SUBSYS_HOOK] = "nfnl_subsys_hook",
78 static const int nfnl_group2type[NFNLGRP_MAX+1] = {
79 [NFNLGRP_CONNTRACK_NEW] = NFNL_SUBSYS_CTNETLINK,
80 [NFNLGRP_CONNTRACK_UPDATE] = NFNL_SUBSYS_CTNETLINK,
81 [NFNLGRP_CONNTRACK_DESTROY] = NFNL_SUBSYS_CTNETLINK,
82 [NFNLGRP_CONNTRACK_EXP_NEW] = NFNL_SUBSYS_CTNETLINK_EXP,
83 [NFNLGRP_CONNTRACK_EXP_UPDATE] = NFNL_SUBSYS_CTNETLINK_EXP,
84 [NFNLGRP_CONNTRACK_EXP_DESTROY] = NFNL_SUBSYS_CTNETLINK_EXP,
85 [NFNLGRP_NFTABLES] = NFNL_SUBSYS_NFTABLES,
86 [NFNLGRP_ACCT_QUOTA] = NFNL_SUBSYS_ACCT,
87 [NFNLGRP_NFTRACE] = NFNL_SUBSYS_NFTABLES,
90 static struct nfnl_net *nfnl_pernet(struct net *net)
92 return net_generic(net, nfnetlink_pernet_id);
95 void nfnl_lock(__u8 subsys_id)
97 mutex_lock(&table[subsys_id].mutex);
99 EXPORT_SYMBOL_GPL(nfnl_lock);
101 void nfnl_unlock(__u8 subsys_id)
103 mutex_unlock(&table[subsys_id].mutex);
105 EXPORT_SYMBOL_GPL(nfnl_unlock);
107 #ifdef CONFIG_PROVE_LOCKING
108 bool lockdep_nfnl_is_held(u8 subsys_id)
110 return lockdep_is_held(&table[subsys_id].mutex);
112 EXPORT_SYMBOL_GPL(lockdep_nfnl_is_held);
115 int nfnetlink_subsys_register(const struct nfnetlink_subsystem *n)
119 /* Sanity-check attr_count size to avoid stack buffer overflow. */
120 for (cb_id = 0; cb_id < n->cb_count; cb_id++)
121 if (WARN_ON(n->cb[cb_id].attr_count > NFNL_MAX_ATTR_COUNT))
124 nfnl_lock(n->subsys_id);
125 if (table[n->subsys_id].subsys) {
126 nfnl_unlock(n->subsys_id);
129 rcu_assign_pointer(table[n->subsys_id].subsys, n);
130 nfnl_unlock(n->subsys_id);
134 EXPORT_SYMBOL_GPL(nfnetlink_subsys_register);
136 int nfnetlink_subsys_unregister(const struct nfnetlink_subsystem *n)
138 nfnl_lock(n->subsys_id);
139 table[n->subsys_id].subsys = NULL;
140 nfnl_unlock(n->subsys_id);
144 EXPORT_SYMBOL_GPL(nfnetlink_subsys_unregister);
146 static inline const struct nfnetlink_subsystem *nfnetlink_get_subsys(u16 type)
148 u8 subsys_id = NFNL_SUBSYS_ID(type);
150 if (subsys_id >= NFNL_SUBSYS_COUNT)
153 return rcu_dereference(table[subsys_id].subsys);
156 static inline const struct nfnl_callback *
157 nfnetlink_find_client(u16 type, const struct nfnetlink_subsystem *ss)
159 u8 cb_id = NFNL_MSG_TYPE(type);
161 if (cb_id >= ss->cb_count)
164 return &ss->cb[cb_id];
167 int nfnetlink_has_listeners(struct net *net, unsigned int group)
169 struct nfnl_net *nfnlnet = nfnl_pernet(net);
171 return netlink_has_listeners(nfnlnet->nfnl, group);
173 EXPORT_SYMBOL_GPL(nfnetlink_has_listeners);
175 int nfnetlink_send(struct sk_buff *skb, struct net *net, u32 portid,
176 unsigned int group, int echo, gfp_t flags)
178 struct nfnl_net *nfnlnet = nfnl_pernet(net);
180 return nlmsg_notify(nfnlnet->nfnl, skb, portid, group, echo, flags);
182 EXPORT_SYMBOL_GPL(nfnetlink_send);
184 int nfnetlink_set_err(struct net *net, u32 portid, u32 group, int error)
186 struct nfnl_net *nfnlnet = nfnl_pernet(net);
188 return netlink_set_err(nfnlnet->nfnl, portid, group, error);
190 EXPORT_SYMBOL_GPL(nfnetlink_set_err);
192 int nfnetlink_unicast(struct sk_buff *skb, struct net *net, u32 portid)
194 struct nfnl_net *nfnlnet = nfnl_pernet(net);
197 err = nlmsg_unicast(nfnlnet->nfnl, skb, portid);
203 EXPORT_SYMBOL_GPL(nfnetlink_unicast);
205 void nfnetlink_broadcast(struct net *net, struct sk_buff *skb, __u32 portid,
206 __u32 group, gfp_t allocation)
208 struct nfnl_net *nfnlnet = nfnl_pernet(net);
210 netlink_broadcast(nfnlnet->nfnl, skb, portid, group, allocation);
212 EXPORT_SYMBOL_GPL(nfnetlink_broadcast);
214 /* Process one complete nfnetlink message. */
215 static int nfnetlink_rcv_msg(struct sk_buff *skb, struct nlmsghdr *nlh,
216 struct netlink_ext_ack *extack)
218 struct net *net = sock_net(skb->sk);
219 const struct nfnl_callback *nc;
220 const struct nfnetlink_subsystem *ss;
223 /* All the messages must at least contain nfgenmsg */
224 if (nlmsg_len(nlh) < sizeof(struct nfgenmsg))
227 type = nlh->nlmsg_type;
231 ss = nfnetlink_get_subsys(type);
233 #ifdef CONFIG_MODULES
235 request_module("nfnetlink-subsys-%d", NFNL_SUBSYS_ID(type));
237 ss = nfnetlink_get_subsys(type);
246 nc = nfnetlink_find_client(type, ss);
253 int min_len = nlmsg_total_size(sizeof(struct nfgenmsg));
254 struct nfnl_net *nfnlnet = nfnl_pernet(net);
255 u8 cb_id = NFNL_MSG_TYPE(nlh->nlmsg_type);
256 struct nlattr *cda[NFNL_MAX_ATTR_COUNT + 1];
257 struct nlattr *attr = (void *)nlh + min_len;
258 int attrlen = nlh->nlmsg_len - min_len;
259 __u8 subsys_id = NFNL_SUBSYS_ID(type);
260 struct nfnl_info info = {
264 .nfmsg = nlmsg_data(nlh),
268 /* Sanity-check NFNL_MAX_ATTR_COUNT */
269 if (ss->cb[cb_id].attr_count > NFNL_MAX_ATTR_COUNT) {
274 err = nla_parse_deprecated(cda, ss->cb[cb_id].attr_count,
276 ss->cb[cb_id].policy, extack);
289 err = nc->call(skb, &info, (const struct nlattr **)cda);
294 nfnl_lock(subsys_id);
295 if (nfnl_dereference_protected(subsys_id) != ss ||
296 nfnetlink_find_client(type, ss) != nc) {
300 err = nc->call(skb, &info, (const struct nlattr **)cda);
301 nfnl_unlock(subsys_id);
315 struct list_head head;
316 struct nlmsghdr *nlh;
318 struct netlink_ext_ack extack;
321 static int nfnl_err_add(struct list_head *list, struct nlmsghdr *nlh, int err,
322 const struct netlink_ext_ack *extack)
324 struct nfnl_err *nfnl_err;
326 nfnl_err = kmalloc(sizeof(struct nfnl_err), GFP_KERNEL);
327 if (nfnl_err == NULL)
332 nfnl_err->extack = *extack;
333 list_add_tail(&nfnl_err->head, list);
338 static void nfnl_err_del(struct nfnl_err *nfnl_err)
340 list_del(&nfnl_err->head);
344 static void nfnl_err_reset(struct list_head *err_list)
346 struct nfnl_err *nfnl_err, *next;
348 list_for_each_entry_safe(nfnl_err, next, err_list, head)
349 nfnl_err_del(nfnl_err);
352 static void nfnl_err_deliver(struct list_head *err_list, struct sk_buff *skb)
354 struct nfnl_err *nfnl_err, *next;
356 list_for_each_entry_safe(nfnl_err, next, err_list, head) {
357 netlink_ack(skb, nfnl_err->nlh, nfnl_err->err,
359 nfnl_err_del(nfnl_err);
364 NFNL_BATCH_FAILURE = (1 << 0),
365 NFNL_BATCH_DONE = (1 << 1),
366 NFNL_BATCH_REPLAY = (1 << 2),
369 static void nfnetlink_rcv_batch(struct sk_buff *skb, struct nlmsghdr *nlh,
370 u16 subsys_id, u32 genid)
372 struct sk_buff *oskb = skb;
373 struct net *net = sock_net(skb->sk);
374 const struct nfnetlink_subsystem *ss;
375 const struct nfnl_callback *nc;
376 struct netlink_ext_ack extack;
381 if (subsys_id >= NFNL_SUBSYS_COUNT)
382 return netlink_ack(skb, nlh, -EINVAL, NULL);
386 skb = netlink_skb_clone(oskb, GFP_KERNEL);
388 return netlink_ack(oskb, nlh, -ENOMEM, NULL);
390 nfnl_lock(subsys_id);
391 ss = nfnl_dereference_protected(subsys_id);
393 #ifdef CONFIG_MODULES
394 nfnl_unlock(subsys_id);
395 request_module("nfnetlink-subsys-%d", subsys_id);
396 nfnl_lock(subsys_id);
397 ss = nfnl_dereference_protected(subsys_id);
401 nfnl_unlock(subsys_id);
402 netlink_ack(oskb, nlh, -EOPNOTSUPP, NULL);
403 return kfree_skb(skb);
407 if (!ss->valid_genid || !ss->commit || !ss->abort) {
408 nfnl_unlock(subsys_id);
409 netlink_ack(oskb, nlh, -EOPNOTSUPP, NULL);
410 return kfree_skb(skb);
413 if (!try_module_get(ss->owner)) {
414 nfnl_unlock(subsys_id);
415 netlink_ack(oskb, nlh, -EOPNOTSUPP, NULL);
416 return kfree_skb(skb);
419 if (!ss->valid_genid(net, genid)) {
420 module_put(ss->owner);
421 nfnl_unlock(subsys_id);
422 netlink_ack(oskb, nlh, -ERESTART, NULL);
423 return kfree_skb(skb);
426 nfnl_unlock(subsys_id);
428 while (skb->len >= nlmsg_total_size(0)) {
431 if (fatal_signal_pending(current)) {
432 nfnl_err_reset(&err_list);
434 status = NFNL_BATCH_FAILURE;
438 memset(&extack, 0, sizeof(extack));
439 nlh = nlmsg_hdr(skb);
442 if (nlh->nlmsg_len < NLMSG_HDRLEN ||
443 skb->len < nlh->nlmsg_len ||
444 nlmsg_len(nlh) < sizeof(struct nfgenmsg)) {
445 nfnl_err_reset(&err_list);
446 status |= NFNL_BATCH_FAILURE;
450 /* Only requests are handled by the kernel */
451 if (!(nlh->nlmsg_flags & NLM_F_REQUEST)) {
456 type = nlh->nlmsg_type;
457 if (type == NFNL_MSG_BATCH_BEGIN) {
458 /* Malformed: Batch begin twice */
459 nfnl_err_reset(&err_list);
460 status |= NFNL_BATCH_FAILURE;
462 } else if (type == NFNL_MSG_BATCH_END) {
463 status |= NFNL_BATCH_DONE;
465 } else if (type < NLMSG_MIN_TYPE) {
470 /* We only accept a batch with messages for the same
473 if (NFNL_SUBSYS_ID(type) != subsys_id) {
478 nc = nfnetlink_find_client(type, ss);
484 if (nc->type != NFNL_CB_BATCH) {
490 int min_len = nlmsg_total_size(sizeof(struct nfgenmsg));
491 struct nfnl_net *nfnlnet = nfnl_pernet(net);
492 struct nlattr *cda[NFNL_MAX_ATTR_COUNT + 1];
493 struct nlattr *attr = (void *)nlh + min_len;
494 u8 cb_id = NFNL_MSG_TYPE(nlh->nlmsg_type);
495 int attrlen = nlh->nlmsg_len - min_len;
496 struct nfnl_info info = {
500 .nfmsg = nlmsg_data(nlh),
504 /* Sanity-check NFTA_MAX_ATTR */
505 if (ss->cb[cb_id].attr_count > NFNL_MAX_ATTR_COUNT) {
510 err = nla_parse_deprecated(cda,
511 ss->cb[cb_id].attr_count,
513 ss->cb[cb_id].policy, NULL);
517 err = nc->call(skb, &info, (const struct nlattr **)cda);
519 /* The lock was released to autoload some module, we
520 * have to abort and start from scratch using the
523 if (err == -EAGAIN) {
524 status |= NFNL_BATCH_REPLAY;
529 if (nlh->nlmsg_flags & NLM_F_ACK || err) {
530 /* Errors are delivered once the full batch has been
531 * processed, this avoids that the same error is
532 * reported several times when replaying the batch.
534 if (nfnl_err_add(&err_list, nlh, err, &extack) < 0) {
535 /* We failed to enqueue an error, reset the
536 * list of errors and send OOM to userspace
537 * pointing to the batch header.
539 nfnl_err_reset(&err_list);
540 netlink_ack(oskb, nlmsg_hdr(oskb), -ENOMEM,
542 status |= NFNL_BATCH_FAILURE;
545 /* We don't stop processing the batch on errors, thus,
546 * userspace gets all the errors that the batch
550 status |= NFNL_BATCH_FAILURE;
553 msglen = NLMSG_ALIGN(nlh->nlmsg_len);
554 if (msglen > skb->len)
556 skb_pull(skb, msglen);
559 if (status & NFNL_BATCH_REPLAY) {
560 ss->abort(net, oskb, NFNL_ABORT_AUTOLOAD);
561 nfnl_err_reset(&err_list);
563 module_put(ss->owner);
565 } else if (status == NFNL_BATCH_DONE) {
566 err = ss->commit(net, oskb);
567 if (err == -EAGAIN) {
568 status |= NFNL_BATCH_REPLAY;
571 ss->abort(net, oskb, NFNL_ABORT_NONE);
572 netlink_ack(oskb, nlmsg_hdr(oskb), err, NULL);
575 enum nfnl_abort_action abort_action;
577 if (status & NFNL_BATCH_FAILURE)
578 abort_action = NFNL_ABORT_NONE;
580 abort_action = NFNL_ABORT_VALIDATE;
582 err = ss->abort(net, oskb, abort_action);
583 if (err == -EAGAIN) {
584 nfnl_err_reset(&err_list);
586 module_put(ss->owner);
587 status |= NFNL_BATCH_FAILURE;
594 nfnl_err_deliver(&err_list, oskb);
596 module_put(ss->owner);
599 static const struct nla_policy nfnl_batch_policy[NFNL_BATCH_MAX + 1] = {
600 [NFNL_BATCH_GENID] = { .type = NLA_U32 },
603 static void nfnetlink_rcv_skb_batch(struct sk_buff *skb, struct nlmsghdr *nlh)
605 int min_len = nlmsg_total_size(sizeof(struct nfgenmsg));
606 struct nlattr *attr = (void *)nlh + min_len;
607 struct nlattr *cda[NFNL_BATCH_MAX + 1];
608 int attrlen = nlh->nlmsg_len - min_len;
609 struct nfgenmsg *nfgenmsg;
614 msglen = NLMSG_ALIGN(nlh->nlmsg_len);
615 if (msglen > skb->len)
618 if (skb->len < NLMSG_HDRLEN + sizeof(struct nfgenmsg))
621 err = nla_parse_deprecated(cda, NFNL_BATCH_MAX, attr, attrlen,
622 nfnl_batch_policy, NULL);
624 netlink_ack(skb, nlh, err, NULL);
627 if (cda[NFNL_BATCH_GENID])
628 gen_id = ntohl(nla_get_be32(cda[NFNL_BATCH_GENID]));
630 nfgenmsg = nlmsg_data(nlh);
631 skb_pull(skb, msglen);
632 /* Work around old nft using host byte order */
633 if (nfgenmsg->res_id == (__force __be16)NFNL_SUBSYS_NFTABLES)
634 res_id = NFNL_SUBSYS_NFTABLES;
636 res_id = ntohs(nfgenmsg->res_id);
638 nfnetlink_rcv_batch(skb, nlh, res_id, gen_id);
641 static void nfnetlink_rcv(struct sk_buff *skb)
643 struct nlmsghdr *nlh = nlmsg_hdr(skb);
645 if (skb->len < NLMSG_HDRLEN ||
646 nlh->nlmsg_len < NLMSG_HDRLEN ||
647 skb->len < nlh->nlmsg_len)
650 if (!netlink_net_capable(skb, CAP_NET_ADMIN)) {
651 netlink_ack(skb, nlh, -EPERM, NULL);
655 if (nlh->nlmsg_type == NFNL_MSG_BATCH_BEGIN)
656 nfnetlink_rcv_skb_batch(skb, nlh);
658 netlink_rcv_skb(skb, nfnetlink_rcv_msg);
661 static void nfnetlink_bind_event(struct net *net, unsigned int group)
663 #ifdef CONFIG_NF_CONNTRACK_EVENTS
667 /* All NFNLGRP_CONNTRACK_* group bits fit into u8.
668 * The other groups are not relevant and can be ignored.
673 type = nfnl_group2type[group];
676 case NFNL_SUBSYS_CTNETLINK:
678 case NFNL_SUBSYS_CTNETLINK_EXP:
684 group_bit = (1 << group);
686 spin_lock(&nfnl_grp_active_lock);
687 v = READ_ONCE(net->ct.ctnetlink_has_listener);
688 if ((v & group_bit) == 0) {
691 /* read concurrently without nfnl_grp_active_lock held. */
692 WRITE_ONCE(net->ct.ctnetlink_has_listener, v);
695 spin_unlock(&nfnl_grp_active_lock);
699 static int nfnetlink_bind(struct net *net, int group)
701 const struct nfnetlink_subsystem *ss;
704 if (group <= NFNLGRP_NONE || group > NFNLGRP_MAX)
707 type = nfnl_group2type[group];
710 ss = nfnetlink_get_subsys(type << 8);
713 request_module_nowait("nfnetlink-subsys-%d", type);
715 nfnetlink_bind_event(net, group);
719 static void nfnetlink_unbind(struct net *net, int group)
721 #ifdef CONFIG_NF_CONNTRACK_EVENTS
724 if (group <= NFNLGRP_NONE || group > NFNLGRP_MAX)
727 type = nfnl_group2type[group];
730 case NFNL_SUBSYS_CTNETLINK:
732 case NFNL_SUBSYS_CTNETLINK_EXP:
738 /* ctnetlink_has_listener is u8 */
742 group_bit = (1 << group);
744 spin_lock(&nfnl_grp_active_lock);
745 if (!nfnetlink_has_listeners(net, group)) {
746 u8 v = READ_ONCE(net->ct.ctnetlink_has_listener);
750 /* read concurrently without nfnl_grp_active_lock held. */
751 WRITE_ONCE(net->ct.ctnetlink_has_listener, v);
753 spin_unlock(&nfnl_grp_active_lock);
757 static int __net_init nfnetlink_net_init(struct net *net)
759 struct nfnl_net *nfnlnet = nfnl_pernet(net);
760 struct netlink_kernel_cfg cfg = {
761 .groups = NFNLGRP_MAX,
762 .input = nfnetlink_rcv,
763 .bind = nfnetlink_bind,
764 .unbind = nfnetlink_unbind,
767 nfnlnet->nfnl = netlink_kernel_create(net, NETLINK_NETFILTER, &cfg);
773 static void __net_exit nfnetlink_net_exit_batch(struct list_head *net_exit_list)
775 struct nfnl_net *nfnlnet;
778 list_for_each_entry(net, net_exit_list, exit_list) {
779 nfnlnet = nfnl_pernet(net);
781 netlink_kernel_release(nfnlnet->nfnl);
785 static struct pernet_operations nfnetlink_net_ops = {
786 .init = nfnetlink_net_init,
787 .exit_batch = nfnetlink_net_exit_batch,
788 .id = &nfnetlink_pernet_id,
789 .size = sizeof(struct nfnl_net),
792 static int __init nfnetlink_init(void)
796 for (i = NFNLGRP_NONE + 1; i <= NFNLGRP_MAX; i++)
797 BUG_ON(nfnl_group2type[i] == NFNL_SUBSYS_NONE);
799 for (i=0; i<NFNL_SUBSYS_COUNT; i++)
800 __mutex_init(&table[i].mutex, nfnl_lockdep_names[i], &nfnl_lockdep_keys[i]);
802 return register_pernet_subsys(&nfnetlink_net_ops);
805 static void __exit nfnetlink_exit(void)
807 unregister_pernet_subsys(&nfnetlink_net_ops);
809 module_init(nfnetlink_init);
810 module_exit(nfnetlink_exit);