Section: User Commands (1)


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'.
Scan the bus for SCSI devices and display their properties.
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.
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.
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>.




This document was created by man2html, using the manual pages.