'\" t .\" Title: struct usb_sg_request .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: Host-Side Data Types and Macros .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "STRUCT USB_SG_REQUES" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Host-Side Data Types and Macro" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" struct_usb_sg_request \- support for scatter/gather I/O .SH "SYNOPSIS" .sp .nf struct usb_sg_request { int status; size_t bytes; }; .fi .SH "MEMBERS" .PP status .RS 4 zero indicates success, else negative errno .RE .PP bytes .RS 4 counts bytes transferred\&. .RE .SH "DESCRIPTION" .PP These requests are initialized using \fBusb_sg_init\fR, and then are used as request handles passed to \fBusb_sg_wait\fR or \fBusb_sg_cancel\fR\&. Most members of the request object aren\*(Aqt for driver access\&. .PP The status and bytecount values are valid only after \fBusb_sg_wait\fR returns\&. If the status is zero, then the bytecount matches the total from the request\&. .PP After an error completion, drivers may need to clear a halt condition on the endpoint\&. .SH "COPYRIGHT" .br