Blackfin arch: clean up sports header file
[linux-2.6/mini2440.git] / drivers / connector / connector.c
blobfd336c5a9057a8da729ebd2d3961cbb7b6a4c271
1 /*
2 * connector.c
4 * 2004-2005 Copyright (c) Evgeniy Polyakov <johnpol@2ka.mipt.ru>
5 * All rights reserved.
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #include <linux/kernel.h>
23 #include <linux/module.h>
24 #include <linux/list.h>
25 #include <linux/skbuff.h>
26 #include <linux/netlink.h>
27 #include <linux/moduleparam.h>
28 #include <linux/connector.h>
29 #include <linux/mutex.h>
30 #include <linux/proc_fs.h>
31 #include <linux/spinlock.h>
33 #include <net/sock.h>
35 MODULE_LICENSE("GPL");
36 MODULE_AUTHOR("Evgeniy Polyakov <johnpol@2ka.mipt.ru>");
37 MODULE_DESCRIPTION("Generic userspace <-> kernelspace connector.");
39 static u32 cn_idx = CN_IDX_CONNECTOR;
40 static u32 cn_val = CN_VAL_CONNECTOR;
42 module_param(cn_idx, uint, 0);
43 module_param(cn_val, uint, 0);
44 MODULE_PARM_DESC(cn_idx, "Connector's main device idx.");
45 MODULE_PARM_DESC(cn_val, "Connector's main device val.");
47 static DEFINE_MUTEX(notify_lock);
48 static LIST_HEAD(notify_list);
50 static struct cn_dev cdev;
52 static int cn_already_initialized;
55 * msg->seq and msg->ack are used to determine message genealogy.
56 * When someone sends message it puts there locally unique sequence
57 * and random acknowledge numbers. Sequence number may be copied into
58 * nlmsghdr->nlmsg_seq too.
60 * Sequence number is incremented with each message to be sent.
62 * If we expect reply to our message then the sequence number in
63 * received message MUST be the same as in original message, and
64 * acknowledge number MUST be the same + 1.
66 * If we receive a message and its sequence number is not equal to the
67 * one we are expecting then it is a new message.
69 * If we receive a message and its sequence number is the same as one
70 * we are expecting but it's acknowledgement number is not equal to
71 * the acknowledgement number in the original message + 1, then it is
72 * a new message.
75 int cn_netlink_send(struct cn_msg *msg, u32 __group, gfp_t gfp_mask)
77 struct cn_callback_entry *__cbq;
78 unsigned int size;
79 struct sk_buff *skb;
80 struct nlmsghdr *nlh;
81 struct cn_msg *data;
82 struct cn_dev *dev = &cdev;
83 u32 group = 0;
84 int found = 0;
86 if (!__group) {
87 spin_lock_bh(&dev->cbdev->queue_lock);
88 list_for_each_entry(__cbq, &dev->cbdev->queue_list,
89 callback_entry) {
90 if (cn_cb_equal(&__cbq->id.id, &msg->id)) {
91 found = 1;
92 group = __cbq->group;
93 break;
96 spin_unlock_bh(&dev->cbdev->queue_lock);
98 if (!found)
99 return -ENODEV;
100 } else {
101 group = __group;
104 if (!netlink_has_listeners(dev->nls, group))
105 return -ESRCH;
107 size = NLMSG_SPACE(sizeof(*msg) + msg->len);
109 skb = alloc_skb(size, gfp_mask);
110 if (!skb)
111 return -ENOMEM;
113 nlh = NLMSG_PUT(skb, 0, msg->seq, NLMSG_DONE, size - sizeof(*nlh));
115 data = NLMSG_DATA(nlh);
117 memcpy(data, msg, sizeof(*data) + msg->len);
119 NETLINK_CB(skb).dst_group = group;
121 return netlink_broadcast(dev->nls, skb, 0, group, gfp_mask);
123 nlmsg_failure:
124 kfree_skb(skb);
125 return -EINVAL;
127 EXPORT_SYMBOL_GPL(cn_netlink_send);
130 * Callback helper - queues work and setup destructor for given data.
132 static int cn_call_callback(struct cn_msg *msg, void (*destruct_data)(void *), void *data)
134 struct cn_callback_entry *__cbq, *__new_cbq;
135 struct cn_dev *dev = &cdev;
136 int err = -ENODEV;
138 spin_lock_bh(&dev->cbdev->queue_lock);
139 list_for_each_entry(__cbq, &dev->cbdev->queue_list, callback_entry) {
140 if (cn_cb_equal(&__cbq->id.id, &msg->id)) {
141 if (likely(!work_pending(&__cbq->work) &&
142 __cbq->data.ddata == NULL)) {
143 __cbq->data.callback_priv = msg;
145 __cbq->data.ddata = data;
146 __cbq->data.destruct_data = destruct_data;
148 if (queue_cn_work(__cbq, &__cbq->work))
149 err = 0;
150 else
151 err = -EINVAL;
152 } else {
153 struct cn_callback_data *d;
155 err = -ENOMEM;
156 __new_cbq = kzalloc(sizeof(struct cn_callback_entry), GFP_ATOMIC);
157 if (__new_cbq) {
158 d = &__new_cbq->data;
159 d->callback_priv = msg;
160 d->callback = __cbq->data.callback;
161 d->ddata = data;
162 d->destruct_data = destruct_data;
163 d->free = __new_cbq;
165 __new_cbq->pdev = __cbq->pdev;
167 INIT_WORK(&__new_cbq->work,
168 &cn_queue_wrapper);
170 if (queue_cn_work(__new_cbq,
171 &__new_cbq->work))
172 err = 0;
173 else {
174 kfree(__new_cbq);
175 err = -EINVAL;
179 break;
182 spin_unlock_bh(&dev->cbdev->queue_lock);
184 return err;
188 * Main netlink receiving function.
190 * It checks skb, netlink header and msg sizes, and calls callback helper.
192 static void cn_rx_skb(struct sk_buff *__skb)
194 struct cn_msg *msg;
195 struct nlmsghdr *nlh;
196 int err;
197 struct sk_buff *skb;
199 skb = skb_get(__skb);
201 if (skb->len >= NLMSG_SPACE(0)) {
202 nlh = nlmsg_hdr(skb);
204 if (nlh->nlmsg_len < sizeof(struct cn_msg) ||
205 skb->len < nlh->nlmsg_len ||
206 nlh->nlmsg_len > CONNECTOR_MAX_MSG_SIZE) {
207 kfree_skb(skb);
208 return;
211 msg = NLMSG_DATA(nlh);
212 err = cn_call_callback(msg, (void (*)(void *))kfree_skb, skb);
213 if (err < 0)
214 kfree_skb(skb);
219 * Notification routing.
221 * Gets id and checks if there are notification request for it's idx
222 * and val. If there are such requests notify the listeners with the
223 * given notify event.
226 static void cn_notify(struct cb_id *id, u32 notify_event)
228 struct cn_ctl_entry *ent;
230 mutex_lock(&notify_lock);
231 list_for_each_entry(ent, &notify_list, notify_entry) {
232 int i;
233 struct cn_notify_req *req;
234 struct cn_ctl_msg *ctl = ent->msg;
235 int idx_found, val_found;
237 idx_found = val_found = 0;
239 req = (struct cn_notify_req *)ctl->data;
240 for (i = 0; i < ctl->idx_notify_num; ++i, ++req) {
241 if (id->idx >= req->first &&
242 id->idx < req->first + req->range) {
243 idx_found = 1;
244 break;
248 for (i = 0; i < ctl->val_notify_num; ++i, ++req) {
249 if (id->val >= req->first &&
250 id->val < req->first + req->range) {
251 val_found = 1;
252 break;
256 if (idx_found && val_found) {
257 struct cn_msg m = { .ack = notify_event, };
259 memcpy(&m.id, id, sizeof(m.id));
260 cn_netlink_send(&m, ctl->group, GFP_KERNEL);
263 mutex_unlock(&notify_lock);
267 * Callback add routing - adds callback with given ID and name.
268 * If there is registered callback with the same ID it will not be added.
270 * May sleep.
272 int cn_add_callback(struct cb_id *id, char *name, void (*callback)(void *))
274 int err;
275 struct cn_dev *dev = &cdev;
277 if (!cn_already_initialized)
278 return -EAGAIN;
280 err = cn_queue_add_callback(dev->cbdev, name, id, callback);
281 if (err)
282 return err;
284 cn_notify(id, 0);
286 return 0;
288 EXPORT_SYMBOL_GPL(cn_add_callback);
291 * Callback remove routing - removes callback
292 * with given ID.
293 * If there is no registered callback with given
294 * ID nothing happens.
296 * May sleep while waiting for reference counter to become zero.
298 void cn_del_callback(struct cb_id *id)
300 struct cn_dev *dev = &cdev;
302 cn_queue_del_callback(dev->cbdev, id);
303 cn_notify(id, 1);
305 EXPORT_SYMBOL_GPL(cn_del_callback);
308 * Checks two connector's control messages to be the same.
309 * Returns 1 if they are the same or if the first one is corrupted.
311 static int cn_ctl_msg_equals(struct cn_ctl_msg *m1, struct cn_ctl_msg *m2)
313 int i;
314 struct cn_notify_req *req1, *req2;
316 if (m1->idx_notify_num != m2->idx_notify_num)
317 return 0;
319 if (m1->val_notify_num != m2->val_notify_num)
320 return 0;
322 if (m1->len != m2->len)
323 return 0;
325 if ((m1->idx_notify_num + m1->val_notify_num) * sizeof(*req1) !=
326 m1->len)
327 return 1;
329 req1 = (struct cn_notify_req *)m1->data;
330 req2 = (struct cn_notify_req *)m2->data;
332 for (i = 0; i < m1->idx_notify_num; ++i) {
333 if (req1->first != req2->first || req1->range != req2->range)
334 return 0;
335 req1++;
336 req2++;
339 for (i = 0; i < m1->val_notify_num; ++i) {
340 if (req1->first != req2->first || req1->range != req2->range)
341 return 0;
342 req1++;
343 req2++;
346 return 1;
350 * Main connector device's callback.
352 * Used for notification of a request's processing.
354 static void cn_callback(void *data)
356 struct cn_msg *msg = data;
357 struct cn_ctl_msg *ctl;
358 struct cn_ctl_entry *ent;
359 u32 size;
361 if (msg->len < sizeof(*ctl))
362 return;
364 ctl = (struct cn_ctl_msg *)msg->data;
366 size = (sizeof(*ctl) + ((ctl->idx_notify_num +
367 ctl->val_notify_num) *
368 sizeof(struct cn_notify_req)));
370 if (msg->len != size)
371 return;
373 if (ctl->len + sizeof(*ctl) != msg->len)
374 return;
377 * Remove notification.
379 if (ctl->group == 0) {
380 struct cn_ctl_entry *n;
382 mutex_lock(&notify_lock);
383 list_for_each_entry_safe(ent, n, &notify_list, notify_entry) {
384 if (cn_ctl_msg_equals(ent->msg, ctl)) {
385 list_del(&ent->notify_entry);
386 kfree(ent);
389 mutex_unlock(&notify_lock);
391 return;
394 size += sizeof(*ent);
396 ent = kzalloc(size, GFP_KERNEL);
397 if (!ent)
398 return;
400 ent->msg = (struct cn_ctl_msg *)(ent + 1);
402 memcpy(ent->msg, ctl, size - sizeof(*ent));
404 mutex_lock(&notify_lock);
405 list_add(&ent->notify_entry, &notify_list);
406 mutex_unlock(&notify_lock);
409 static int cn_proc_show(struct seq_file *m, void *v)
411 struct cn_queue_dev *dev = cdev.cbdev;
412 struct cn_callback_entry *cbq;
414 seq_printf(m, "Name ID\n");
416 spin_lock_bh(&dev->queue_lock);
418 list_for_each_entry(cbq, &dev->queue_list, callback_entry) {
419 seq_printf(m, "%-15s %u:%u\n",
420 cbq->id.name,
421 cbq->id.id.idx,
422 cbq->id.id.val);
425 spin_unlock_bh(&dev->queue_lock);
427 return 0;
430 static int cn_proc_open(struct inode *inode, struct file *file)
432 return single_open(file, cn_proc_show, NULL);
435 static const struct file_operations cn_file_ops = {
436 .owner = THIS_MODULE,
437 .open = cn_proc_open,
438 .read = seq_read,
439 .llseek = seq_lseek,
440 .release = single_release
443 static int __devinit cn_init(void)
445 struct cn_dev *dev = &cdev;
446 int err;
448 dev->input = cn_rx_skb;
449 dev->id.idx = cn_idx;
450 dev->id.val = cn_val;
452 dev->nls = netlink_kernel_create(&init_net, NETLINK_CONNECTOR,
453 CN_NETLINK_USERS + 0xf,
454 dev->input, NULL, THIS_MODULE);
455 if (!dev->nls)
456 return -EIO;
458 dev->cbdev = cn_queue_alloc_dev("cqueue", dev->nls);
459 if (!dev->cbdev) {
460 netlink_kernel_release(dev->nls);
461 return -EINVAL;
464 cn_already_initialized = 1;
466 err = cn_add_callback(&dev->id, "connector", &cn_callback);
467 if (err) {
468 cn_already_initialized = 0;
469 cn_queue_free_dev(dev->cbdev);
470 netlink_kernel_release(dev->nls);
471 return -EINVAL;
474 proc_net_fops_create(&init_net, "connector", S_IRUGO, &cn_file_ops);
476 return 0;
479 static void __devexit cn_fini(void)
481 struct cn_dev *dev = &cdev;
483 cn_already_initialized = 0;
485 proc_net_remove(&init_net, "connector");
487 cn_del_callback(&dev->id);
488 cn_queue_free_dev(dev->cbdev);
489 netlink_kernel_release(dev->nls);
492 subsys_initcall(cn_init);
493 module_exit(cn_fini);