xref: /linux/include/rdma/rdma_netlink.h (revision ca55b2fef3a9373fcfc30f82fd26bc7fccbda732)
1 #ifndef _RDMA_NETLINK_H
2 #define _RDMA_NETLINK_H
3 
4 
5 #include <linux/netlink.h>
6 #include <uapi/rdma/rdma_netlink.h>
7 
8 struct ibnl_client_cbs {
9 	int (*dump)(struct sk_buff *skb, struct netlink_callback *nlcb);
10 	struct module *module;
11 };
12 
13 int ibnl_init(void);
14 void ibnl_cleanup(void);
15 
16 /**
17  * Add a a client to the list of IB netlink exporters.
18  * @index: Index of the added client
19  * @nops: Number of supported ops by the added client.
20  * @cb_table: A table for op->callback
21  *
22  * Returns 0 on success or a negative error code.
23  */
24 int ibnl_add_client(int index, int nops,
25 		    const struct ibnl_client_cbs cb_table[]);
26 
27 /**
28  * Remove a client from IB netlink.
29  * @index: Index of the removed IB client.
30  *
31  * Returns 0 on success or a negative error code.
32  */
33 int ibnl_remove_client(int index);
34 
35 /**
36  * Put a new message in a supplied skb.
37  * @skb: The netlink skb.
38  * @nlh: Pointer to put the header of the new netlink message.
39  * @seq: The message sequence number.
40  * @len: The requested message length to allocate.
41  * @client: Calling IB netlink client.
42  * @op: message content op.
43  * Returns the allocated buffer on success and NULL on failure.
44  */
45 void *ibnl_put_msg(struct sk_buff *skb, struct nlmsghdr **nlh, int seq,
46 		   int len, int client, int op, int flags);
47 /**
48  * Put a new attribute in a supplied skb.
49  * @skb: The netlink skb.
50  * @nlh: Header of the netlink message to append the attribute to.
51  * @len: The length of the attribute data.
52  * @data: The attribute data to put.
53  * @type: The attribute type.
54  * Returns the 0 and a negative error code on failure.
55  */
56 int ibnl_put_attr(struct sk_buff *skb, struct nlmsghdr *nlh,
57 		  int len, void *data, int type);
58 
59 /**
60  * Send the supplied skb to a specific userspace PID.
61  * @skb: The netlink skb
62  * @nlh: Header of the netlink message to send
63  * @pid: Userspace netlink process ID
64  * Returns 0 on success or a negative error code.
65  */
66 int ibnl_unicast(struct sk_buff *skb, struct nlmsghdr *nlh,
67 			__u32 pid);
68 
69 /**
70  * Send the supplied skb to a netlink group.
71  * @skb: The netlink skb
72  * @nlh: Header of the netlink message to send
73  * @group: Netlink group ID
74  * @flags: allocation flags
75  * Returns 0 on success or a negative error code.
76  */
77 int ibnl_multicast(struct sk_buff *skb, struct nlmsghdr *nlh,
78 			unsigned int group, gfp_t flags);
79 
80 /**
81  * Check if there are any listeners to the netlink group
82  * @group: the netlink group ID
83  * Returns 0 on success or a negative for no listeners.
84  */
85 int ibnl_chk_listeners(unsigned int group);
86 
87 #endif /* _RDMA_NETLINK_H */
88