]> git.proxmox.com Git - mirror_ubuntu-zesty-kernel.git/blame - include/linux/netlink.h
ALSA: hda - Fix mute-LED fixed mode
[mirror_ubuntu-zesty-kernel.git] / include / linux / netlink.h
CommitLineData
1da177e4
LT
1#ifndef __LINUX_NETLINK_H
2#define __LINUX_NETLINK_H
3
1da177e4
LT
4
5#include <linux/capability.h>
6#include <linux/skbuff.h>
abb17e6c 7#include <linux/export.h>
dbe9a417 8#include <net/scm.h>
607ca46e 9#include <uapi/linux/netlink.h>
1da177e4 10
56b49f4b
OW
11struct net;
12
b529ccf2
ACM
13static inline struct nlmsghdr *nlmsg_hdr(const struct sk_buff *skb)
14{
15 return (struct nlmsghdr *)skb->data;
16}
17
9652e931 18enum netlink_skb_flags {
2d7a85f4
EB
19 NETLINK_SKB_MMAPED = 0x1, /* Packet data is mmaped */
20 NETLINK_SKB_TX = 0x2, /* Packet was sent by userspace */
21 NETLINK_SKB_DELIVERED = 0x4, /* Packet was delivered */
22 NETLINK_SKB_DST = 0x8, /* Dst set in sendto or sendmsg */
9652e931
PM
23};
24
d94d9fee 25struct netlink_skb_parms {
dbe9a417 26 struct scm_creds creds; /* Skb credentials */
15e47304 27 __u32 portid;
d629b836 28 __u32 dst_group;
9652e931 29 __u32 flags;
e32123e5 30 struct sock *sk;
1da177e4
LT
31};
32
33#define NETLINK_CB(skb) (*(struct netlink_skb_parms*)&((skb)->cb))
34#define NETLINK_CREDS(skb) (&NETLINK_CB((skb)).creds)
35
36
d136f1bd
JB
37extern void netlink_table_grab(void);
38extern void netlink_table_ungrab(void);
39
9785e10a
PNA
40#define NL_CFG_F_NONROOT_RECV (1 << 0)
41#define NL_CFG_F_NONROOT_SEND (1 << 1)
42
a31f2d17
PNA
43/* optional Netlink kernel configuration parameters */
44struct netlink_kernel_cfg {
45 unsigned int groups;
c9d2ea96 46 unsigned int flags;
a31f2d17
PNA
47 void (*input)(struct sk_buff *skb);
48 struct mutex *cb_mutex;
023e2cfa
JB
49 int (*bind)(struct net *net, int group);
50 void (*unbind)(struct net *net, int group);
da12c90e 51 bool (*compare)(struct net *net, struct sock *sk);
a31f2d17
PNA
52};
53
9f00d977
PNA
54extern struct sock *__netlink_kernel_create(struct net *net, int unit,
55 struct module *module,
56 struct netlink_kernel_cfg *cfg);
57static inline struct sock *
58netlink_kernel_create(struct net *net, int unit, struct netlink_kernel_cfg *cfg)
59{
60 return __netlink_kernel_create(net, unit, THIS_MODULE, cfg);
61}
62
b7c6ba6e 63extern void netlink_kernel_release(struct sock *sk);
d136f1bd 64extern int __netlink_change_ngroups(struct sock *sk, unsigned int groups);
b4ff4f04 65extern int netlink_change_ngroups(struct sock *sk, unsigned int groups);
b8273570 66extern void __netlink_clear_multicast_users(struct sock *sk, unsigned int group);
1da177e4 67extern void netlink_ack(struct sk_buff *in_skb, struct nlmsghdr *nlh, int err);
4277a083 68extern int netlink_has_listeners(struct sock *sk, unsigned int group);
f9c22888
PM
69extern struct sk_buff *netlink_alloc_skb(struct sock *ssk, unsigned int size,
70 u32 dst_portid, gfp_t gfp_mask);
15e47304
EB
71extern int netlink_unicast(struct sock *ssk, struct sk_buff *skb, __u32 portid, int nonblock);
72extern int netlink_broadcast(struct sock *ssk, struct sk_buff *skb, __u32 portid,
dd0fc66f 73 __u32 group, gfp_t allocation);
910a7e90 74extern int netlink_broadcast_filtered(struct sock *ssk, struct sk_buff *skb,
15e47304 75 __u32 portid, __u32 group, gfp_t allocation,
910a7e90
EB
76 int (*filter)(struct sock *dsk, struct sk_buff *skb, void *data),
77 void *filter_data);
15e47304 78extern int netlink_set_err(struct sock *ssk, __u32 portid, __u32 group, int code);
1da177e4
LT
79extern int netlink_register_notifier(struct notifier_block *nb);
80extern int netlink_unregister_notifier(struct notifier_block *nb);
81
82/* finegrained unicast helpers: */
83struct sock *netlink_getsockbyfilp(struct file *filp);
9457afee 84int netlink_attachskb(struct sock *sk, struct sk_buff *skb,
c3d8d1e3 85 long *timeo, struct sock *ssk);
1da177e4 86void netlink_detachskb(struct sock *sk, struct sk_buff *skb);
7ee015e0 87int netlink_sendskb(struct sock *sk, struct sk_buff *skb);
1da177e4 88
3a36515f
PN
89static inline struct sk_buff *
90netlink_skb_clone(struct sk_buff *skb, gfp_t gfp_mask)
91{
92 struct sk_buff *nskb;
93
94 nskb = skb_clone(skb, gfp_mask);
95 if (!nskb)
96 return NULL;
97
98 /* This is a large skb, set destructor callback to release head */
99 if (is_vmalloc_addr(skb->head))
100 nskb->destructor = skb->destructor;
101
102 return nskb;
103}
104
1da177e4
LT
105/*
106 * skb should fit one page. This choice is good for headerless malloc.
fc910a27
DM
107 * But we should limit to 8K so that userspace does not have to
108 * use enormous buffer sizes on recvmsg() calls just to avoid
109 * MSG_TRUNC when PAGE_SIZE is very large.
1da177e4 110 */
fc910a27
DM
111#if PAGE_SIZE < 8192UL
112#define NLMSG_GOODSIZE SKB_WITH_OVERHEAD(PAGE_SIZE)
113#else
114#define NLMSG_GOODSIZE SKB_WITH_OVERHEAD(8192UL)
115#endif
116
339bf98f 117#define NLMSG_DEFAULT_SIZE (NLMSG_GOODSIZE - NLMSG_HDRLEN)
1da177e4
LT
118
119
d94d9fee 120struct netlink_callback {
3a6c2b41
PM
121 struct sk_buff *skb;
122 const struct nlmsghdr *nlh;
123 int (*dump)(struct sk_buff * skb,
124 struct netlink_callback *cb);
125 int (*done)(struct netlink_callback *cb);
7175c883 126 void *data;
6dc878a8
G
127 /* the module that dump function belong to */
128 struct module *module;
c7ac8679
GR
129 u16 family;
130 u16 min_dump_alloc;
670dc283 131 unsigned int prev_seq, seq;
3a6c2b41 132 long args[6];
1da177e4
LT
133};
134
d94d9fee 135struct netlink_notify {
b4b51029 136 struct net *net;
0392d099 137 u32 portid;
1da177e4
LT
138 int protocol;
139};
140
a46621a3 141struct nlmsghdr *
15e47304 142__nlmsg_put(struct sk_buff *skb, u32 portid, u32 seq, int type, int len, int flags);
1da177e4 143
80d326fa
PNA
144struct netlink_dump_control {
145 int (*dump)(struct sk_buff *skb, struct netlink_callback *);
6dc878a8 146 int (*done)(struct netlink_callback *);
7175c883 147 void *data;
6dc878a8 148 struct module *module;
80d326fa
PNA
149 u16 min_dump_alloc;
150};
151
6dc878a8
G
152extern int __netlink_dump_start(struct sock *ssk, struct sk_buff *skb,
153 const struct nlmsghdr *nlh,
154 struct netlink_dump_control *control);
155static inline int netlink_dump_start(struct sock *ssk, struct sk_buff *skb,
156 const struct nlmsghdr *nlh,
157 struct netlink_dump_control *control)
158{
159 if (!control->module)
160 control->module = THIS_MODULE;
161
162 return __netlink_dump_start(ssk, skb, nlh, control);
163}
1da177e4 164
bcbde0d4
DB
165struct netlink_tap {
166 struct net_device *dev;
167 struct module *module;
168 struct list_head list;
169};
170
171extern int netlink_add_tap(struct netlink_tap *nt);
bcbde0d4
DB
172extern int netlink_remove_tap(struct netlink_tap *nt);
173
aa4cf945
EB
174bool __netlink_ns_capable(const struct netlink_skb_parms *nsp,
175 struct user_namespace *ns, int cap);
176bool netlink_ns_capable(const struct sk_buff *skb,
177 struct user_namespace *ns, int cap);
178bool netlink_capable(const struct sk_buff *skb, int cap);
179bool netlink_net_capable(const struct sk_buff *skb, int cap);
180
1da177e4 181#endif /* __LINUX_NETLINK_H */