Sg3 utilities 1.25 [LSARC/2008/683 Self Review]
Mark A. Carlson
Mark.Carlson at sun.com
Tue Nov 4 05:32:53 PST 2008
I am sponsoring this case for Xiao Li. I have marked it closed approved automatic based on the checklist in the case directory.
-- mark
> Template Version: @(#)sac_nextcase %I% %G% SMI
> This information is Copyright 2008 Sun Microsystems
> 1. Introduction
> 1.1. Project/Component Working Name:
> Sg3 utilities 1.25
> 1.2. Name of Document Author/Supplier:
> Author: Xiao Li
> 1.3 Date of This Document:
> 04 November, 2008
>
> 2. Project Summary
> 2.1. Project Description
>
> This project introduces the package of Sg3 utilites 1.25 into the
> SFW consolidation.
>
> 4. Technical Description
>
> The sg3_utils package contains utilities that send SCSI commands to
> devices. As well as devices on transports traditionally associated
> with SCSI (e.g. Fibre Channel (FCP), Serial Attached SCSI (SAS) and
> the SCSI Parallel Interface(SPI)) and many other devices use SCSI
> command sets. ATAPI cd/dvd drives and SATA disks that connect via a
> translation layer or a bridge device are examples of devices that
> use SCSI command sets.
> There are about 32 command line utilities inside this package.
> Command name Notes
> ============ ===================================================
> sg_get_config fetch features and profiles of a cd/dvd drive and/or
> its current media
> sg_ident default is to report (fetch) the device identifier.
> With the '--set' option a new identifier is sent to
> the device.
> sg_inq fetch standard response, VPD pages or version
> descriptors. Also can perform IDENTIFY (PACKET)
> DEVICE ATA command. VPD page decoding also performed
> by sg_vpd and sdparm.
> sg_logs fetch log sense pages, decode standard and some vendor
> pages
> sg_luns fetch luns reported by a device (lun 0 or "well known
> lu")
> sg_modes fetch mode pages (output mainly in hex, to decode
> output use sdparm)
> sg_opcodes fetch supported SCSI commands or supported task
> management functions
> sg_persist control persistent reservations and report reservation
> status
> sg_prevent control media removal, mainly for those SCSI devices
> which have removable media (e.g. CD/DVD and tape drives)
> sg_raw send user supplied cdb
> sg_rdac display or modify RDAC redundant controller mode page
> sg_read_buffer read descriptors or data
> sg_read_long read data from given lba which includes the block and
> ECC data.
> sg_readcap fetch the number of blocks and the individual block
> size for disks and CD/DVD media
> sg_reassign reassign a lba from one sector on a disk (typically
> damaged) to a new (spare) sector. User data copied if
> it is recoverable.
> sg_requests fetch sense data from the given device. Modern uses
> include getting a progress indication (e.g. during a
> format) or finding the power condition state.
> sg_rmsn Relatively new command added to SPC-3. Format of
> response is vendor specific so this utility outputs
> it in hex (default) or binary.
> sg_rtpg Specialized for multi-ported SCSI devices where one
> port (or a group of them) is preferred for IO over
> another (or others).
> sg_safte fetch information from a SAF-TE processor.
> sg_sat_identify Send ATA IDENTIFY DEVICE or IDENTIFY PACKET DEVICE
> commands via the SAT ATA PASS-THROUGH (16 or 12) SCSI
> command.
> sg_sat_set_features Sends ATA SET FEATURES command via SAT.
> sg_senddiag Issues either a default self test or a short/extended
> foreground/background self test. With no arguments it
> uses RECEIVE DIAGNOSTIC RESULTS to list all supported
> diagnostic pages.
> sg_ses Fetches status diagnostic pages from, and sends some
> control pages to, a SCSI Enclosure Services (SES)
> device.
> sg_start Controls the power condition state of a SCSI device.
> Primary use is to spin up and down SCSI disks. Can
> also load and eject removable media.
> sg_stpg Specialized for multi-ported SCSI devices where one
> port (or a group of them) is preferred for IO over
> another (or others).
> sg_sync Causes disk caches to be flushed to media.
> sg_turs Issue one or more Test Unit Ready commands. Can be
> used to time SCSI command overhead.
> sg_verify reads indicated blocks on a SCSI disks, stops on the
> first error found. Does not yield any data. Useful
> for media scans.
> sg_vpd Decodes standard and some vendor Vital Product Data
> (VPD) pages.
> sg_wr_mode writes mode pages supplied in ASCII hex (e.g. from
> "sg_modes -r") to the SCSI device. See sdparm for
> another method of setting mode page parameters.
> sg_write_buffer write data; can be used to download firmware.
> sg_write_long writes to a lba, data which includes the block and
> ECC data. Suitable data typically fetched by prior
> sg_read_long utility.
> 5. Interfaces
>
> Exported interface Classification Interface type
> =============================== ============== ==============
> SUNWsg3utils Uncommitted Package name
> /usr/bin/sg_get_config Uncommitted Command
> /usr/bin/sg_ident Uncommitted Command
> /usr/bin/sg_inq Uncommitted Command
> /usr/bin/sg_logs Uncommitted Command
> /usr/bin/sg_luns Uncommitted Command
> /usr/bin/sg_modes Uncommitted Command
> /usr/bin/sg_opcodes Uncommitted Command
> /usr/bin/sg_persist Uncommitted Command
> /usr/bin/sg_prevent Uncommitted Command
> /usr/bin/sg_raw Uncommitted Command
> /usr/bin/sg_rdac Uncommitted Command
> /usr/bin/sg_read_buffer Uncommitted Command
> /usr/bin/sg_read_long Uncommitted Command
> /usr/bin/sg_readcap Uncommitted Command
> /usr/bin/sg_reassign Uncommitted Command
> /usr/bin/sg_requests Uncommitted Command
> /usr/bin/sg_rmsn Uncommitted Command
> /usr/bin/sg_rtpg Uncommitted Command
> /usr/bin/sg_safte Uncommitted Command
> /usr/bin/sg_sat_identify Uncommitted Command
> /usr/bin/sg_sat_set_features Uncommitted Command
> /usr/bin/sg_senddiag Uncommitted Command
> /usr/bin/sg_ses Uncommitted Command
> /usr/bin/sg_start Uncommitted Command
> /usr/bin/sg_stpg Uncommitted Command
> /usr/bin/sg_sync Uncommitted Command
> /usr/bin/sg_turs Uncommitted Command
> /usr/bin/sg_verify Uncommitted Command
> /usr/bin/sg_vpd Uncommitted Command
> /usr/bin/sg_wr_mode Uncommitted Command
> /usr/bin/sg_write_buffer Uncommitted Command
> /usr/bin/sg_write_long Uncommitted Command
> /usr/lib/libsgutils.so Private Symbolic link
> /usr/lib/libsgutils.so.1 Private Symbolic link
> /usr/lib/libsgutils.so.1.0.0 Private Shared library
> /usr/lib/libsgutils.a Private Static library
> /usr/lib/libsgutils.la Private Libtool library
> file
> /usr/include/scsi/sg_lib.h Uncommitted Header file
> /usr/include/scsi/sg_cmds_extra.h Uncommitted Header file
> /usr/include/scsi/sg_cmds_basic.h Uncommitted Header file
> /usr/include/scsi/sg_cmds.h Uncommitted Header file
> /usr/include/scsi/sg_pt.h Uncommitted Header file
> /usr/share/man/man8/sg_read_long.8 Uncommitted Manpage
> /usr/share/man/man8/sg_safte.8 Uncommitted Manpage
> /usr/share/man/man8/sg_senddiag.8 Uncommitted Manpage
> /usr/share/man/man8/sg_wr_mode.8 Uncommitted Manpage
> /usr/share/man/man8/sg_stpg.8 Uncommitted Manpage
> /usr/share/man/man8/sg_persist.8 Uncommitted Manpage
> /usr/share/man/man8/sg_ses.8 Uncommitted Manpage
> /usr/share/man/man8/sg_opcodes.8 Uncommitted Manpage
> /usr/share/man/man8/sg_get_config.8 Uncommitted Manpage
> /usr/share/man/man8/sg_read_buffer.8 Uncommitted Manpage
> /usr/share/man/man8/sg_luns.8 Uncommitted Manpage
> /usr/share/man/man8/sg_requests.8 Uncommitted Manpage
> /usr/share/man/man8/sg_prevent.8 Uncommitted Manpage
> /usr/share/man/man8/sg_rdac.8 Uncommitted Manpage
> /usr/share/man/man8/sg_rtpg.8 Uncommitted Manpage
> /usr/share/man/man8/sg_sat_identify.8 Uncommitted Manpage
> /usr/share/man/man8/sg_start.8 Uncommitted Manpage
> /usr/share/man/man8/sg_verify.8 Uncommitted Manpage
> /usr/share/man/man8/sg_modes.8 Uncommitted Manpage
> /usr/share/man/man8/sg_readcap.8 Uncommitted Manpage
> /usr/share/man/man8/sg_sat_set_features.8 Uncommitted Manpage
> /usr/share/man/man8/sg_rmsn.8 Uncommitted Manpage
> /usr/share/man/man8/sg3_utils.8 Uncommitted Manpage
> /usr/share/man/man8/sg_ident.8 Uncommitted Manpage
> /usr/share/man/man8/sg_vpd.8 Uncommitted Manpage
> /usr/share/man/man8/sg_inq.8 Uncommitted Manpage
> /usr/share/man/man8/sg_raw.8 Uncommitted Manpage
> /usr/share/man/man8/sg_turs.8 Uncommitted Manpage
> /usr/share/man/man8/sg_sync.8 Uncommitted Manpage
> /usr/share/man/man8/sg_logs.8 Uncommitted Manpage
> /usr/share/man/man8/sg_format.8 Uncommitted Manpage
> /usr/share/man/man8/sg_reassign.8 Uncommitted Manpage
> /usr/share/man/man8/sg_write_long.8 Uncommitted Manpage
> /usr/share/man/man8/sg_write_buffer.8 Uncommitted Manpage
>
> The following additional installed files are not interface.
>
> Additional document
> -------------------
> N/A
>
> 6. Resources and Schedule
> 6.4. Steering Committee requested information
> 6.4.1. Consolidation C-team Name:
> SFW
> 6.5. ARC review type: Automatic
> 6.6. ARC Exposure: open
>
>
More information about the opensolaris-arc
mailing list