.\" 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_EP_ALLOC_REQUEST" "9" "17 July 2003" "" ""

.SH NAME
usb_ep_alloc_request \- allocate a request object to use with this endpoint
.SH SYNOPSIS
.sp
\fB
.sp
struct usb_request * usb_ep_alloc_request  (struct usb_ep * \fIep\fB, int \fIgfp_flags\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIep\fB\fR
the endpoint to be used with with the request
.TP
\fB\fIgfp_flags\fB\fR
GFP_* flags to use
.SH "DESCRIPTION"
.PP
Request objects must be allocated with this call, since they normally
need controller-specific setup and may even need endpoint-specific
resources such as allocation of DMA descriptors.
Requests may be submitted with \fBusb_ep_queue\fR, and receive a single
completion callback.  Free requests with \fBusb_ep_free_request\fR, when
they are no longer needed.
.PP
Returns the request, or null if one could not be allocated.
.SH "ABOUT THIS DOCUMENT"
.PP
Permission is granted to copy, distribute, and/or modify
this document under the terms of the GNU Free Documentation
License, version 1.2, or any later version published by the
Free Software Foundation; with the Invariant Sections being
the "GNU Free Documentation License",
no Front-Cover Texts,
and
no Back-Cover Texts.
.PP
This documentation is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Free Documentation License for more details.
.PP
Note that certain sections of this document are merged
into Linux kernel source code.
That content is the bulk of 
[XRef to CORE]> and
[XRef to UTILS]>,
where the "GNU Free Documentation License" is identified
as an alternate licence for its documentation.
.PP
If you have comments on the formatting of this manpage, then please contact
Michael Still (mikal@stillhq.com).
.PP
This documentation was generated with kernel version 2.5.73.