'\" t .\" Title: scsi_get_vpd_page .\" Author: .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: January 2017 .\" Manual: SCSI mid layer .\" Source: Kernel Hackers Manual 4.8.15 .\" Language: English .\" .TH "SCSI_GET_VPD_PAGE" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "SCSI mid layer" .\" ----------------------------------------------------------------- .\" * 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" scsi_get_vpd_page \- Get Vital Product Data from a SCSI device .SH "SYNOPSIS" .HP \w'int\ scsi_get_vpd_page('u .BI "int scsi_get_vpd_page(struct\ scsi_device\ *\ " "sdev" ", u8\ " "page" ", unsigned\ char\ *\ " "buf" ", int\ " "buf_len" ");" .SH "ARGUMENTS" .PP \fIsdev\fR .RS 4 The device to ask .RE .PP \fIpage\fR .RS 4 Which Vital Product Data to return .RE .PP \fIbuf\fR .RS 4 where to store the VPD .RE .PP \fIbuf_len\fR .RS 4 number of bytes in the VPD buffer area .RE .SH "DESCRIPTION" .PP SCSI devices may optionally supply Vital Product Data\&. Each \*(Aqpage\*(Aq of VPD is defined in the appropriate SCSI document (eg SPC, SBC)\&. If the device supports this VPD page, this routine returns a pointer to a buffer containing the data from that page\&. The caller is responsible for calling \fBkfree\fR on this pointer when it is no longer needed\&. If we cannot retrieve the VPD page this routine returns \fBNULL\fR\&. .SH "AUTHORS" .PP \fBJames Bottomley\fR <\&James.Bottomley@hansenpartnership.com\&> .RS 4 Author. .RE .PP \fBRob Landley\fR <\&rob@landley.net\&> .RS 4 Author. .RE .SH "COPYRIGHT" .br