.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "USB_ALLOC_URB" "9" "09 October 2005" "" ""

.SH NAME
usb_alloc_urb \- creates a new urb for a USB driver to use
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
struct urb * usb_alloc_urb  (int \fIiso_packets\fB, unsigned \fImem_flags\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIiso_packets\fB\fR
number of iso packets for this urb
.TP
\fB\fImem_flags\fB\fR
the type of memory to allocate, see \fBkmalloc\fR for a list of
valid options for this.
.SH "DESCRIPTION"
.PP
Creates an urb for the USB driver to use, initializes a few internal
structures, incrementes the usage counter, and returns a pointer to it.
.PP
If no memory is available, NULL is returned.
.PP
If the driver want to use this urb for interrupt, control, or bulk
endpoints, pass '0' as the number of iso packets.
.PP
The driver must call \fBusb_free_urb\fR when it is finished with the urb.