• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * GPL HEADER START
3  *
4  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 only,
8  * as published by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License version 2 for more details (a copy is included
14  * in the LICENSE file that accompanied this code).
15  *
16  * You should have received a copy of the GNU General Public License
17  * version 2 along with this program; If not, see
18  * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
19  *
20  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
21  * CA 95054 USA or visit www.sun.com if you need additional information or
22  * have any questions.
23  *
24  * GPL HEADER END
25  */
26 /*
27  * Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.
28  * Use is subject to license terms.
29  *
30  * Copyright (c) 2012, Intel Corporation.
31  */
32 /*
33  * This file is part of Lustre, http://www.lustre.org/
34  * Lustre is a trademark of Sun Microsystems, Inc.
35  *
36  * Author: Nathan Rutman <nathan.rutman@sun.com>
37  *
38  * Kernel <-> userspace communication routines.
39  * Using pipes for all arches.
40  */
41 
42 #define DEBUG_SUBSYSTEM S_CLASS
43 #define D_KUC D_OTHER
44 
45 #include "../../include/linux/libcfs/libcfs.h"
46 
47 /* This is the kernel side (liblustre as well). */
48 
49 /**
50  * libcfs_kkuc_msg_put - send an message from kernel to userspace
51  * @param fp to send the message to
52  * @param payload Payload data.  First field of payload is always
53  *   struct kuc_hdr
54  */
libcfs_kkuc_msg_put(struct file * filp,void * payload)55 int libcfs_kkuc_msg_put(struct file *filp, void *payload)
56 {
57 	struct kuc_hdr *kuch = (struct kuc_hdr *)payload;
58 	ssize_t count = kuch->kuc_msglen;
59 	loff_t offset = 0;
60 	mm_segment_t fs;
61 	int rc = -ENOSYS;
62 
63 	if (filp == NULL || IS_ERR(filp))
64 		return -EBADF;
65 
66 	if (kuch->kuc_magic != KUC_MAGIC) {
67 		CERROR("KernelComm: bad magic %x\n", kuch->kuc_magic);
68 		return -ENOSYS;
69 	}
70 
71 	fs = get_fs();
72 	set_fs(KERNEL_DS);
73 	while (count > 0) {
74 		rc = vfs_write(filp, (void __force __user *)payload,
75 			       count, &offset);
76 		if (rc < 0)
77 			break;
78 		count -= rc;
79 		payload += rc;
80 		rc = 0;
81 	}
82 	set_fs(fs);
83 
84 	if (rc < 0)
85 		CWARN("message send failed (%d)\n", rc);
86 	else
87 		CDEBUG(D_KUC, "Sent message rc=%d, fp=%p\n", rc, filp);
88 
89 	return rc;
90 }
91 EXPORT_SYMBOL(libcfs_kkuc_msg_put);
92 
93 /* Broadcast groups are global across all mounted filesystems;
94  * i.e. registering for a group on 1 fs will get messages for that
95  * group from any fs */
96 /** A single group registration has a uid and a file pointer */
97 struct kkuc_reg {
98 	struct list_head	kr_chain;
99 	int		kr_uid;
100 	struct file	*kr_fp;
101 	__u32		kr_data;
102 };
103 
104 static struct list_head kkuc_groups[KUC_GRP_MAX+1] = {};
105 /* Protect message sending against remove and adds */
106 static DECLARE_RWSEM(kg_sem);
107 
108 /** Add a receiver to a broadcast group
109  * @param filp pipe to write into
110  * @param uid identifier for this receiver
111  * @param group group number
112  */
libcfs_kkuc_group_add(struct file * filp,int uid,int group,__u32 data)113 int libcfs_kkuc_group_add(struct file *filp, int uid, int group, __u32 data)
114 {
115 	struct kkuc_reg *reg;
116 
117 	if (group > KUC_GRP_MAX) {
118 		CDEBUG(D_WARNING, "Kernelcomm: bad group %d\n", group);
119 		return -EINVAL;
120 	}
121 
122 	/* fput in group_rem */
123 	if (filp == NULL)
124 		return -EBADF;
125 
126 	/* freed in group_rem */
127 	reg = kmalloc(sizeof(*reg), 0);
128 	if (reg == NULL)
129 		return -ENOMEM;
130 
131 	reg->kr_fp = filp;
132 	reg->kr_uid = uid;
133 	reg->kr_data = data;
134 
135 	down_write(&kg_sem);
136 	if (kkuc_groups[group].next == NULL)
137 		INIT_LIST_HEAD(&kkuc_groups[group]);
138 	list_add(&reg->kr_chain, &kkuc_groups[group]);
139 	up_write(&kg_sem);
140 
141 	CDEBUG(D_KUC, "Added uid=%d fp=%p to group %d\n", uid, filp, group);
142 
143 	return 0;
144 }
145 EXPORT_SYMBOL(libcfs_kkuc_group_add);
146 
libcfs_kkuc_group_rem(int uid,int group)147 int libcfs_kkuc_group_rem(int uid, int group)
148 {
149 	struct kkuc_reg *reg, *next;
150 
151 	if (kkuc_groups[group].next == NULL)
152 		return 0;
153 
154 	if (uid == 0) {
155 		/* Broadcast a shutdown message */
156 		struct kuc_hdr lh;
157 
158 		lh.kuc_magic = KUC_MAGIC;
159 		lh.kuc_transport = KUC_TRANSPORT_GENERIC;
160 		lh.kuc_msgtype = KUC_MSG_SHUTDOWN;
161 		lh.kuc_msglen = sizeof(lh);
162 		libcfs_kkuc_group_put(group, &lh);
163 	}
164 
165 	down_write(&kg_sem);
166 	list_for_each_entry_safe(reg, next, &kkuc_groups[group], kr_chain) {
167 		if ((uid == 0) || (uid == reg->kr_uid)) {
168 			list_del(&reg->kr_chain);
169 			CDEBUG(D_KUC, "Removed uid=%d fp=%p from group %d\n",
170 			       reg->kr_uid, reg->kr_fp, group);
171 			if (reg->kr_fp != NULL)
172 				fput(reg->kr_fp);
173 			kfree(reg);
174 		}
175 	}
176 	up_write(&kg_sem);
177 
178 	return 0;
179 }
180 EXPORT_SYMBOL(libcfs_kkuc_group_rem);
181 
libcfs_kkuc_group_put(int group,void * payload)182 int libcfs_kkuc_group_put(int group, void *payload)
183 {
184 	struct kkuc_reg	*reg;
185 	int		 rc = 0;
186 	int one_success = 0;
187 
188 	down_read(&kg_sem);
189 	list_for_each_entry(reg, &kkuc_groups[group], kr_chain) {
190 		if (reg->kr_fp != NULL) {
191 			rc = libcfs_kkuc_msg_put(reg->kr_fp, payload);
192 			if (rc == 0)
193 				one_success = 1;
194 			else if (rc == -EPIPE) {
195 				fput(reg->kr_fp);
196 				reg->kr_fp = NULL;
197 			}
198 		}
199 	}
200 	up_read(&kg_sem);
201 
202 	/* don't return an error if the message has been delivered
203 	 * at least to one agent */
204 	if (one_success)
205 		rc = 0;
206 
207 	return rc;
208 }
209 EXPORT_SYMBOL(libcfs_kkuc_group_put);
210 
211 /**
212  * Calls a callback function for each link of the given kuc group.
213  * @param group the group to call the function on.
214  * @param cb_func the function to be called.
215  * @param cb_arg iextra argument to be passed to the callback function.
216  */
libcfs_kkuc_group_foreach(int group,libcfs_kkuc_cb_t cb_func,void * cb_arg)217 int libcfs_kkuc_group_foreach(int group, libcfs_kkuc_cb_t cb_func,
218 			      void *cb_arg)
219 {
220 	struct kkuc_reg *reg;
221 	int rc = 0;
222 
223 	if (group > KUC_GRP_MAX) {
224 		CDEBUG(D_WARNING, "Kernelcomm: bad group %d\n", group);
225 		return -EINVAL;
226 	}
227 
228 	/* no link for this group */
229 	if (kkuc_groups[group].next == NULL)
230 		return 0;
231 
232 	down_write(&kg_sem);
233 	list_for_each_entry(reg, &kkuc_groups[group], kr_chain) {
234 		if (reg->kr_fp != NULL)
235 			rc = cb_func(reg->kr_data, cb_arg);
236 	}
237 	up_write(&kg_sem);
238 
239 	return rc;
240 }
241 EXPORT_SYMBOL(libcfs_kkuc_group_foreach);
242