Mini Shell
Command coverage
================
The following table lists SCSI commands in alphabetical order on the
left and the sg3_utils (or related) utilities that implement invocations
of them on the right. The second table lists supported ATA commands. The
third table list supported NVMe commands.
SCSI command sg3_utils utilities that use this SCSI command
------------ -------------------------------------------------
ATA COMMAND PASS-THROUGH(12) sg_sat_identify, ++
ATA COMMAND PASS-THROUGH(16) sg_sat_identify, sg_sat_set_features,
sg_sat_phy_event, sg_sat_read_gplog ++
[sg_sat_chk_power, sg__sat_identify,
sg__sat_set_features, sg_sat_smart_rd_data
(previous four in the examples directory)]
ATA COMMAND PASS-THROUGH(32) sg_sat_identify, ++
BACKGROUND CONTROL sg_bg_ctl
CLOSE ZONE sg_zone
COMPARE AND WRITE sg_compare_and_write
COPY OPERATION ABORT ddptctl, ++
EXTENDED COPY(LID1) sg_xcopy, ddpt, ++
GET CONFIGURATION sg_get_config, ++
GET LBA STATUS sg_get_lba_status, ++
GET PHYSICAL ELEMENT STATUS sg_get_elem_status, ++
GET STREAM STATUS sg_stream_ctl
INQUIRY sg_dd, sg_format, sg_inq, sginfo,
sg_logs, sg_map('-i'), sg_modes, sg_opcodes,
sg_persist, sg_scan, sg_ses, sg_vpd ++
FINISH ZONE sg_zone
FORMAT MEDIUM sg_format, ++ [SSC]
FORMAT UNIT sg_format, ++ [SBC]
FORMAT WITH PRESET sg_format, ++ [SBC]
LOG SELECT sg_logs('-r' or '-select'), ++
LOG SENSE sg_logs, ++
MODE SELECT(6) sdparm, sg_wr_mode, sginfo, sg_format,
sg_emc_trespass, sg_rdac, ++
MODE SELECT(10) sdparm, sg_wr_mode, sginfo, sg_format,
sg_emc_trespass, sg_rdac, ++
MODE SENSE(6) sdparm, sg_modes, sg_wr_mode, sginfo, sg_format,
sg_senddiag('-e'), sg_rdac, ++
MODE SENSE(10) sdparm, sg_modes, sg_wr_mode, sginfo, sg_format,
sg_senddiag('-e'), sg_rdac, ++
OPEN ZONE sg_zone
ORWRITE(16) sg_write_x
ORWRITE(32) sg_write_x
PERSISTENT RESERVE IN sg_persist, ++
PERSISTENT RESERVE OUT sg_persist, ++
POPULATE TOKEN ddpt, ddptctl, ++
PRE-FETCH(10) sg_seek
PRE-FETCH(16) sg_seek
PREVENT ALLOW MEDIUM REMOVAL sg_prevent, ++
READ(6) sg_dd, sgm_dd, sgp_dd, sg_read
READ(10) sg_dd, sgm_dd, sgp_dd, sg_read
READ(12) sg_dd, sgm_dd, sgp_dd, sg_read
READ(16) sg_dd, sgm_dd, sgp_dd, sg_read
READ ATTRUBUTE sg_read_attr
READ BLOCK LIMITS sg_read_block_limits, ++
READ BUFFER(10) sg_rbuf, sg_test_rwbuf, sg_read_buffer, sg_safte, ++
READ BUFFER(16) sg_read_buffer
READ CAPACITY(10) sg_readcap, sg_dd, sgm_dd, sgp_dd, sg_format, ++
READ CAPACITY(16) sg_readcap, sg_dd, sgm_dd, sgp_dd, sg_format, ++
READ DEFECT(10) sginfo('-d' or '-G'), sg_reassign('-g'), smartmontools, ++
READ DEFECT(12) sginfo('-d' or '-G'), smartmontools
READ LONG(10) sg_read_long, sg_dd, ++
READ LONG(16) sg_read_long, ++
READ MEDIA SERIAL NUMBER sg_rmsn, ++
REASSIGN BLOCKS sg_reassign, ++
RECEIVE COPY DATA(LID1) sg_copy_results, ++
RECEIVE COPY FAILURE DETAILS(LID1) sg_copy_results, ++
RECEIVE COPY OPERATING PARAMETERS ddpt, sg_copy_results, sg_xcopy, ++
RECEIVE COPY STATUS(LID1) sg_copy_results, ++
RECEIVE DIAGNOSTIC RESULTS sg_senddiag, sg_ses, sg_ses_microcode ++
RECEIVE ROD TOKEN INFORMATION ddpt, ddptctl ++
REMOVE ELEMENT AND MODIFY ZONES sg_zone
REPORT ALL ROD TOKENS ddptctl ++
REPORT IDENTIFYING INFORMATION sg_ident, ++ (2)
REPORT LUNS sg_luns, ++
REPORT PROVISIONING INITIALIZATION PATTERN sg_rep_pip, ++
REPORT REALMS sg_rep_zones
REPORT REFERRALS sg_referrals, ++
REPORT SUPPORTED OPERATION CODES sg_opcodes
REPORT SUPPORTED TASK MANAGEMENT FUNCTIONS sg_opcodes
REPORT TARGET PORT GROUPS sg_rtpg, sg_stpg ++
REPORT TIMESTAMP sg_timestamp
REPORT ZONES sg_rep_zones
REPORT ZONE DOMAINS sg_rep_zones
REQUEST SENSE sg_requests, ++
RESET WRITE POINTER sg_reset_wp
SANITIZE sg_sanitize
SEEK(10) sg_seek ++
SEND DIAGNOSTIC sg_senddiag, sg_ses, sg_ses_microcode ++
SEQUENTIALIZE ZONE sg_zone
SET IDENTIFYING INFORMATION sg_ident, ++ (3)
SET TARGET PORT GROUPS sg_stpg, ++
SET TIMESTAMP sg_timestamp
START STOP sg_start, ++
STREAM CONTROL sg_stream_ctl
SYNCHRONIZE CACHE(10) sg_sync, sg_dd, sgm_dd, sgp_dd, ++
SYNCHRONIZE CACHE(16) sg_sync++
TEST UNIT READY sg_turs, sg_format, ++
UNMAP sg_unmap, ++
VERIFY(10) sg_verify, ++
VERIFY(16) sg_verify, ++
WRITE(6) sg_dd, sgm_dd, sgp_dd
WRITE(10) sg_dd, sgm_dd, sgp_dd
WRITE(12) sg_dd, sgm_dd, sgp_dd
WRITE(16) sg_dd, sgm_dd, sgp_dd, sg_write_x
WRITE(32) sg_write_x
WRITE AND VERIFY(10) sg_write_verify
WRITE AND VERIFY(16) sg_write_verify
WRITE ATOMIC(16) ddpt, sg_write_x
WRITE ATOMIC(32) sg_write_x
WRITE BUFFER sg_test_rwbuf, sg_write_buffer, ++
WRITE LONG(10) sg_write_long, ++
WRITE LONG(16) sg_write_long, ++
WRITE SAME(10) sg_write_same
WRITE SAME(16) sg_write_same, sg_write_x
WRITE SAME(32) sg_write_same, sg_write_x
WRITE SCATTERED(16) sg_write_x
WRITE SCATTERED(32) sg_write_x
WRITE STREAM(16) sg_write_x
WRITE STREAM(32) sg_write_x
WRITE USING TOKEN ddpt, ddptctl, ++
<most commands> sg_raw
ATA command sg3_utils utilities that use this (S)ATA command
----------- ------------------------------------------------
CHECK POWER MODE examples/sg_sat_chk_power
IDENTIFY DEVICE sg_inq, sg_scan, sg_sat_identify,
examples/sg__sat_identify
IDENTIFY PACKET DEVICE sg_inq, sg_sat_identify,
examples/sg__sat_identify
READ LOG EXT sg_sat_phy_event, examples/sg__sat_phy_event
sg_sat_read_gplog
READ LOG DMA EXT sg_sat_read_gplog
SET FEATURES sg_sat_set_features
examples/sg__sat_set_features
SMART READ DATA examples/sg_sat_smart_rd_data
NVMe command sg3_utils utilities that use this NVMe command
------------ ------------------------------------------------
Identify sg_inq
SES Read sg_senddiag, sg_ses (NVME-MI command)
SES Write sg_senddiag, sg_ses (NVME-MI command)
Device self-test [SNTL of SEND DIAGNOSTIC] sg_senddiag
Get features(power management) [SNTL of REQUEST SENSE] sg_requests
Read [SCSI READ(10) -->SNTL--> Read]
[SCSI READ(16) -->SNTL--> Read]
Write [SCSI WRITE(10) -->SNTL--> Write]
[SCSI WRITE(16) -->SNTL--> Write]
Compare [SCSI VERIFY(10,BYTCHK=1) -->SNTL--> Compare]
[SCSI VERIFY(16,BYTCHK=1) -->SNTL--> Compare]
Write zeroes [SCSI WRITE SAME(10,zeros) -->SNTL--> Write zeroes]
[SCSI WRITE SAME(16,zeros) -->SNTL--> Write zeroes]
Flush [SCSI SYNCHRONIZE CACHE -->SNTL--> Flush]
Set Features [SCSI MODE SELECT(10) -->SNTL--> Set Features]
only for WCE in Caching page
The following SCSI commands do nothing (currently) in the SNTL but
do return GOOD status: TEST UNIT READY, START STOP UNIT, REPORT LUNS
and REQUEST SENSE. READ CAPACITY(10 and 16) yield appropriate data
by examining the response to the NVMe Identify command.
++ command wrapper found in sg_cmds_basic.c, sg_cmds_mmc.c or
sg_cmds_extra.c for this command
(2) this command was known as REPORT DEVICE IDENTIFIER prior to spc4r07
(3) this command was known as SET DEVICE IDENTIFIER prior to spc4r07
Note that any SCSI command, including bi-directional and variable length
commands (whose cdb size is > 16 bytes) can be issued by the sg_raw utility.
The RECEIVE COPY * commands in SPC-4 were grouped as one command name
with 4 service actions in SPC-3 and earlier. The single SPC-3 command
name is RECEIVE COPY RESULTS. The two opcodes associated with all
EXTENDED COPY commands are now known as THIRD PARTY COPY IN (0x84) and
THIRD PARTY COPY IN (0x83).
Douglas Gilbert
30th August 2021
Zerion Mini Shell 1.0