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
9enum {
10 RDMA_NLDEV_ATTR_EMPTY_STRING = 1,
11 RDMA_NLDEV_ATTR_ENTRY_STRLEN = 16,
12 RDMA_NLDEV_ATTR_CHARDEV_TYPE_SIZE = 32,
13};
14
15struct 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
22enum 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 */
44void 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 */
51void 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 */
63void *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 */
74int 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 */
84int 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 */
93int 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 */
103int 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 */
111bool rdma_nl_chk_listeners(unsigned int group);
112
113struct 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
119void rdma_link_register(struct rdma_link_ops *ops);
120void 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

source code of linux/include/rdma/rdma_netlink.h