xref: /openbmc/linux/include/rdma/rdma_netlink.h (revision 35431351)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 
3 #ifndef _RDMA_NETLINK_H
4 #define _RDMA_NETLINK_H
5 
6 #include <linux/netlink.h>
7 #include <uapi/rdma/rdma_netlink.h>
8 
9 enum {
10 	RDMA_NLDEV_ATTR_EMPTY_STRING = 1,
11 	RDMA_NLDEV_ATTR_ENTRY_STRLEN = 16,
12 	RDMA_NLDEV_ATTR_CHARDEV_TYPE_SIZE = 32,
13 };
14 
15 struct rdma_nl_cbs {
16 	int (*doit)(struct sk_buff *skb, struct nlmsghdr *nlh,
17 		    struct netlink_ext_ack *extack);
18 	int (*dump)(struct sk_buff *skb, struct netlink_callback *nlcb);
19 	u8 flags;
20 };
21 
22 enum rdma_nl_flags {
23 	/* Require CAP_NET_ADMIN */
24 	RDMA_NL_ADMIN_PERM	= 1 << 0,
25 };
26 
27 /* Define this module as providing netlink services for NETLINK_RDMA, with
28  * index _index.  Since the client indexes were setup in a uapi header as an
29  * enum and we do no want to change that, the user must supply the expanded
30  * constant as well and the compiler checks they are the same.
31  */
32 #define MODULE_ALIAS_RDMA_NETLINK(_index, _val)                                \
33 	static inline void __maybe_unused __chk_##_index(void)                 \
34 	{                                                                      \
35 		BUILD_BUG_ON(_index != _val);                                  \
36 	}                                                                      \
37 	MODULE_ALIAS("rdma-netlink-subsys-" __stringify(_val))
38 
39 /**
40  * Register client in RDMA netlink.
41  * @index: Index of the added client
42  * @cb_table: A table for op->callback
43  */
44 void rdma_nl_register(unsigned int index,
45 		      const struct rdma_nl_cbs cb_table[]);
46 
47 /**
48  * Remove a client from IB netlink.
49  * @index: Index of the removed IB client.
50  */
51 void rdma_nl_unregister(unsigned int index);
52 
53 /**
54  * Put a new message in a supplied skb.
55  * @skb: The netlink skb.
56  * @nlh: Pointer to put the header of the new netlink message.
57  * @seq: The message sequence number.
58  * @len: The requested message length to allocate.
59  * @client: Calling IB netlink client.
60  * @op: message content op.
61  * Returns the allocated buffer on success and NULL on failure.
62  */
63 void *ibnl_put_msg(struct sk_buff *skb, struct nlmsghdr **nlh, int seq,
64 		   int len, int client, int op, int flags);
65 /**
66  * Put a new attribute in a supplied skb.
67  * @skb: The netlink skb.
68  * @nlh: Header of the netlink message to append the attribute to.
69  * @len: The length of the attribute data.
70  * @data: The attribute data to put.
71  * @type: The attribute type.
72  * Returns the 0 and a negative error code on failure.
73  */
74 int ibnl_put_attr(struct sk_buff *skb, struct nlmsghdr *nlh,
75 		  int len, void *data, int type);
76 
77 /**
78  * Send the supplied skb to a specific userspace PID.
79  * @net: Net namespace in which to send the skb
80  * @skb: The netlink skb
81  * @pid: Userspace netlink process ID
82  * Returns 0 on success or a negative error code.
83  */
84 int rdma_nl_unicast(struct net *net, struct sk_buff *skb, u32 pid);
85 
86 /**
87  * Send, with wait/1 retry, the supplied skb to a specific userspace PID.
88  * @net: Net namespace in which to send the skb
89  * @skb: The netlink skb
90  * @pid: Userspace netlink process ID
91  * Returns 0 on success or a negative error code.
92  */
93 int rdma_nl_unicast_wait(struct net *net, struct sk_buff *skb, __u32 pid);
94 
95 /**
96  * Send the supplied skb to a netlink group.
97  * @net: Net namespace in which to send the skb
98  * @skb: The netlink skb
99  * @group: Netlink group ID
100  * @flags: allocation flags
101  * Returns 0 on success or a negative error code.
102  */
103 int rdma_nl_multicast(struct net *net, struct sk_buff *skb,
104 		      unsigned int group, gfp_t flags);
105 
106 /**
107  * Check if there are any listeners to the netlink group
108  * @group: the netlink group ID
109  * Returns true on success or false if no listeners.
110  */
111 bool rdma_nl_chk_listeners(unsigned int group);
112 
113 struct rdma_link_ops {
114 	struct list_head list;
115 	const char *type;
116 	int (*newlink)(const char *ibdev_name, struct net_device *ndev);
117 };
118 
119 void rdma_link_register(struct rdma_link_ops *ops);
120 void rdma_link_unregister(struct rdma_link_ops *ops);
121 
122 #define MODULE_ALIAS_RDMA_LINK(type) MODULE_ALIAS("rdma-link-" type)
123 #define MODULE_ALIAS_RDMA_CLIENT(type) MODULE_ALIAS("rdma-client-" type)
124 
125 #endif /* _RDMA_NETLINK_H */
126