'\" t .\" Title: ata_format_dsm_trim_descr .\" Author: .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: April 2019 .\" Manual: libata SCSI translation/emulation .\" Source: Kernel Hackers Manual 4.9.168 .\" Language: English .\" .TH "ATA_FORMAT_DSM_TRIM_" "9" "April 2019" "Kernel Hackers Manual 4\&.9\&." "libata SCSI translation/emulat" .\" ----------------------------------------------------------------- .\" * 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_format_dsm_trim_descr \- SATL Write Same to DSM Trim .SH "SYNOPSIS" .HP \w'size_t\ ata_format_dsm_trim_descr('u .BI "size_t ata_format_dsm_trim_descr(struct\ scsi_cmnd\ *\ " "cmd" ", u32\ " "trmax" ", u64\ " "sector" ", u32\ " "count" ");" .SH "ARGUMENTS" .PP \fIcmd\fR .RS 4 SCSI command being translated .RE .PP \fItrmax\fR .RS 4 Maximum number of entries that will fit in sector_size bytes\&. .RE .PP \fIsector\fR .RS 4 Starting sector .RE .PP \fIcount\fR .RS 4 Total Range of request in logical sectors .RE .SH "DESCRIPTION" .PP Rewrite the WRITE SAME descriptor to be a DSM TRIM little\-endian formatted descriptor\&. .PP Upto 64 entries of the format: 63:48 Range Length 47:0 LBA .PP Range Length of 0 is ignored\&. LBA\*(Aqs should be sorted order and not overlap\&. .SH "NOTE" .PP this is the same format as ADD LBA(S) TO NV CACHE PINNED SET .SH "RETURN" .PP Number of bytes copied into sglist\&. .SH "AUTHOR" .PP \fBJeff Garzik\fR .RS 4 Author. .RE .SH "COPYRIGHT" .br