mirror of
https://git.FreeBSD.org/src.git
synced 2024-12-18 10:35:55 +00:00
b78e84d132
simultaneously detaching kernel drivers on the same USB device we can get stuck in the "usb_wait_pending_ref_locked()" function because the conditions needed for allowing detach are not met. The "destroy_dev()" function waits for all system calls involving the given character device to return. Character device system calls may lock the USB enumeration lock, which is also held when "destroy_dev()" is called. This can sometimes lead to a deadlock not noticed by WITNESS. The current solution is to ensure the calling thread is the only one holding the USB enumeration lock and prevent other threads from getting refs while a USB device detach is ongoing. This turned out not to be sufficient. To solve this deadlock we could use "destroy_dev_sched()" to schedule the device destruction in the background, but then we don't know when it is safe to free() the private data of the character device. Instead a callback function is executed by the USB explore process to kill off any leftover USB character devices synchronously after the USB device explore code is finished and the USB enumeration lock is no longer locked. This makes porting easier and also ensures us that character devices must eventually go away after a USB device detach. While at it ensure that "flag_iserror" is only written when "priv_mtx" is locked, which is protecting it. MFC after: 5 days
128 lines
4.1 KiB
C
128 lines
4.1 KiB
C
/* $FreeBSD$ */
|
|
/*-
|
|
* Copyright (c) 2008 Hans Petter Selasky. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _USB_BUS_H_
|
|
#define _USB_BUS_H_
|
|
|
|
struct usb_fs_privdata;
|
|
|
|
/*
|
|
* The following structure defines the USB explore message sent to the USB
|
|
* explore process.
|
|
*/
|
|
|
|
struct usb_bus_msg {
|
|
struct usb_proc_msg hdr;
|
|
struct usb_bus *bus;
|
|
};
|
|
|
|
/*
|
|
* The following structure defines the USB statistics structure.
|
|
*/
|
|
struct usb_bus_stat {
|
|
uint32_t uds_requests[4];
|
|
};
|
|
|
|
/*
|
|
* The following structure defines an USB BUS. There is one USB BUS
|
|
* for every Host or Device controller.
|
|
*/
|
|
struct usb_bus {
|
|
struct usb_bus_stat stats_err;
|
|
struct usb_bus_stat stats_ok;
|
|
#if USB_HAVE_ROOT_MOUNT_HOLD
|
|
struct root_hold_token *bus_roothold;
|
|
#endif
|
|
|
|
#if USB_HAVE_PER_BUS_PROCESS
|
|
#define USB_BUS_GIANT_PROC(bus) (&(bus)->giant_callback_proc)
|
|
#define USB_BUS_NON_GIANT_PROC(bus) (&(bus)->non_giant_callback_proc)
|
|
#define USB_BUS_EXPLORE_PROC(bus) (&(bus)->explore_proc)
|
|
#define USB_BUS_CONTROL_XFER_PROC(bus) (&(bus)->control_xfer_proc)
|
|
|
|
/*
|
|
* There are two callback processes. One for Giant locked
|
|
* callbacks. One for non-Giant locked callbacks. This should
|
|
* avoid congestion and reduce response time in most cases.
|
|
*/
|
|
struct usb_process giant_callback_proc;
|
|
struct usb_process non_giant_callback_proc;
|
|
|
|
/* Explore process */
|
|
struct usb_process explore_proc;
|
|
|
|
/* Control request process */
|
|
struct usb_process control_xfer_proc;
|
|
#endif
|
|
|
|
struct usb_bus_msg explore_msg[2];
|
|
struct usb_bus_msg detach_msg[2];
|
|
struct usb_bus_msg attach_msg[2];
|
|
struct usb_bus_msg suspend_msg[2];
|
|
struct usb_bus_msg resume_msg[2];
|
|
struct usb_bus_msg reset_msg[2];
|
|
struct usb_bus_msg shutdown_msg[2];
|
|
#if USB_HAVE_UGEN
|
|
struct usb_bus_msg cleanup_msg[2];
|
|
LIST_HEAD(,usb_fs_privdata) pd_cleanup_list;
|
|
#endif
|
|
/*
|
|
* This mutex protects the USB hardware:
|
|
*/
|
|
struct mtx bus_mtx;
|
|
struct mtx bus_spin_lock;
|
|
struct usb_xfer_queue intr_q;
|
|
struct usb_callout power_wdog; /* power management */
|
|
|
|
device_t parent;
|
|
device_t bdev; /* filled by HC driver */
|
|
|
|
#if USB_HAVE_BUSDMA
|
|
struct usb_dma_parent_tag dma_parent_tag[1];
|
|
struct usb_dma_tag dma_tags[USB_BUS_DMA_TAG_MAX];
|
|
#endif
|
|
const struct usb_bus_methods *methods; /* filled by HC driver */
|
|
struct usb_device **devices;
|
|
|
|
struct ifnet *ifp; /* only for USB Packet Filter */
|
|
|
|
usb_power_mask_t hw_power_state; /* see USB_HW_POWER_XXX */
|
|
usb_size_t uframe_usage[USB_HS_MICRO_FRAMES_MAX];
|
|
|
|
uint16_t isoc_time_last; /* in milliseconds */
|
|
|
|
uint8_t alloc_failed; /* Set if memory allocation failed. */
|
|
uint8_t driver_added_refcount; /* Current driver generation count */
|
|
enum usb_revision usbrev; /* USB revision. See "USB_REV_XXX". */
|
|
|
|
uint8_t devices_max; /* maximum number of USB devices */
|
|
uint8_t do_probe; /* set if USB should be re-probed */
|
|
uint8_t no_explore; /* don't explore USB ports */
|
|
uint8_t dma_bits; /* number of DMA address lines */
|
|
};
|
|
|
|
#endif /* _USB_BUS_H_ */
|