'\" t .\" Title: ata_exec_internal_sg .\" Author: .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: libata Core Internals .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "ATA_EXEC_INTERNAL_SG" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "libata Core Internals" .\" ----------------------------------------------------------------- .\" * 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" ata_exec_internal_sg \- execute libata internal command .SH "SYNOPSIS" .HP \w'unsigned\ ata_exec_internal_sg('u .BI "unsigned ata_exec_internal_sg(struct\ ata_device\ *\ " "dev" ", struct\ ata_taskfile\ *\ " "tf" ", const\ u8\ *\ " "cdb" ", int\ " "dma_dir" ", struct\ scatterlist\ *\ " "sgl" ", unsigned\ int\ " "n_elem" ", unsigned\ long\ " "timeout" ");" .SH "ARGUMENTS" .PP \fIdev\fR .RS 4 Device to which the command is sent .RE .PP \fItf\fR .RS 4 Taskfile registers for the command and the result .RE .PP \fIcdb\fR .RS 4 CDB for packet command .RE .PP \fIdma_dir\fR .RS 4 Data transfer direction of the command .RE .PP \fIsgl\fR .RS 4 sg list for the data buffer of the command .RE .PP \fIn_elem\fR .RS 4 Number of sg entries .RE .PP \fItimeout\fR .RS 4 Timeout in msecs (0 for default) .RE .SH "DESCRIPTION" .PP Executes libata internal command with timeout\&. \fItf\fR contains command on entry and result on return\&. Timeout and error conditions are reported via return value\&. No recovery action is taken after a command times out\&. It\*(Aqs caller\*(Aqs duty to clean up after timeout\&. .PP LOCKING: None\&. Should be called with kernel context, might sleep\&. .SH "RETURN" .PP Zero on success, AC_ERR_* mask on failure .SH "AUTHOR" .PP \fBJeff Garzik\fR .RS 4 Author. .RE .SH "COPYRIGHT" .br