Beyond Linux® From Scratch - Version 2012-01-16

Chapter 11. System Utilities

sg3_utils-1.29

Introduction to sg3_utils

The sg3_utils package contains low level utilities for devices that use a SCSI command set. Apart from SCSI parallel interface (SPI) devices, the SCSI command set is used by ATAPI devices (CD/DVDs and tapes), USB mass storage devices, Fibre Channel disks, IEEE 1394 storage devices (that use the "SBP" protocol), SAS, iSCSI and FCoE devices (amongst others).

Package Information

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/sg3_utils

Installation of sg3_utils

Install sg3_utils by running the following commands: 

./configure --prefix=/usr &&
make

This package does not come with a test suite.

Now, as the root user: 

make install

Contents

Installed Programs: sg_dd, sg_emc_trespass, sg_format, sg_get_config, sg_get_lba_status, sg_ident, sginfo, sg_inq, sg_logs, sg_luns, sg_map, sg_map26, sgm_dd, sg_modes, sg_opcodes, sgp_dd, sg_persist, sg_prevent, sg_raw, sg_rbuf, sg_rdac, sg_read, sg_read_block_limits, sg_read_buffer, sg_readcap, sg_read_long, sg_reassign, sg_requests, sg_reset, sg_rmsn, sg_rtpg, sg_safte, sg_sat_identify, sg_sat_phy_event, sg_sat_set_features, sg_scan, sg_senddiag, sg_ses, sg_start, sg_stpg, sg_sync, sg_test_rwbuf, sg_turs, sg_unmap, sg_verify, sg_vpd, sg_write_buffer, sg_write_long, sg_write_same, and sg_wr_mode
Installed Library: libsgutils2.{so,a}
Installed Directories: None

Short Descriptions

sg_dd

copies data to and from files and devices. Specialised for devices that understand the SCSI command set.

sg_emc_trespass

changes ownership of a LUN from another Service-Processor to this one.

sg_format

format or resize a SCSI disk (perhaps change its block size).

sg_get_config

sends a SCSI GET CONFIGURATION command (MMC-4 +).

sg_get_lba_status

sends the SCSI GET LBA STATUS command.

sg_ident

sends a SCSI REPORT or SET IDENTIFYING INFORMATION command.

sginfo

access mode page information for a SCSI (or ATAPI) device.

sg_inq

sends a SCSI INQUIRY or ATA IDENTIFY (PACKET) DEVICE command and outputs the response.

sg_logs

access log pages with SCSI LOG SENSE command.

sg_luns

sends the SCSI REPORT LUNS command.

sg_map

displays mapping between linux sg and other SCSI devices.

sg_map26

maps a special file to a SCSI generic (sg) device (or vice versa).

sgm_dd

copies data to and from files and devices. Specialized for devices that understand the SCSI command set and does memory mapped transfers from sg devices.

sg_modes

reads mode pages with SCSI MODE SENSE command.

sg_opcodes

reports information on supported SCSI commands or task management functions.

sgp_dd

copies data to and from files and devices. Specialized for devices that understand the SCSI command set.

sg_persist

sends a SCSI PERSISTENT RESERVE (IN or OUT) command to manipulate registrations and reservations.

sg_prevent

sends a SCSI PREVENT ALLOW MEDIUM REMOVAL command.

sg_raw

sends an arbitrary SCSI command to a device.

sg_rbuf

reads data using SCSI READ BUFFER command.

sg_rdac

Display or Modify RDAC Redundant Controller Page.

sg_read

read blocks of data continually from same offset.

sg_read_block_limits

sends a SCSI READ BLOCK LIMITS command.

sg_read_buffer

sends a SCSI READ BUFFER command.

sg_readcap

sends a SCSI READ CAPACITY command.

sg_read_long

sends a SCSI READ LONG command.

sg_reassign

sends a SCSI REASSIGN BLOCKS command.

sg_requests

sends one or more SCSI REQUEST SENSE commands.

sg_reset

sends SCSI device, target, bus or host reset; or checks reset state.

sg_rmsn

sends a SCSI READ MEDIA SERIAL NUMBER command.

sg_rtpg

sends a SCSI REPORT TARGET PORT GROUPS command.

sg_safte

fetch status from a SCSI Accessed Fault-Tolerant Enclosure (SAF-TE) device.

sg_sat_identify

sends a ATA IDENTIFY (PACKET) DEVICE command via a SCSI to ATA Translation (SAT) layer.

sg_sat_phy_event

sends an ATA READ LOG EXT command via a SAT pass through to fetch log page 11h which contains SATA phy event counters.

sg_sat_set_features

sends a ATA SET FEATURES command via a SCSI to ATA Translation (SAT) layer.

sg_scan

does a scan of sg devices (or given SCSI/ATAPI/ATA devices) and prints the results.

sg_senddiag

performs a SCSI SEND DIAGNOSTIC command.

sg_ses

sends controls and fetch status from a SCSI Enclosure Services (SES) device.

sg_start

sends SCSI START STOP UNIT command to start, stop, load or eject medium.

sg_stpg

sends a SCSI SET TARGET PORT GROUPS command.

sg_sync

sends the scsi command synchronize cache.

sg_test_rwbuf

tests the SCSI host adapter by issuing write and read operations on a device's buffer and calculating checksums.

sg_turs

sends one or more SCSI TEST UNIT READY commands.

sg_unmap

sends a SCSI UNMAP command.

sg_verify

invoke SCSI VERIFY command(s) on a block device.

sg_vpd

fetches Vital Product Data (VPD) pages using a SCSI INQUIRY command.

sg_write_buffer

sends a SCSI WRITE BUFFER command.

sg_write_long

sends the SCSI WRITE LONG command.

sg_write_same

sends the SCSI WRITE SAME command.

sg_wr_mode

write mode page.

libsgutils2.{so,a}

contains the sg3_utils API functions.

Last updated on 2010-04-24 13:40:26 +0000