netlink.h 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288
  1. #ifndef __LINUX_NETLINK_H
  2. #define __LINUX_NETLINK_H
  3. #include <linux/socket.h> /* for __kernel_sa_family_t */
  4. #include <linux/types.h>
  5. #define NETLINK_ROUTE 0 /* Routing/device hook */
  6. #define NETLINK_UNUSED 1 /* Unused number */
  7. #define NETLINK_USERSOCK 2 /* Reserved for user mode socket protocols */
  8. #define NETLINK_FIREWALL 3 /* Unused number, formerly ip_queue */
  9. #define NETLINK_SOCK_DIAG 4 /* socket monitoring */
  10. #define NETLINK_NFLOG 5 /* netfilter/iptables ULOG */
  11. #define NETLINK_XFRM 6 /* ipsec */
  12. #define NETLINK_SELINUX 7 /* SELinux event notifications */
  13. #define NETLINK_ISCSI 8 /* Open-iSCSI */
  14. #define NETLINK_AUDIT 9 /* auditing */
  15. #define NETLINK_FIB_LOOKUP 10
  16. #define NETLINK_CONNECTOR 11
  17. #define NETLINK_NETFILTER 12 /* netfilter subsystem */
  18. #define NETLINK_IP6_FW 13
  19. #define NETLINK_DNRTMSG 14 /* DECnet routing messages */
  20. #define NETLINK_KOBJECT_UEVENT 15 /* Kernel messages to userspace */
  21. #define NETLINK_GENERIC 16
  22. /* leave room for NETLINK_DM (DM Events) */
  23. #define NETLINK_SCSITRANSPORT 18 /* SCSI Transports */
  24. #define NETLINK_ECRYPTFS 19
  25. #define NETLINK_RDMA 20
  26. #define NETLINK_CRYPTO 21 /* Crypto layer */
  27. #define NETLINK_INET_DIAG NETLINK_SOCK_DIAG
  28. #define MAX_LINKS 32
  29. struct sockaddr_nl {
  30. __kernel_sa_family_t nl_family; /* AF_NETLINK */
  31. unsigned short nl_pad; /* zero */
  32. __u32 nl_pid; /* port ID */
  33. __u32 nl_groups; /* multicast groups mask */
  34. };
  35. struct nlmsghdr {
  36. __u32 nlmsg_len; /* Length of message including header */
  37. __u16 nlmsg_type; /* Message content */
  38. __u16 nlmsg_flags; /* Additional flags */
  39. __u32 nlmsg_seq; /* Sequence number */
  40. __u32 nlmsg_pid; /* Sending process port ID */
  41. };
  42. /* Flags values */
  43. #define NLM_F_REQUEST 1 /* It is request message. */
  44. #define NLM_F_MULTI 2 /* Multipart message, terminated by NLMSG_DONE */
  45. #define NLM_F_ACK 4 /* Reply with ack, with zero or error code */
  46. #define NLM_F_ECHO 8 /* Echo this request */
  47. #define NLM_F_DUMP_INTR 16 /* Dump was inconsistent due to sequence change */
  48. /* Modifiers to GET request */
  49. #define NLM_F_ROOT 0x100 /* specify tree root */
  50. #define NLM_F_MATCH 0x200 /* return all matching */
  51. #define NLM_F_ATOMIC 0x400 /* atomic GET */
  52. #define NLM_F_DUMP (NLM_F_ROOT|NLM_F_MATCH)
  53. /* Modifiers to NEW request */
  54. #define NLM_F_REPLACE 0x100 /* Override existing */
  55. #define NLM_F_EXCL 0x200 /* Do not touch, if it exists */
  56. #define NLM_F_CREATE 0x400 /* Create, if it does not exist */
  57. #define NLM_F_APPEND 0x800 /* Add to end of list */
  58. /*
  59. 4.4BSD ADD NLM_F_CREATE|NLM_F_EXCL
  60. 4.4BSD CHANGE NLM_F_REPLACE
  61. True CHANGE NLM_F_CREATE|NLM_F_REPLACE
  62. Append NLM_F_CREATE
  63. Check NLM_F_EXCL
  64. */
  65. #define NLMSG_ALIGNTO 4U
  66. #define NLMSG_ALIGN(len) ( ((len)+NLMSG_ALIGNTO-1) & ~(NLMSG_ALIGNTO-1) )
  67. #define NLMSG_HDRLEN ((int) NLMSG_ALIGN(sizeof(struct nlmsghdr)))
  68. #define NLMSG_LENGTH(len) ((len)+NLMSG_ALIGN(NLMSG_HDRLEN))
  69. #define NLMSG_SPACE(len) NLMSG_ALIGN(NLMSG_LENGTH(len))
  70. #define NLMSG_DATA(nlh) ((void*)(((char*)nlh) + NLMSG_LENGTH(0)))
  71. #define NLMSG_NEXT(nlh,len) ((len) -= NLMSG_ALIGN((nlh)->nlmsg_len), \
  72. (struct nlmsghdr*)(((char*)(nlh)) + NLMSG_ALIGN((nlh)->nlmsg_len)))
  73. #define NLMSG_OK(nlh,len) ((len) >= (int)sizeof(struct nlmsghdr) && \
  74. (nlh)->nlmsg_len >= sizeof(struct nlmsghdr) && \
  75. (nlh)->nlmsg_len <= (len))
  76. #define NLMSG_PAYLOAD(nlh,len) ((nlh)->nlmsg_len - NLMSG_SPACE((len)))
  77. #define NLMSG_NOOP 0x1 /* Nothing. */
  78. #define NLMSG_ERROR 0x2 /* Error */
  79. #define NLMSG_DONE 0x3 /* End of a dump */
  80. #define NLMSG_OVERRUN 0x4 /* Data lost */
  81. #define NLMSG_MIN_TYPE 0x10 /* < 0x10: reserved control messages */
  82. struct nlmsgerr {
  83. int error;
  84. struct nlmsghdr msg;
  85. };
  86. #define NETLINK_ADD_MEMBERSHIP 1
  87. #define NETLINK_DROP_MEMBERSHIP 2
  88. #define NETLINK_PKTINFO 3
  89. #define NETLINK_BROADCAST_ERROR 4
  90. #define NETLINK_NO_ENOBUFS 5
  91. struct nl_pktinfo {
  92. __u32 group;
  93. };
  94. #define NET_MAJOR 36 /* Major 36 is reserved for networking */
  95. enum {
  96. NETLINK_UNCONNECTED = 0,
  97. NETLINK_CONNECTED,
  98. };
  99. /*
  100. * <------- NLA_HDRLEN ------> <-- NLA_ALIGN(payload)-->
  101. * +---------------------+- - -+- - - - - - - - - -+- - -+
  102. * | Header | Pad | Payload | Pad |
  103. * | (struct nlattr) | ing | | ing |
  104. * +---------------------+- - -+- - - - - - - - - -+- - -+
  105. * <-------------- nlattr->nla_len -------------->
  106. */
  107. struct nlattr {
  108. __u16 nla_len;
  109. __u16 nla_type;
  110. };
  111. /*
  112. * nla_type (16 bits)
  113. * +---+---+-------------------------------+
  114. * | N | O | Attribute Type |
  115. * +---+---+-------------------------------+
  116. * N := Carries nested attributes
  117. * O := Payload stored in network byte order
  118. *
  119. * Note: The N and O flag are mutually exclusive.
  120. */
  121. #define NLA_F_NESTED (1 << 15)
  122. #define NLA_F_NET_BYTEORDER (1 << 14)
  123. #define NLA_TYPE_MASK ~(NLA_F_NESTED | NLA_F_NET_BYTEORDER)
  124. #define NLA_ALIGNTO 4
  125. #define NLA_ALIGN(len) (((len) + NLA_ALIGNTO - 1) & ~(NLA_ALIGNTO - 1))
  126. #define NLA_HDRLEN ((int) NLA_ALIGN(sizeof(struct nlattr)))
  127. #ifdef __KERNEL__
  128. #include <linux/capability.h>
  129. #include <linux/skbuff.h>
  130. #include <linux/export.h>
  131. #include <net/scm.h>
  132. struct net;
  133. static inline struct nlmsghdr *nlmsg_hdr(const struct sk_buff *skb)
  134. {
  135. return (struct nlmsghdr *)skb->data;
  136. }
  137. struct netlink_skb_parms {
  138. struct scm_creds creds; /* Skb credentials */
  139. __u32 portid;
  140. __u32 dst_group;
  141. struct sock *ssk;
  142. };
  143. #define NETLINK_CB(skb) (*(struct netlink_skb_parms*)&((skb)->cb))
  144. #define NETLINK_CREDS(skb) (&NETLINK_CB((skb)).creds)
  145. extern void netlink_table_grab(void);
  146. extern void netlink_table_ungrab(void);
  147. #define NL_CFG_F_NONROOT_RECV (1 << 0)
  148. #define NL_CFG_F_NONROOT_SEND (1 << 1)
  149. /* optional Netlink kernel configuration parameters */
  150. struct netlink_kernel_cfg {
  151. unsigned int groups;
  152. unsigned int flags;
  153. void (*input)(struct sk_buff *skb);
  154. struct mutex *cb_mutex;
  155. void (*bind)(int group);
  156. };
  157. extern struct sock *__netlink_kernel_create(struct net *net, int unit,
  158. struct module *module,
  159. struct netlink_kernel_cfg *cfg);
  160. static inline struct sock *
  161. netlink_kernel_create(struct net *net, int unit, struct netlink_kernel_cfg *cfg)
  162. {
  163. return __netlink_kernel_create(net, unit, THIS_MODULE, cfg);
  164. }
  165. extern void netlink_kernel_release(struct sock *sk);
  166. extern int __netlink_change_ngroups(struct sock *sk, unsigned int groups);
  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);
  169. extern void netlink_clear_multicast_users(struct sock *sk, unsigned int group);
  170. extern void netlink_ack(struct sk_buff *in_skb, struct nlmsghdr *nlh, int err);
  171. extern int netlink_has_listeners(struct sock *sk, unsigned int group);
  172. extern int netlink_unicast(struct sock *ssk, struct sk_buff *skb, __u32 portid, int nonblock);
  173. extern int netlink_broadcast(struct sock *ssk, struct sk_buff *skb, __u32 portid,
  174. __u32 group, gfp_t allocation);
  175. extern int netlink_broadcast_filtered(struct sock *ssk, struct sk_buff *skb,
  176. __u32 portid, __u32 group, gfp_t allocation,
  177. int (*filter)(struct sock *dsk, struct sk_buff *skb, void *data),
  178. void *filter_data);
  179. extern int netlink_set_err(struct sock *ssk, __u32 portid, __u32 group, int code);
  180. extern int netlink_register_notifier(struct notifier_block *nb);
  181. extern int netlink_unregister_notifier(struct notifier_block *nb);
  182. /* finegrained unicast helpers: */
  183. struct sock *netlink_getsockbyfilp(struct file *filp);
  184. int netlink_attachskb(struct sock *sk, struct sk_buff *skb,
  185. long *timeo, struct sock *ssk);
  186. void netlink_detachskb(struct sock *sk, struct sk_buff *skb);
  187. int netlink_sendskb(struct sock *sk, struct sk_buff *skb);
  188. /*
  189. * skb should fit one page. This choice is good for headerless malloc.
  190. * But we should limit to 8K so that userspace does not have to
  191. * use enormous buffer sizes on recvmsg() calls just to avoid
  192. * MSG_TRUNC when PAGE_SIZE is very large.
  193. */
  194. #if PAGE_SIZE < 8192UL
  195. #define NLMSG_GOODSIZE SKB_WITH_OVERHEAD(PAGE_SIZE)
  196. #else
  197. #define NLMSG_GOODSIZE SKB_WITH_OVERHEAD(8192UL)
  198. #endif
  199. #define NLMSG_DEFAULT_SIZE (NLMSG_GOODSIZE - NLMSG_HDRLEN)
  200. struct netlink_callback {
  201. struct sk_buff *skb;
  202. const struct nlmsghdr *nlh;
  203. int (*dump)(struct sk_buff * skb,
  204. struct netlink_callback *cb);
  205. int (*done)(struct netlink_callback *cb);
  206. void *data;
  207. /* the module that dump function belong to */
  208. struct module *module;
  209. u16 family;
  210. u16 min_dump_alloc;
  211. unsigned int prev_seq, seq;
  212. long args[6];
  213. };
  214. struct netlink_notify {
  215. struct net *net;
  216. int portid;
  217. int protocol;
  218. };
  219. struct nlmsghdr *
  220. __nlmsg_put(struct sk_buff *skb, u32 portid, u32 seq, int type, int len, int flags);
  221. struct netlink_dump_control {
  222. int (*dump)(struct sk_buff *skb, struct netlink_callback *);
  223. int (*done)(struct netlink_callback *);
  224. void *data;
  225. struct module *module;
  226. u16 min_dump_alloc;
  227. };
  228. extern int __netlink_dump_start(struct sock *ssk, struct sk_buff *skb,
  229. const struct nlmsghdr *nlh,
  230. struct netlink_dump_control *control);
  231. static inline int netlink_dump_start(struct sock *ssk, struct sk_buff *skb,
  232. const struct nlmsghdr *nlh,
  233. struct netlink_dump_control *control)
  234. {
  235. if (!control->module)
  236. control->module = THIS_MODULE;
  237. return __netlink_dump_start(ssk, skb, nlh, control);
  238. }
  239. #endif /* __KERNEL__ */
  240. #endif /* __LINUX_NETLINK_H */