1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * The USB Monitor, inspired by Dave Harding's USBMon. 4 * 5 * Copyright (C) 2005 Pete Zaitcev (zaitcev@redhat.com) 6 */ 7 8 #ifndef __USB_MON_H 9 #define __USB_MON_H 10 11 #include <linux/list.h> 12 #include <linux/slab.h> 13 #include <linux/kref.h> 14 /* #include <linux/usb.h> */ /* We use struct pointers only in this header */ 15 16 #define TAG "usbmon" 17 18 struct mon_bus { 19 struct list_head bus_link; 20 spinlock_t lock; 21 struct usb_bus *u_bus; 22 23 int text_inited; 24 int bin_inited; 25 struct dentry *dent_s; /* Debugging file */ 26 struct dentry *dent_t; /* Text interface file */ 27 struct dentry *dent_u; /* Second text interface file */ 28 struct device *classdev; /* Device in usbmon class */ 29 30 /* Ref */ 31 int nreaders; /* Under mon_lock AND mbus->lock */ 32 struct list_head r_list; /* Chain of readers (usually one) */ 33 struct kref ref; /* Under mon_lock */ 34 35 /* Stats */ 36 unsigned int cnt_events; 37 unsigned int cnt_text_lost; 38 }; 39 40 /* 41 * An instance of a process which opened a file (but can fork later) 42 */ 43 struct mon_reader { 44 struct list_head r_link; 45 struct mon_bus *m_bus; 46 void *r_data; /* Use container_of instead? */ 47 48 void (*rnf_submit)(void *data, struct urb *urb); 49 void (*rnf_error)(void *data, struct urb *urb, int error); 50 void (*rnf_complete)(void *data, struct urb *urb, int status); 51 }; 52 53 void mon_reader_add(struct mon_bus *mbus, struct mon_reader *r); 54 void mon_reader_del(struct mon_bus *mbus, struct mon_reader *r); 55 56 struct mon_bus *mon_bus_lookup(unsigned int num); 57 58 int /*bool*/ mon_text_add(struct mon_bus *mbus, const struct usb_bus *ubus); 59 void mon_text_del(struct mon_bus *mbus); 60 int /*bool*/ mon_bin_add(struct mon_bus *mbus, const struct usb_bus *ubus); 61 void mon_bin_del(struct mon_bus *mbus); 62 63 int __init mon_text_init(void); 64 void mon_text_exit(void); 65 int __init mon_bin_init(void); 66 void mon_bin_exit(void); 67 68 /* 69 */ 70 extern struct mutex mon_lock; 71 72 extern const struct file_operations mon_fops_stat; 73 74 extern struct mon_bus mon_bus0; /* Only for redundant checks */ 75 76 #endif /* __USB_MON_H */ 77