blob: a1e2b8e9d777d0aec70a16fb59ed8256579ca41a [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001/*
2 * The USB Monitor, inspired by Dave Harding's USBMon.
Pete Zaitcevda5ca002005-08-16 15:16:46 -07003 *
4 * Copyright (C) 2005 Pete Zaitcev (zaitcev@redhat.com)
Linus Torvalds1da177e2005-04-16 15:20:36 -07005 */
6
7#ifndef __USB_MON_H
8#define __USB_MON_H
9
10#include <linux/list.h>
11#include <linux/slab.h>
12#include <linux/kref.h>
13/* #include <linux/usb.h> */ /* We use struct pointers only in this header */
14
15#define TAG "usbmon"
16
17struct mon_bus {
18 struct list_head bus_link;
19 spinlock_t lock;
Pete Zaitcev6f23ee12006-12-30 22:43:10 -080020 struct usb_bus *u_bus;
21
22 int text_inited;
Linus Torvalds1da177e2005-04-16 15:20:36 -070023 struct dentry *dent_s; /* Debugging file */
24 struct dentry *dent_t; /* Text interface file */
Pete Zaitcevf1c9e302007-02-24 19:27:33 -080025 struct dentry *dent_u; /* Second text interface file */
Alan Stern4d6cd482006-08-30 11:35:21 -040026 int uses_dma;
Linus Torvalds1da177e2005-04-16 15:20:36 -070027
28 /* Ref */
29 int nreaders; /* Under mon_lock AND mbus->lock */
30 struct list_head r_list; /* Chain of readers (usually one) */
31 struct kref ref; /* Under mon_lock */
32
33 /* Stats */
Pete Zaitcev5b1c6742006-06-09 20:10:10 -070034 unsigned int cnt_events;
Linus Torvalds1da177e2005-04-16 15:20:36 -070035 unsigned int cnt_text_lost;
36};
37
38/*
39 * An instance of a process which opened a file (but can fork later)
40 */
41struct mon_reader {
42 struct list_head r_link;
43 struct mon_bus *m_bus;
44 void *r_data; /* Use container_of instead? */
45
46 void (*rnf_submit)(void *data, struct urb *urb);
Pete Zaitcev12e72fe2006-06-09 22:03:32 -070047 void (*rnf_error)(void *data, struct urb *urb, int error);
Linus Torvalds1da177e2005-04-16 15:20:36 -070048 void (*rnf_complete)(void *data, struct urb *urb);
49};
50
51void mon_reader_add(struct mon_bus *mbus, struct mon_reader *r);
52void mon_reader_del(struct mon_bus *mbus, struct mon_reader *r);
53
Pete Zaitcev6f23ee12006-12-30 22:43:10 -080054struct mon_bus *mon_bus_lookup(unsigned int num);
55
56int /*bool*/ mon_text_add(struct mon_bus *mbus, const struct usb_bus *ubus);
57void mon_text_del(struct mon_bus *mbus);
58// void mon_bin_add(struct mon_bus *);
59
60int __init mon_text_init(void);
Pete Zaitcev21641e32007-02-20 10:37:52 -080061void mon_text_exit(void);
Pete Zaitcev6f23ee12006-12-30 22:43:10 -080062int __init mon_bin_init(void);
Pete Zaitcev21641e32007-02-20 10:37:52 -080063void mon_bin_exit(void);
Pete Zaitcev6f23ee12006-12-30 22:43:10 -080064
Pete Zaitcev02568392005-08-15 16:53:57 -070065/*
Pete Zaitcev6f23ee12006-12-30 22:43:10 -080066 * DMA interface.
67 *
68 * XXX The vectored side needs a serious re-thinking. Abstracting vectors,
69 * like in Paolo's original patch, produces a double pkmap. We need an idea.
70*/
Pete Zaitcev02568392005-08-15 16:53:57 -070071extern char mon_dmapeek(unsigned char *dst, dma_addr_t dma_addr, int len);
72
Pete Zaitcev6f23ee12006-12-30 22:43:10 -080073struct mon_reader_bin;
74extern void mon_dmapeek_vec(const struct mon_reader_bin *rp,
75 unsigned int offset, dma_addr_t dma_addr, unsigned int len);
76extern unsigned int mon_copy_to_buff(const struct mon_reader_bin *rp,
77 unsigned int offset, const unsigned char *from, unsigned int len);
78
79/*
80 */
Arjan van de Ven4186ecf2006-01-11 15:55:29 +010081extern struct mutex mon_lock;
Linus Torvalds1da177e2005-04-16 15:20:36 -070082
Luiz Fernando N. Capitulino066202d2006-08-05 20:37:11 -030083extern const struct file_operations mon_fops_stat;
Linus Torvalds1da177e2005-04-16 15:20:36 -070084
85#endif /* __USB_MON_H */