netlink.h 7.8 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7
#ifndef __LINUX_NETLINK_H
#define __LINUX_NETLINK_H

#include <linux/socket.h> /* for sa_family_t */
#include <linux/types.h>

#define NETLINK_ROUTE		0	/* Routing/device hook				*/
8
#define NETLINK_UNUSED		1	/* Unused number				*/
L
Linus Torvalds 已提交
9 10
#define NETLINK_USERSOCK	2	/* Reserved for user mode socket protocols 	*/
#define NETLINK_FIREWALL	3	/* Firewalling hook				*/
11
#define NETLINK_INET_DIAG	4	/* INET socket monitoring			*/
L
Linus Torvalds 已提交
12 13 14
#define NETLINK_NFLOG		5	/* netfilter/iptables ULOG */
#define NETLINK_XFRM		6	/* ipsec */
#define NETLINK_SELINUX		7	/* SELinux event notifications */
15
#define NETLINK_ISCSI		8	/* Open-iSCSI */
L
Linus Torvalds 已提交
16
#define NETLINK_AUDIT		9	/* auditing */
17
#define NETLINK_FIB_LOOKUP	10	
E
Evgeniy Polyakov 已提交
18
#define NETLINK_CONNECTOR	11
19
#define NETLINK_NETFILTER	12	/* netfilter subsystem */
L
Linus Torvalds 已提交
20 21 22
#define NETLINK_IP6_FW		13
#define NETLINK_DNRTMSG		14	/* DECnet routing messages */
#define NETLINK_KOBJECT_UEVENT	15	/* Kernel messages to userspace */
23
#define NETLINK_GENERIC		16
24 25
/* leave room for NETLINK_DM (DM Events) */
#define NETLINK_SCSITRANSPORT	18	/* SCSI Transports */
26
#define NETLINK_ECRYPTFS	19
L
Linus Torvalds 已提交
27 28 29

#define MAX_LINKS 32		

30 31
struct net;

L
Linus Torvalds 已提交
32 33 34 35
struct sockaddr_nl
{
	sa_family_t	nl_family;	/* AF_NETLINK	*/
	unsigned short	nl_pad;		/* zero		*/
36
	__u32		nl_pid;		/* port ID	*/
L
Linus Torvalds 已提交
37 38 39 40 41 42 43 44 45
       	__u32		nl_groups;	/* multicast groups mask */
};

struct nlmsghdr
{
	__u32		nlmsg_len;	/* Length of message including header */
	__u16		nlmsg_type;	/* Message content */
	__u16		nlmsg_flags;	/* Additional flags */
	__u32		nlmsg_seq;	/* Sequence number */
46
	__u32		nlmsg_pid;	/* Sending process port ID */
L
Linus Torvalds 已提交
47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78
};

/* Flags values */

#define NLM_F_REQUEST		1	/* It is request message. 	*/
#define NLM_F_MULTI		2	/* Multipart message, terminated by NLMSG_DONE */
#define NLM_F_ACK		4	/* Reply with ack, with zero or error code */
#define NLM_F_ECHO		8	/* Echo this request 		*/

/* Modifiers to GET request */
#define NLM_F_ROOT	0x100	/* specify tree	root	*/
#define NLM_F_MATCH	0x200	/* return all matching	*/
#define NLM_F_ATOMIC	0x400	/* atomic GET		*/
#define NLM_F_DUMP	(NLM_F_ROOT|NLM_F_MATCH)

/* Modifiers to NEW request */
#define NLM_F_REPLACE	0x100	/* Override existing		*/
#define NLM_F_EXCL	0x200	/* Do not touch, if it exists	*/
#define NLM_F_CREATE	0x400	/* Create, if it does not exist	*/
#define NLM_F_APPEND	0x800	/* Add to end of list		*/

/*
   4.4BSD ADD		NLM_F_CREATE|NLM_F_EXCL
   4.4BSD CHANGE	NLM_F_REPLACE

   True CHANGE		NLM_F_CREATE|NLM_F_REPLACE
   Append		NLM_F_CREATE
   Check		NLM_F_EXCL
 */

#define NLMSG_ALIGNTO	4
#define NLMSG_ALIGN(len) ( ((len)+NLMSG_ALIGNTO-1) & ~(NLMSG_ALIGNTO-1) )
79 80
#define NLMSG_HDRLEN	 ((int) NLMSG_ALIGN(sizeof(struct nlmsghdr)))
#define NLMSG_LENGTH(len) ((len)+NLMSG_ALIGN(NLMSG_HDRLEN))
L
Linus Torvalds 已提交
81 82 83 84 85 86 87 88 89 90 91 92 93 94
#define NLMSG_SPACE(len) NLMSG_ALIGN(NLMSG_LENGTH(len))
#define NLMSG_DATA(nlh)  ((void*)(((char*)nlh) + NLMSG_LENGTH(0)))
#define NLMSG_NEXT(nlh,len)	 ((len) -= NLMSG_ALIGN((nlh)->nlmsg_len), \
				  (struct nlmsghdr*)(((char*)(nlh)) + NLMSG_ALIGN((nlh)->nlmsg_len)))
#define NLMSG_OK(nlh,len) ((len) >= (int)sizeof(struct nlmsghdr) && \
			   (nlh)->nlmsg_len >= sizeof(struct nlmsghdr) && \
			   (nlh)->nlmsg_len <= (len))
#define NLMSG_PAYLOAD(nlh,len) ((nlh)->nlmsg_len - NLMSG_SPACE((len)))

#define NLMSG_NOOP		0x1	/* Nothing.		*/
#define NLMSG_ERROR		0x2	/* Error		*/
#define NLMSG_DONE		0x3	/* End of a dump	*/
#define NLMSG_OVERRUN		0x4	/* Data lost		*/

95 96
#define NLMSG_MIN_TYPE		0x10	/* < 0x10: reserved control messages */

L
Linus Torvalds 已提交
97 98 99 100 101 102
struct nlmsgerr
{
	int		error;
	struct nlmsghdr msg;
};

103 104 105 106 107 108 109 110 111
#define NETLINK_ADD_MEMBERSHIP	1
#define NETLINK_DROP_MEMBERSHIP	2
#define NETLINK_PKTINFO		3

struct nl_pktinfo
{
	__u32	group;
};

L
Linus Torvalds 已提交
112 113 114 115 116 117 118
#define NET_MAJOR 36		/* Major 36 is reserved for networking 						*/

enum {
	NETLINK_UNCONNECTED = 0,
	NETLINK_CONNECTED,
};

119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137
/*
 *  <------- NLA_HDRLEN ------> <-- NLA_ALIGN(payload)-->
 * +---------------------+- - -+- - - - - - - - - -+- - -+
 * |        Header       | Pad |     Payload       | Pad |
 * |   (struct nlattr)   | ing |                   | ing |
 * +---------------------+- - -+- - - - - - - - - -+- - -+
 *  <-------------- nlattr->nla_len -------------->
 */

struct nlattr
{
	__u16           nla_len;
	__u16           nla_type;
};

#define NLA_ALIGNTO		4
#define NLA_ALIGN(len)		(((len) + NLA_ALIGNTO - 1) & ~(NLA_ALIGNTO - 1))
#define NLA_HDRLEN		((int) NLA_ALIGN(sizeof(struct nlattr)))

L
Linus Torvalds 已提交
138 139 140 141 142
#ifdef __KERNEL__

#include <linux/capability.h>
#include <linux/skbuff.h>

143 144 145 146 147
static inline struct nlmsghdr *nlmsg_hdr(const struct sk_buff *skb)
{
	return (struct nlmsghdr *)skb->data;
}

L
Linus Torvalds 已提交
148 149 150 151
struct netlink_skb_parms
{
	struct ucred		creds;		/* Skb credentials	*/
	__u32			pid;
152
	__u32			dst_group;
L
Linus Torvalds 已提交
153
	kernel_cap_t		eff_cap;
154
	__u32			loginuid;	/* Login (audit) uid */
155
	__u32			sid;		/* SELinux security id */
L
Linus Torvalds 已提交
156 157 158 159 160 161
};

#define NETLINK_CB(skb)		(*(struct netlink_skb_parms*)&((skb)->cb))
#define NETLINK_CREDS(skb)	(&NETLINK_CB((skb)).creds)


162 163
extern struct sock *netlink_kernel_create(struct net *net,
					  int unit,unsigned int groups,
164 165 166
					  void (*input)(struct sock *sk, int len),
					  struct mutex *cb_mutex,
					  struct module *module);
167
extern int netlink_change_ngroups(struct sock *sk, unsigned int groups);
168
extern void netlink_clear_multicast_users(struct sock *sk, unsigned int group);
L
Linus Torvalds 已提交
169
extern void netlink_ack(struct sk_buff *in_skb, struct nlmsghdr *nlh, int err);
170
extern int netlink_has_listeners(struct sock *sk, unsigned int group);
L
Linus Torvalds 已提交
171 172
extern int netlink_unicast(struct sock *ssk, struct sk_buff *skb, __u32 pid, int nonblock);
extern int netlink_broadcast(struct sock *ssk, struct sk_buff *skb, __u32 pid,
A
Al Viro 已提交
173
			     __u32 group, gfp_t allocation);
L
Linus Torvalds 已提交
174 175 176 177 178 179
extern void netlink_set_err(struct sock *ssk, __u32 pid, __u32 group, int code);
extern int netlink_register_notifier(struct notifier_block *nb);
extern int netlink_unregister_notifier(struct notifier_block *nb);

/* finegrained unicast helpers: */
struct sock *netlink_getsockbyfilp(struct file *filp);
A
Alexey Kuznetsov 已提交
180 181
int netlink_attachskb(struct sock *sk, struct sk_buff *skb, int nonblock,
		long timeo, struct sock *ssk);
L
Linus Torvalds 已提交
182 183 184 185 186
void netlink_detachskb(struct sock *sk, struct sk_buff *skb);
int netlink_sendskb(struct sock *sk, struct sk_buff *skb, int protocol);

/*
 *	skb should fit one page. This choice is good for headerless malloc.
187 188 189
 *	But we should limit to 8K so that userspace does not have to
 *	use enormous buffer sizes on recvmsg() calls just to avoid
 *	MSG_TRUNC when PAGE_SIZE is very large.
L
Linus Torvalds 已提交
190
 */
191 192 193 194 195 196
#if PAGE_SIZE < 8192UL
#define NLMSG_GOODSIZE	SKB_WITH_OVERHEAD(PAGE_SIZE)
#else
#define NLMSG_GOODSIZE	SKB_WITH_OVERHEAD(8192UL)
#endif

197
#define NLMSG_DEFAULT_SIZE (NLMSG_GOODSIZE - NLMSG_HDRLEN)
L
Linus Torvalds 已提交
198 199 200 201 202 203 204 205 206


struct netlink_callback
{
	struct sk_buff	*skb;
	struct nlmsghdr	*nlh;
	int		(*dump)(struct sk_buff * skb, struct netlink_callback *cb);
	int		(*done)(struct netlink_callback *cb);
	int		family;
207
	long		args[5];
L
Linus Torvalds 已提交
208 209 210 211
};

struct netlink_notify
{
212
	struct net *net;
L
Linus Torvalds 已提交
213 214 215 216 217
	int pid;
	int protocol;
};

static __inline__ struct nlmsghdr *
218
__nlmsg_put(struct sk_buff *skb, u32 pid, u32 seq, int type, int len, int flags)
L
Linus Torvalds 已提交
219 220 221 222 223 224 225
{
	struct nlmsghdr *nlh;
	int size = NLMSG_LENGTH(len);

	nlh = (struct nlmsghdr*)skb_put(skb, NLMSG_ALIGN(size));
	nlh->nlmsg_type = type;
	nlh->nlmsg_len = size;
226
	nlh->nlmsg_flags = flags;
L
Linus Torvalds 已提交
227 228
	nlh->nlmsg_pid = pid;
	nlh->nlmsg_seq = seq;
229
	memset(NLMSG_DATA(nlh) + len, 0, NLMSG_ALIGN(size) - size);
L
Linus Torvalds 已提交
230 231 232
	return nlh;
}

233
#define NLMSG_NEW(skb, pid, seq, type, len, flags) \
234 235
({	if (skb_tailroom(skb) < (int)NLMSG_SPACE(len)) \
		goto nlmsg_failure; \
236 237 238 239
	__nlmsg_put(skb, pid, seq, type, len, flags); })

#define NLMSG_PUT(skb, pid, seq, type, len) \
	NLMSG_NEW(skb, pid, seq, type, len, 0)
240

L
Linus Torvalds 已提交
241 242 243 244 245 246 247 248 249 250 251 252 253
extern int netlink_dump_start(struct sock *ssk, struct sk_buff *skb,
			      struct nlmsghdr *nlh,
			      int (*dump)(struct sk_buff *skb, struct netlink_callback*),
			      int (*done)(struct netlink_callback*));


#define NL_NONROOT_RECV 0x1
#define NL_NONROOT_SEND 0x2
extern void netlink_set_nonroot(int protocol, unsigned flag);

#endif /* __KERNEL__ */

#endif	/* __LINUX_NETLINK_H */