FM / examples

/usr/share/doc/sg3-utils/examples

Name	Size	Mode	Actions
archive/	-	0755	rm
forwarded_sense.txt	296	0644	edit dl rm
Makefile	3156	0644	edit dl rm
Makefile.freebsd	2023	0644	edit dl rm
nvme_dev_self_test.hex	806	0644	edit dl rm
nvme_identify_ctl.hex	1198	0644	edit dl rm
nvme_read_ctl.hex	1832	0644	edit dl rm
nvme_write_ctl.hex	1846	0644	edit dl rm
README	776	0644	edit dl rm
reassign_addr.txt	465	0644	edit dl rm
ref_sense.txt	305	0644	edit dl rm
scsi_inquiry.c	4185	0644	edit dl rm
sdiag_sas_p0_cjtpat.txt	405	0644	edit dl rm
sdiag_sas_p0_prbs9.txt	407	0644	edit dl rm
sdiag_sas_p1_cjtpat.txt	464	0644	edit dl rm
sdiag_sas_p1_idle.txt	560	0644	edit dl rm
sdiag_sas_p1_prbs15.txt	408	0644	edit dl rm
sdiag_sas_p1_stop.txt	359	0644	edit dl rm
sgq_dd.c	38679	0644	edit dl rm
sg_compare_and_write.txt	2483	0644	edit dl rm
sg_excl.c	6128	0644	edit dl rm
sg_persist_tst.sh	3624	0755	edit dl rm
sg_sat_chk_power.c	9164	0644	edit dl rm
sg_sat_smart_rd_data.c	6556	0644	edit dl rm
sg_simple1.c	6006	0644	edit dl rm
sg_simple2.c	6744	0644	edit dl rm
sg_simple3.c	6612	0644	edit dl rm
sg_simple4.c	7424	0644	edit dl rm
sg_simple5.c	7649	0644	edit dl rm
sg_simple16.c	3494	0644	edit dl rm
sg_unmap_example.txt	1571	0644	edit dl rm
sg__sat_identify.c	7733	0644	edit dl rm
sg__sat_phy_event.c	12304	0644	edit dl rm
sg__sat_set_features.c	9934	0644	edit dl rm
transport_ids.txt	1124	0644	edit dl rm

Edit: /usr/share/doc/sg3-utils/examples/sg_compare_and_write.txt (2483B)

$ hexdump /tmp/caw_buf_zero2one
0000000 0000 0000 0000 0000 0000 0000 0000 0000
*
0000200 1111 1111 1111 1111 1111 1111 1111 1111
*
0000400

$ hexdump /tmp/caw_buf_one2zero
0000000 1111 1111 1111 1111 1111 1111 1111 1111
*
0000200 0000 0000 0000 0000 0000 0000 0000 0000
*
0000400

$ sg_map -i -x
/dev/sg0  0 0 0 0  0  /dev/sda  ATA       ST3320613AS       CC2H
/dev/sg1  3 0 0 0  5  /dev/scd0  HL-DT-ST  DVD-RAM GH22NS30  1.01
/dev/sg2  5 0 0 0  0  /dev/sdb  KMNRIO    K2                0000
/dev/sg3  5 0 0 1  0  /dev/sdc  KMNRIO    K2                0000

# First I zero out the volume to make sure that the first compare and write
# will succeed
$ sg_write_same --16 -i /dev/zero -n 0x200000  -x 512 /dev/sdc

$ dd if=/dev/sdc bs=512 count=1 skip=100 2>/dev/null | hexdump
0000000 0000 0000 0000 0000 0000 0000 0000 0000
*
0000200

$ ./sg_compare_and_write --in=/tmp/caw_buf_zero2one --lba=100 --xferlen=1024 /dev/sdc

# contents of LBA 100 are a block of ones
$ dd if=/dev/sdc bs=512 count=1 skip=100 2>/dev/null | hexdump
0000000 1111 1111 1111 1111 1111 1111 1111 1111
*
0000200

# We repeat the same compare and write command (zero2one input buffer).
# compare and write fails since the verify failed (compared the zero block to
# the actual 1 block in LBA 100
$ ./sg_compare_and_write --in=/tmp/caw_buf_zero2one --lba=100 --xferlen=1024 /dev/sdc
COMPARE AND WRITE:  Fixed format, current;  Sense key: Miscompare
 Additional sense: Miscompare during verify operation
sg_compare_and_write: SCSI COMPARE AND WRITE failed

# Now we use the second buffer (one2zero)
$ ./sg_compare_and_write --in=/tmp/caw_buf_one2zero --lba=100 --xferlen=1024 /dev/sdc

# operation succeeded, contents of LBA 100 are back to zero
$ dd if=/dev/sdc bs=512 count=1 skip=100 2>/dev/null | hexdump
0000000 0000 0000 0000 0000 0000 0000 0000 0000
*
0000200

# sg_compare_and_write.txt # This file provides a usage example of sg_compare_and_write. # sg_compare_and_write accepts a buffer containing 2 logical instances: # - the verify instance: used to match the current content of the LBA range # - the write instance: used to write to the LBA if the verify succeeds # # In case of failure to verify the data, the command will return with check # condition with the sense code set to MISCOMPARE DURING VERIFY OPERATION. # # The following example shows initialization, successful and unsuccessful # compare and write using sg3_utils. I am using caw_buf_zero2one and # caw_buf_one2zero as shown below. $ hexdump /tmp/caw_buf_zero2one 0000000 0000 0000 0000 0000 0000 0000 0000 0000 * 0000200 1111 1111 1111 1111 1111 1111 1111 1111 * 0000400 $ hexdump /tmp/caw_buf_one2zero 0000000 1111 1111 1111 1111 1111 1111 1111 1111 * 0000200 0000 0000 0000 0000 0000 0000 0000 0000 * 0000400 $ sg_map -i -x /dev/sg0 0 0 0 0 0 /dev/sda ATA ST3320613AS CC2H /dev/sg1 3 0 0 0 5 /dev/scd0 HL-DT-ST DVD-RAM GH22NS30 1.01 /dev/sg2 5 0 0 0 0 /dev/sdb KMNRIO K2 0000 /dev/sg3 5 0 0 1 0 /dev/sdc KMNRIO K2 0000 # First I zero out the volume to make sure that the first compare and write # will succeed $ sg_write_same --16 -i /dev/zero -n 0x200000 -x 512 /dev/sdc $ dd if=/dev/sdc bs=512 count=1 skip=100 2>/dev/null | hexdump 0000000 0000 0000 0000 0000 0000 0000 0000 0000 * 0000200 $ ./sg_compare_and_write --in=/tmp/caw_buf_zero2one --lba=100 --xferlen=1024 /dev/sdc # contents of LBA 100 are a block of ones $ dd if=/dev/sdc bs=512 count=1 skip=100 2>/dev/null | hexdump 0000000 1111 1111 1111 1111 1111 1111 1111 1111 * 0000200 # We repeat the same compare and write command (zero2one input buffer). # compare and write fails since the verify failed (compared the zero block to # the actual 1 block in LBA 100 $ ./sg_compare_and_write --in=/tmp/caw_buf_zero2one --lba=100 --xferlen=1024 /dev/sdc COMPARE AND WRITE: Fixed format, current; Sense key: Miscompare Additional sense: Miscompare during verify operation sg_compare_and_write: SCSI COMPARE AND WRITE failed # Now we use the second buffer (one2zero) $ ./sg_compare_and_write --in=/tmp/caw_buf_one2zero --lba=100 --xferlen=1024 /dev/sdc # operation succeeded, contents of LBA 100 are back to zero $ dd if=/dev/sdc bs=512 count=1 skip=100 2>/dev/null | hexdump 0000000 0000 0000 0000 0000 0000 0000 0000 0000 * 0000200