usb_mon.h 2.47 KB
Newer Older
Linus Torvalds's avatar
Linus Torvalds committed
1 2
/*
 * The USB Monitor, inspired by Dave Harding's USBMon.
3 4
 *
 * Copyright (C) 2005 Pete Zaitcev (zaitcev@redhat.com)
Linus Torvalds's avatar
Linus Torvalds committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
 */

#ifndef __USB_MON_H
#define __USB_MON_H

#include <linux/list.h>
#include <linux/slab.h>
#include <linux/kref.h>
/* #include <linux/usb.h> */	/* We use struct pointers only in this header */

#define TAG "usbmon"

struct mon_bus {
	struct list_head bus_link;
	spinlock_t lock;
Pete Zaitcev's avatar
Pete Zaitcev committed
20 21 22
	struct usb_bus *u_bus;

	int text_inited;
23
	int bin_inited;
Linus Torvalds's avatar
Linus Torvalds committed
24 25
	struct dentry *dent_s;		/* Debugging file */
	struct dentry *dent_t;		/* Text interface file */
Pete Zaitcev's avatar
Pete Zaitcev committed
26
	struct dentry *dent_u;		/* Second text interface file */
27
	struct device *classdev;	/* Device in usbmon class */
Linus Torvalds's avatar
Linus Torvalds committed
28 29 30 31 32 33 34

	/* Ref */
	int nreaders;			/* Under mon_lock AND mbus->lock */
	struct list_head r_list;	/* Chain of readers (usually one) */
	struct kref ref;		/* Under mon_lock */

	/* Stats */
35
	unsigned int cnt_events;
Linus Torvalds's avatar
Linus Torvalds committed
36 37 38 39 40 41 42 43 44 45 46 47
	unsigned int cnt_text_lost;
};

/*
 * An instance of a process which opened a file (but can fork later)
 */
struct mon_reader {
	struct list_head r_link;
	struct mon_bus *m_bus;
	void *r_data;		/* Use container_of instead? */

	void (*rnf_submit)(void *data, struct urb *urb);
48
	void (*rnf_error)(void *data, struct urb *urb, int error);
Linus Torvalds's avatar
Linus Torvalds committed
49 50 51 52 53 54
	void (*rnf_complete)(void *data, struct urb *urb);
};

void mon_reader_add(struct mon_bus *mbus, struct mon_reader *r);
void mon_reader_del(struct mon_bus *mbus, struct mon_reader *r);

Pete Zaitcev's avatar
Pete Zaitcev committed
55 56
struct mon_bus *mon_bus_lookup(unsigned int num);

57
int /*bool*/ mon_text_add(struct mon_bus *mbus, const struct usb_bus *ubus);
Pete Zaitcev's avatar
Pete Zaitcev committed
58
void mon_text_del(struct mon_bus *mbus);
59 60
int /*bool*/ mon_bin_add(struct mon_bus *mbus, const struct usb_bus *ubus);
void mon_bin_del(struct mon_bus *mbus);
Pete Zaitcev's avatar
Pete Zaitcev committed
61 62

int __init mon_text_init(void);
63
void mon_text_exit(void);
Pete Zaitcev's avatar
Pete Zaitcev committed
64
int __init mon_bin_init(void);
65
void mon_bin_exit(void);
Pete Zaitcev's avatar
Pete Zaitcev committed
66

67
/*
Pete Zaitcev's avatar
Pete Zaitcev committed
68 69 70 71 72
 * DMA interface.
 *
 * XXX The vectored side needs a serious re-thinking. Abstracting vectors,
 * like in Paolo's original patch, produces a double pkmap. We need an idea.
*/
73 74
extern char mon_dmapeek(unsigned char *dst, dma_addr_t dma_addr, int len);

Pete Zaitcev's avatar
Pete Zaitcev committed
75 76 77 78 79 80 81 82
struct mon_reader_bin;
extern void mon_dmapeek_vec(const struct mon_reader_bin *rp,
    unsigned int offset, dma_addr_t dma_addr, unsigned int len);
extern unsigned int mon_copy_to_buff(const struct mon_reader_bin *rp,
    unsigned int offset, const unsigned char *from, unsigned int len);

/*
 */
83
extern struct mutex mon_lock;
Linus Torvalds's avatar
Linus Torvalds committed
84

85
extern const struct file_operations mon_fops_stat;
Linus Torvalds's avatar
Linus Torvalds committed
86

Pete Zaitcev's avatar
Pete Zaitcev committed
87 88
extern struct mon_bus mon_bus0;		/* Only for redundant checks */

Linus Torvalds's avatar
Linus Torvalds committed
89
#endif /* __USB_MON_H */