Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
6bf9d8f6 | 2 | |
b2cbae2c RD |
3 | #ifndef _RDMA_NETLINK_H |
4 | #define _RDMA_NETLINK_H | |
5 | ||
b2cbae2c | 6 | #include <linux/netlink.h> |
7235aa79 | 7 | #include <uapi/rdma/rdma_netlink.h> |
b2cbae2c | 8 | |
34d65cd8 DL |
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 | ||
3250b4db | 15 | struct rdma_nl_cbs { |
1830ba21 LR |
16 | int (*doit)(struct sk_buff *skb, struct nlmsghdr *nlh, |
17 | struct netlink_ext_ack *extack); | |
b2cbae2c | 18 | int (*dump)(struct sk_buff *skb, struct netlink_callback *nlcb); |
e3a2b93d LR |
19 | u8 flags; |
20 | }; | |
21 | ||
22 | enum rdma_nl_flags { | |
23 | /* Require CAP_NET_ADMIN */ | |
24 | RDMA_NL_ADMIN_PERM = 1 << 0, | |
b2cbae2c RD |
25 | }; |
26 | ||
e3bf14bd JG |
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) \ | |
83dde749 | 33 | static inline void __maybe_unused __chk_##_index(void) \ |
e3bf14bd JG |
34 | { \ |
35 | BUILD_BUG_ON(_index != _val); \ | |
36 | } \ | |
37 | MODULE_ALIAS("rdma-netlink-subsys-" __stringify(_val)) | |
38 | ||
b2cbae2c | 39 | /** |
c9901724 | 40 | * Register client in RDMA netlink. |
b2cbae2c | 41 | * @index: Index of the added client |
b2cbae2c | 42 | * @cb_table: A table for op->callback |
b2cbae2c | 43 | */ |
c9901724 | 44 | void rdma_nl_register(unsigned int index, |
3250b4db | 45 | const struct rdma_nl_cbs cb_table[]); |
b2cbae2c RD |
46 | |
47 | /** | |
48 | * Remove a client from IB netlink. | |
49 | * @index: Index of the removed IB client. | |
b2cbae2c | 50 | */ |
c9901724 | 51 | void rdma_nl_unregister(unsigned int index); |
b2cbae2c RD |
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, | |
30dc5e63 | 64 | int len, int client, int op, int flags); |
b2cbae2c RD |
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 | ||
30dc5e63 TN |
77 | /** |
78 | * Send the supplied skb to a specific userspace PID. | |
1d2fedd8 | 79 | * @net: Net namespace in which to send the skb |
30dc5e63 | 80 | * @skb: The netlink skb |
30dc5e63 TN |
81 | * @pid: Userspace netlink process ID |
82 | * Returns 0 on success or a negative error code. | |
83 | */ | |
1d2fedd8 | 84 | int rdma_nl_unicast(struct net *net, struct sk_buff *skb, u32 pid); |
30dc5e63 | 85 | |
9047811b IM |
86 | /** |
87 | * Send, with wait/1 retry, the supplied skb to a specific userspace PID. | |
1d2fedd8 | 88 | * @net: Net namespace in which to send the skb |
9047811b | 89 | * @skb: The netlink skb |
9047811b IM |
90 | * @pid: Userspace netlink process ID |
91 | * Returns 0 on success or a negative error code. | |
92 | */ | |
1d2fedd8 | 93 | int rdma_nl_unicast_wait(struct net *net, struct sk_buff *skb, __u32 pid); |
9047811b | 94 | |
30dc5e63 TN |
95 | /** |
96 | * Send the supplied skb to a netlink group. | |
1d2fedd8 | 97 | * @net: Net namespace in which to send the skb |
30dc5e63 | 98 | * @skb: The netlink skb |
30dc5e63 TN |
99 | * @group: Netlink group ID |
100 | * @flags: allocation flags | |
101 | * Returns 0 on success or a negative error code. | |
102 | */ | |
1d2fedd8 PP |
103 | int rdma_nl_multicast(struct net *net, struct sk_buff *skb, |
104 | unsigned int group, gfp_t flags); | |
30dc5e63 | 105 | |
ff61c425 LR |
106 | /** |
107 | * Check if there are any listeners to the netlink group | |
108 | * @group: the netlink group ID | |
38716732 | 109 | * Returns true on success or false if no listeners. |
ff61c425 | 110 | */ |
38716732 | 111 | bool rdma_nl_chk_listeners(unsigned int group); |
3856ec4b SW |
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) | |
0e2d00eb JG |
123 | #define MODULE_ALIAS_RDMA_CLIENT(type) MODULE_ALIAS("rdma-client-" type) |
124 | ||
b2cbae2c | 125 | #endif /* _RDMA_NETLINK_H */ |