2020-07-09 18:28:17 +00:00
|
|
|
|
!! ------ THIS FILE IS AUTO_GENERATED! DO NOT MANUALLY UPDATE!!!
|
2021-08-07 00:30:35 +00:00
|
|
|
|
!! ------ The native file is rascsi.1. Re-run 'make docs' after updating\n\n
|
2021-06-23 00:30:33 +00:00
|
|
|
|
rascsi(1) General Commands Manual rascsi(1)
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
rascsi - Emulates SCSI devices using the Raspberry Pi GPIO pins
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
2021-08-07 00:30:35 +00:00
|
|
|
|
rascsi [-f[u00AE] FOLDER] [-g[u00AE] LOG_LEVEL] [-h] [-p[u00AE] PORT]
|
|
|
|
|
[-v] [-IDn FILE] [-HDn FILE]...
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
rascsi Emulates SCSI devices using the Raspberry Pi GPIO pins.
|
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
In the arguments to RaSCSI, one or more SCSI (-IDn) or SASI (-HDn) de‐
|
|
|
|
|
vices can be specified. The number (n) after the ID or HD identifier
|
|
|
|
|
specifies the ID number for that device. For SCSI: The ID is limited
|
|
|
|
|
from 0-7. However, typically SCSI ID 7 is reserved for the "initiator"
|
|
|
|
|
(the host computer). Note that SASI is considered rare and only used on
|
2021-06-23 00:30:33 +00:00
|
|
|
|
very early Sharp X68000 computers.
|
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
RaSCSI will determine the type of device based upon the file extension
|
2021-06-23 00:30:33 +00:00
|
|
|
|
of the FILE argument.
|
2021-08-07 00:30:35 +00:00
|
|
|
|
hdf: SASI Hard Disk image (XM6 SASI HD image - typically only used
|
2021-06-23 00:30:33 +00:00
|
|
|
|
with X68000)
|
2021-08-07 00:30:35 +00:00
|
|
|
|
hds: SCSI Hard Disk image (generic)
|
2020-07-09 18:21:15 +00:00
|
|
|
|
hdn: SCSI Hard Disk image (NEC GENUINE)
|
|
|
|
|
hdi: SCSI Hard Disk image (Anex86 HD image)
|
|
|
|
|
nhd: SCSI Hard Disk image (T98Next HD image)
|
2021-06-23 00:30:33 +00:00
|
|
|
|
hda: SCSI Hard Disk image (APPLE GENUINE - typically used with Mac
|
|
|
|
|
SCSI emulation)
|
|
|
|
|
mos: SCSI Magneto-optical image (XM6 SCSI MO image - typically only
|
|
|
|
|
used with X68000)
|
2020-07-09 18:21:15 +00:00
|
|
|
|
iso: SCSI CD-ROM image (ISO 9660 image)
|
|
|
|
|
|
2021-06-23 00:30:33 +00:00
|
|
|
|
For example, if you want to specify an Apple-compatible HD image on ID
|
|
|
|
|
0, you can use the following command:
|
2020-07-09 18:21:15 +00:00
|
|
|
|
sudo rascsi -ID0 /path/to/drive/hdimage.hda
|
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
Once RaSCSI starts, it will open a socket (default port is 6868) to al‐
|
|
|
|
|
low external management commands. If another process is using the
|
|
|
|
|
rascsi port, RaSCSI will terminate, since it is likely another instance
|
|
|
|
|
of RaSCSI. Once RaSCSI has initialized, the rasctl utility can be used
|
|
|
|
|
to send commands.
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
2021-06-23 00:30:33 +00:00
|
|
|
|
To quit RaSCSI, press Control + C. If it is running in the background,
|
|
|
|
|
you can kill it using an INT signal.
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
|
|
|
|
OPTIONS
|
2021-08-07 00:30:35 +00:00
|
|
|
|
-f FOLDER
|
|
|
|
|
The default folder for image files. For files in this folder no
|
|
|
|
|
absolute path needs to be specified. The default folder is
|
|
|
|
|
'/home/pi/images'.
|
|
|
|
|
|
|
|
|
|
-g LOG_LEVEL
|
|
|
|
|
The rascsi log level (trace, debug, info, warn, err, critical,
|
|
|
|
|
off). The default log level is 'trace'.
|
|
|
|
|
|
|
|
|
|
-h Show a help page.
|
|
|
|
|
|
|
|
|
|
-p PORT
|
|
|
|
|
The rascsi server port, default is 6868.
|
|
|
|
|
|
|
|
|
|
-v Display the rascsi version.
|
|
|
|
|
|
2021-08-10 02:20:58 +00:00
|
|
|
|
-IDn FILE[:TYPE]
|
2020-07-09 18:21:15 +00:00
|
|
|
|
n is the SCSI ID number (0-7)
|
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
FILE is the name of the image file to attach to that ID. If FILE
|
|
|
|
|
starts with '/dev/' the extension, which encodes the device
|
|
|
|
|
type, is stripped, so that device files can conveniently be used
|
2021-08-10 02:20:58 +00:00
|
|
|
|
as image files. An optional explicit device type (SASI_HD,
|
|
|
|
|
SCSI_HD, CD, MO, BR, NUVOLINK, DAYNAPORT) can be provided after
|
|
|
|
|
a colon.
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
|
|
|
|
-HDn FILE
|
|
|
|
|
n is the SASI ID number (0-15)
|
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
FILE is the name of the image file to attach to that ID. If FILE
|
|
|
|
|
starts with '/dev/' the extension, which encodes the device
|
|
|
|
|
type, is stripped, so that device files can conveniently be used
|
|
|
|
|
as image files.
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
Note: SASI usage is rare, and is typically limited to early
|
2021-06-23 00:30:33 +00:00
|
|
|
|
Sharp X68000 systems.
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
|
|
|
|
EXAMPLES
|
|
|
|
|
Launch RaSCSI with no emulated drives attached:
|
|
|
|
|
rascsi
|
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
Launch RaSCSI with an Apple hard drive image as ID 0 and a CD-ROM as ID
|
2021-06-23 00:30:33 +00:00
|
|
|
|
2
|
2020-07-09 18:21:15 +00:00
|
|
|
|
rascsi -ID0 /path/to/harddrive.hda -ID2 /path/to/cdimage.iso
|
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
Launch RaSCSI with a SCSI hard drive image as ID 0 and the raw device
|
|
|
|
|
file /dev/hdb (e.g. a USB stick) as an image file:
|
|
|
|
|
rascsi -ID0 /dev/hdb.hds
|
|
|
|
|
|
2020-07-09 18:21:15 +00:00
|
|
|
|
To create an empty, 100MB HD image, use the following command:
|
|
|
|
|
dd if=/dev/zero of=/path/to/newimage.hda bs=512 count=204800
|
|
|
|
|
|
2021-08-07 00:30:35 +00:00
|
|
|
|
In case the fallocate command is available a much faster alternative to
|
|
|
|
|
the dd command is:
|
|
|
|
|
fallocate -l 104857600 /path/to/newimage.hda
|
|
|
|
|
|
2020-07-09 18:21:15 +00:00
|
|
|
|
SEE ALSO
|
2020-10-19 12:31:06 +00:00
|
|
|
|
rasctl(1), scsimon(1)
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
2021-06-23 00:30:33 +00:00
|
|
|
|
Full documentation is available at:
|
|
|
|
|
<https://www.github.com/akuker/RASCSI/wiki/>
|
2020-07-09 18:21:15 +00:00
|
|
|
|
|
2021-06-23 00:30:33 +00:00
|
|
|
|
rascsi(1)
|