LXR linux/drivers/usb/mon/usb

   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
  18struct 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 */
  43struct 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
  53void mon_reader_add(struct mon_bus *mbus, struct mon_reader *r);
  54void mon_reader_del(struct mon_bus *mbus, struct mon_reader *r);
  55
  56struct mon_bus *mon_bus_lookup(unsigned int num);
  57
  58int /*bool*/ mon_text_add(struct mon_bus *mbus, const struct usb_bus *ubus);
  59void mon_text_del(struct mon_bus *mbus);
  60int /*bool*/ mon_bin_add(struct mon_bus *mbus, const struct usb_bus *ubus);
  61void mon_bin_del(struct mon_bus *mbus);
  62
  63int __init mon_text_init(void);
  64void mon_text_exit(void);
  65int __init mon_bin_init(void);
  66void mon_bin_exit(void);
  67
  68/*
  69 */
  70extern struct mutex mon_lock;
  71
  72extern const struct file_operations mon_fops_stat;
  73
  74extern struct mon_bus mon_bus0;         /* Only for redundant checks */
  75
  76#endif /* __USB_MON_H */
  77