Beyond Linux® From Scratch - Version 7.5

Chapter 12. System Utilities

sg3_utils-1.37

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).

This package is known to build and work properly using an LFS-7.5 platform.

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 --disable-static &&
make

This package does not come with a test suite.

Now, as the root user: 

make install

Command Explanations

--disable-static: This switch prevents installation of static versions of the libraries.

Contents

Installed Programs: scsi_logging_level, scsi_mandat, scsi_readcap, scsi_ready, scsi_satl, scsi_start, scsi_stop, scsi_temperature, sg_compare_and_write, sg_copy_results, sg_dd, sg_decode_sense, 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_referrals, sg_requests, sg_reset, sg_rmsn, sg_rtpg, sg_safte, sg_sanitize, 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, sg_wr_mode, and sg_xcopy
Installed Library: libsgutils2.so
Installed Directories: None

Short Descriptions

sg_compare_and_write

sends the SCSI COMPARE AND WRITE command to device.

sg_copy_results

sends the SCSI RECEIVE COPY RESULTS command (XCOPY related).

sg_dd

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

sg_decode_sense

takes SCSI sense data in binary or as a sequence of ASCII hexadecimal bytes and decodes it.

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_referrals

sends the SCSI REPORT REFERRALS 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_sanitize

sends a SCSI SANITIZE command.

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

writes mode page.

sg_xcopy

copies data to and from files and devices using SCSI EXTENDED COPY (XCOPY).

libsgutils2.so

contains the sg3_utils API functions.

Last updated on 2014-02-23 11:35:28 -0800