s2pdump

NAME
SYNOPSIS
DESCRIPTION
NOTES
OPTIONS
EXAMPLES
SEE ALSO

NAME

s2pdump − SCSI/SASI drive dump/restore tool for SCSI2Pi

SYNOPSIS

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]

DESCRIPTION

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.

NOTES

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

OPTIONS

−-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, 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.

EXAMPLES

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

SEE ALSO

s2p(1), s2pctl(1), s2pexec(1), s2pproto(1)

Also see <https://www.scsi2pi.net> and <https://github.com/uweseimet/scsi2pi>.