2005-01-06 01:43:34 +00:00
|
|
|
/*-
|
Attempt to fix a problem with receiving packets on USB ethernet interfaces.
Packets are received inside USB bulk transfer callbacks, which run at
splusb() (actually splbio()). The packet input queues are meant to be
manipulated at splimp(). However the locking apparently breaks down under
certain circumstances and the input queues can get trampled.
There's a similar problem with if_ppp, which is driven by hardware/tty
interrupts from the serial driver, but which must also manipulate the
packet input queues at splimp(). The fix there is to use a netisr, and
that's the fix I used here. (I can hear you groaning back there. Hush up.)
The usb_ethersubr module maintains a single queue of its own. When a
packet is received in the USB callback routine, it's placed on this
queue with usb_ether_input(). This routine also schedules a soft net
interrupt with schednetisr(). The ISR routine then runs later, at
splnet, outside of the USB callback/interrupt context, and passes the
packet to ether_input(), hopefully in a safe manner.
The reason this is implemented as a separate module is that there are
a limited number of NETISRs that we can use, and snarfing one up for
each driver that needs it is wasteful (there will be three once I get
the CATC driver done). It also reduces code duplication to a certain
small extent. Unfortunately, it also needs to be linked in with the
usb.ko module in order for the USB ethernet drivers to share it.
Also removed some uneeded includes from if_aue.c and if_kue.c
Fix suggested by: peter
Not rejected as a hairbrained idea by: n_hibma
2000-01-10 23:12:54 +00:00
|
|
|
* Copyright (c) 1997, 1998, 1999, 2000
|
|
|
|
|
* Bill Paul <wpaul@ee.columbia.edu>. 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.
|
|
|
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
|
|
|
* must display the following acknowledgement:
|
|
|
|
|
* This product includes software developed by Bill Paul.
|
|
|
|
|
* 4. Neither the name of the author nor the names of any co-contributors
|
|
|
|
|
* may be used to endorse or promote products derived from this software
|
|
|
|
|
* without specific prior written permission.
|
|
|
|
|
*
|
|
|
|
|
* THIS SOFTWARE IS PROVIDED BY Bill Paul 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 Bill Paul OR THE VOICES IN HIS HEAD
|
|
|
|
|
* 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.
|
|
|
|
|
*
|
|
|
|
|
* $FreeBSD$
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
|
#ifndef _USB_ETHERSUBR_H_
|
|
|
|
|
#define _USB_ETHERSUBR_H_
|
|
|
|
|
|
2005-03-25 12:42:30 +00:00
|
|
|
#include <sys/bus.h>
|
|
|
|
|
#include <sys/module.h>
|
|
|
|
|
|
|
|
|
|
#include <dev/usb/usbdi.h>
|
|
|
|
|
|
|
|
|
|
#define UE_TX_LIST_CNT 1
|
|
|
|
|
#define UE_RX_LIST_CNT 1
|
|
|
|
|
#define UE_BUFSZ 1536
|
|
|
|
|
|
2000-01-13 20:13:58 +00:00
|
|
|
struct usb_qdat {
|
|
|
|
|
struct ifnet *ifp;
|
2002-03-20 02:08:01 +00:00
|
|
|
void (*if_rxstart) (struct ifnet *);
|
2000-01-13 20:13:58 +00:00
|
|
|
};
|
|
|
|
|
|
2005-03-25 12:42:30 +00:00
|
|
|
struct ue_chain {
|
|
|
|
|
void *ue_sc;
|
|
|
|
|
usbd_xfer_handle ue_xfer;
|
|
|
|
|
char *ue_buf;
|
|
|
|
|
struct mbuf *ue_mbuf;
|
|
|
|
|
int ue_idx;
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
struct ue_cdata {
|
|
|
|
|
struct ue_chain ue_tx_chain[UE_TX_LIST_CNT];
|
|
|
|
|
struct ue_chain ue_rx_chain[UE_RX_LIST_CNT];
|
|
|
|
|
void *ue_ibuf;
|
|
|
|
|
int ue_tx_prod;
|
|
|
|
|
int ue_tx_cons;
|
|
|
|
|
int ue_tx_cnt;
|
|
|
|
|
int ue_rx_prod;
|
|
|
|
|
};
|
|
|
|
|
|
2002-03-20 02:08:01 +00:00
|
|
|
void usb_register_netisr (void);
|
|
|
|
|
void usb_ether_input (struct mbuf *);
|
|
|
|
|
void usb_tx_done (struct mbuf *);
|
2005-03-25 12:42:30 +00:00
|
|
|
struct mbuf *usb_ether_newbuf (void);
|
|
|
|
|
int usb_ether_rx_list_init (void *, struct ue_cdata *,
|
|
|
|
|
usbd_device_handle);
|
|
|
|
|
int usb_ether_tx_list_init (void *, struct ue_cdata *,
|
|
|
|
|
usbd_device_handle);
|
|
|
|
|
void usb_ether_rx_list_free (struct ue_cdata *);
|
|
|
|
|
void usb_ether_tx_list_free (struct ue_cdata *);
|
Attempt to fix a problem with receiving packets on USB ethernet interfaces.
Packets are received inside USB bulk transfer callbacks, which run at
splusb() (actually splbio()). The packet input queues are meant to be
manipulated at splimp(). However the locking apparently breaks down under
certain circumstances and the input queues can get trampled.
There's a similar problem with if_ppp, which is driven by hardware/tty
interrupts from the serial driver, but which must also manipulate the
packet input queues at splimp(). The fix there is to use a netisr, and
that's the fix I used here. (I can hear you groaning back there. Hush up.)
The usb_ethersubr module maintains a single queue of its own. When a
packet is received in the USB callback routine, it's placed on this
queue with usb_ether_input(). This routine also schedules a soft net
interrupt with schednetisr(). The ISR routine then runs later, at
splnet, outside of the USB callback/interrupt context, and passes the
packet to ether_input(), hopefully in a safe manner.
The reason this is implemented as a separate module is that there are
a limited number of NETISRs that we can use, and snarfing one up for
each driver that needs it is wasteful (there will be three once I get
the CATC driver done). It also reduces code duplication to a certain
small extent. Unfortunately, it also needs to be linked in with the
usb.ko module in order for the USB ethernet drivers to share it.
Also removed some uneeded includes from if_aue.c and if_kue.c
Fix suggested by: peter
Not rejected as a hairbrained idea by: n_hibma
2000-01-10 23:12:54 +00:00
|
|
|
|
2005-03-25 13:22:58 +00:00
|
|
|
#endif /* _USB_ETHERSUBR_H_ */
|
