s2pdump − SCSI/SASI drive dump/restore tool for SCSI2Pi
s2pdump [−-scsi-id/-i ID[:LUN]] [−-sasi-id/-h ID[:LUN]] [−-board-id/-B BOARD_ID] [−-image-file/-f IMAGE_FILE] [−-buffer-size/-b BUFFER_SIZE] [−-inquiry/-I] D[:LUN] [−-log-level/-L LOG_LEVEL] [−-scsi-scan/-s] [−-sasi-scan/-t] [−-start-sector/-S START] [−-sector-count/-C COUNT] [−-sasi-capacity/-c CAPACITY] [−-sasi-sector-size/-z SECTOR_SIZE] [−-all-luns/-a] [−-restore/-r]
s2pdump has two modes of operation: dump and restore. These can be used with physical storage media like hard drives and magneto optical drives. Dump mode can be used with read-only media such as CD/DVD drives.
When operating in dump mode, s2pdump will copy all data from a remote drive to an image on the local filesystem. Optionally it generates a .properties file for the web UI. This file can be used to more closely emulate the source drive.
In restore mode s2pdump copies the data from a local image to a remote physical drive. The remote drive must be writable.
s2pdump requires a FULLSPEC PiSCSI/RaSCSI board.
Usually in order to use the generated drive image with SCSI2Pi, it should be moved to the ˜/images folder (or the location specified to s2p).
--scsi-id/-i ID[:LUN]
ID and optional LUN (0-31) of the SCSI target drive.
--sasi-id/-h ID[:LUN]
ID and optional LUN (0-1) of the SASI target drive.
--board-id/-B BOARD_ID
SCSI ID of the SCSI2Pi board. If not specified ID 7 is used. The SCSI2Pi host will be functioning as the "initiator" device. Not relevant for SASI.
--image-file/-f IMAGE_FILE
Path to the dump/restore file.
--buffer-size/-b BUFFER_SIZE
The transfer buffer size in bytes. The default size is 1 MiB, the minimum size is 64 KiB.
--inquiry/-I ID[:LUN]
Display INQUIRY data of ID[:LUN] and (SCSI only) device properties for use with s2p properties files.
--log-level/-L LOG_LEVEL
Set the log level (trace, debug, info, warning, error, critical, off). The default log level is ’info’.
--scsi-scan/-s
Scan the bus for SCSI devices and display their properties.
--sasi-scan/-t
Scan the bus for SASI devices and display their properties.
--start-sector/-S START
Start sector for the dump/restore operation, the default is 0.
--sector-count/-C COUNT
Sector count for the dump/restore operation, the default is the drive capacity.
--sasi-capacity/-c SASI_CAPACITY
The capacity of the SASI hard drive in sectors. This parameter only has a meaning for SASI drives.
--sasi-sector-size/-z SASI_SECTOR_SIZE
The sector size of the SASI hard drive in sectors (256, 512, x1024) in bytes. This parameter only has a meaning for SASI drives.
--all-luns/-a
Check all LUNs during bus scan. The default is to scan LUN 0 only. If the target device supports the REPORT LUNS SCSI command s2pdump uses this command to optimize the scan.
--restore/-r
Run in restore mode. The default is dump mode.
Dump Mode:
[SCSI/SASI Drive] ---> [SCSI2Pi host] Launch s2pdump to
dump all data from the drive with SCSI ID 3 with a dump
buffer size of 128 KiB. Store it on the local filesystem as
a drive image named out_image.hds.
s2pdump -i 3 -f out_image.hds -b 131072
Restore Mode:
[SCSI2Pi host] ---> [SCSI/SASI Drive] Launch s2pdump to
restore/upload a drive image from the local file system to
SCSI ID 0 with a restore buffer size of 1 MiB:
s2pdump -r -i 0 -f in_image.hds -b 1048576
s2p(1), s2pctl(1), s2pexec(1), s2pproto(1)
Also see <https://www.scsi2pi.net> and <https://github.com/uweseimet/scsi2pi>.