• R
    [PATCH] USB: update urb documentation · 719df469
    Roman Kagan 提交于
    On Wed, May 04, 2005 at 01:37:30PM -0700, David Brownell wrote:
    > On Wednesday 04 May 2005 12:19 pm, Roman Kagan wrote:
    > > struct urb {
    > > 	/* private, usb core and host controller only fields in the urb */
    > > 	...
    > > 	struct list_head urb_list;	/* list pointer to all active urbs */
    > > 	...
    > > };
    > >
    > > Is it safe to use it for driver's purposes when the driver owns the urb,
    > > that is, starting from the completion routine until the urb is submitted
    > > with usb_submit_urb()?
    >
    > Right now, it should be.
    
    Great!  FWIW I've briefly tested a modified version of usbatm using
    the list head in struct urb instead of creating a wrapper struct, and I
    haven't seen any failures yet.  So I tend to believe that your "should
    be" actually means "is" :)
    
    > > If it is, can it be guaranteed in future, e.g.
    > > by moving the list head into the public section of struct urb?
    >
    > In fact I'm not sure why it ever got called "private" to usbcore/hcds.
    > I thought the idea was that it should be like urb->status, reserved for
    > whoever controls the URB.
    
    OK then how about the following (essentially documentation) patch?
    Signed-off-by: NRoman Kagan <rkagan@mail.ru>
    Acked-by: NDavid Brownell <david-b@pacbell.net>
    Signed-off-by: NGreg Kroah-Hartman <gregkh@suse.de>
    719df469
usb.h 46.7 KB