s2pdump

Section: User Commands (1)
Index

NAME

s2pdump - SCSI/SASI hard drive/tape drive dump/restore tool

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] [--scsi-generic/-g DEVICE_FILE]

DESCRIPTION

s2pdump has two modes of operation: dump and restore. These can be used with storage devices like hard drives, magneto optical drives or tape drives. Dump mode can also be used with read-only media such as CD/DVD drives. When using devices managed by the Linux SG 3 driver, s2pdump can be used on any Linux system, not just on a Pi.

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. When used with a tape drive, the data are dumped in a SIMH-compatible format.

In restore mode s2pdump copies the data from a local image to a remote physical drive. The remote drive must be writable.
Restoring a tape drive expects a SIMH-compatible file.

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 of the source/destination image 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 property files, e.g. /etc/s2p.conf.
--log-level/-L LOG_LEVEL: Set the log level (trace, debug, info, warning, error, critical, off). The default log level is 'warning'.
--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: Only for hard drives, not for tape drives: start sector for the dump/restore operation, the default is 0.
--sector-count/-C COUNT: Only for hard drives, not for tape drives: 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.
--scsi-generic/-g DEVICE_FILE: Use the Linux SG driver with the specified device file instead of a RaSCSI/PiSCSI board.

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 hard drive or SCSI tape 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

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