mirror of
https://github.com/akuker/RASCSI.git
synced 2024-11-27 04:49:18 +00:00
89d66ef02b
* Updated logging * Updated logging * Updated logging * Updated ID/LUN parsing * Updated handling of max_id * The -HD option sets type to SAHD * Replaced is_sasi by device type * Updated logging * Logging update * Improved LUN evaluation * Check LUN against UnitMax * Comment update * LUN parsing update * Logging update * Logging update * Updated ReportLuns * Updated REPORT LUNS * Cleanup * Updated REPORT LUNS * Updated Execute() * Updated LUN handling * Check for consecutive LUNs * Added LUN check for remotely attached devices * Remember LUN selected by IDENTIFY * Evaluate LUN from IDENTIFY message * Added comment * Updated REPORT LUNS * Initlize LUN * Logging update * Support 32 LUNs * rasctl display update * Updated LUN check for LUNSs > 7 * Simplified LUN validation * Fixed wrong ID/LUN handling with values > 9 * Log level update * Manpage update * rascsi parser update * Updated error handling * Updated error handling * Updated LUN setup validation * Updated logging * Improved validation of consecutive LUNs * Renaming * Detach all LUNs equal to or higher than the one specified * Add support for LUN in the device list * Add ability to show device info for LUNs * Make it possible to detach and eject LUNs * Show full path to prop file * Show only LUN columns when non-0 LUNs present * Support for attaching LUNs * Add helptext * Fix handling of removable media * Retain the previous behavior of recommending the next unoccupied id * SCSI ID validation no longer needed due to changed logic * Make use of recommended id everywhere * Docstring Co-authored-by: Daniel Markstedt <markstedt@gmail.com>
156 lines
6.0 KiB
Plaintext
156 lines
6.0 KiB
Plaintext
!! ------ THIS FILE IS AUTO_GENERATED! DO NOT MANUALLY UPDATE!!!
|
||
!! ------ The native file is rasctl.1. Re-run 'make docs' after updating\n\n
|
||
rascsi(1) General Commands Manual rascsi(1)
|
||
|
||
NAME
|
||
rasctl - Sends management commands to the rascsi process
|
||
|
||
SYNOPSIS
|
||
rasctl -e | -l | -m | -s | -v | -I | -L | -O | -T | -V | [-E FILENAME]
|
||
[-F IMAGE_FOLDER] [-C FILENAME:FILESIZE] [-x CURRENT_NAME:NEW_NAME] [-R
|
||
CURRENT_NAME:NEW_NAME] [-g LOG_LEVEL] [-h HOST] [-p PORT] [-r RE‐
|
||
SERVED_IDS] [-i ID [-c CMD] [-f FILE|PARAM] [-n NAME] [-t TYPE] [-u
|
||
UNIT]
|
||
|
||
DESCRIPTION
|
||
rasctl Sends commands to the rascsi process to make configuration ad‐
|
||
justments at runtime or to check the status of the devices.
|
||
|
||
Either the -i or -l option should be specified at one time. Not both.
|
||
|
||
You do NOT need root privileges to use rasctl.
|
||
|
||
Note: The command and type arguments are case insensitive. Only the
|
||
first letter of the command/type is evaluated by the tool.
|
||
|
||
OPTIONS
|
||
-C FILENAME:FILESIZE
|
||
Create an image file in the default image folder with the speci‐
|
||
fied name and size in bytes.
|
||
|
||
-E FILENAME
|
||
Display information on an image file.
|
||
|
||
-F IMAGE_FOLDER
|
||
Set the default image folder.
|
||
|
||
-I Gets the list of reserved device IDs.
|
||
|
||
-L LOG_LEVEL
|
||
Set the rascsi log level (trace, debug, info, warn, err, criti‐
|
||
cal, off).
|
||
|
||
-h HOST
|
||
The rascsi host to connect to, default is 'localhost'.
|
||
|
||
-e List all images files in the default image folder.
|
||
|
||
-N Lists all available network interfaces provided that they are
|
||
up.
|
||
|
||
-O Display the available rascsi server log levels and the current
|
||
log level.
|
||
|
||
-l List all of the devices that are currently being emulated by
|
||
RaSCSI, as well as their current status.
|
||
|
||
-m List all file extensions recognized by RaSCSI and the device
|
||
types they map to.
|
||
|
||
-R CURRENT_NAME:NEW_NAME
|
||
Rename an image file in the default image folder.
|
||
|
||
-p PORT
|
||
The rascsi port to connect to, default is 6868.
|
||
|
||
-r RESERVED_IDS
|
||
Comma-separated list of IDs to reserve.
|
||
|
||
-s Display server-side settings like available images or supported
|
||
device types.
|
||
|
||
-T Display all device types and their properties.
|
||
|
||
-v Display the rascsi server version.
|
||
|
||
-V Display the rasctl version.
|
||
|
||
-D FILENAME
|
||
Delete an image file in the default image folder.
|
||
|
||
-x CURRENT_NAME:NEW_NAME
|
||
Copy an image file in the default image folder.
|
||
|
||
-i ID ID is the SCSI ID that you want to control. (0-7)
|
||
|
||
-c CMD Command is the operation being requested. Options are:
|
||
a(ttach): Attach disk
|
||
d(etach): Detach disk
|
||
i(nsert): Insert media (removable media devices only)
|
||
e(ject): Eject media (removable media devices only)
|
||
p(rotect): Write protect the medium (not for CD-ROMs, which
|
||
are always read-only)
|
||
u(nprotect): Remove write protection from the medium (not for
|
||
CD-ROMs, which are always read-only)
|
||
s(how): Display device information
|
||
|
||
eject, protect and unprotect are idempotent.
|
||
|
||
-b BLOCK_SIZE
|
||
The optional block size. For SCSI drives 512, 1024, 2048 or 4096
|
||
bytes, default size is 512 bytes. For SASI drives 256 or 1024
|
||
bytes, default is 256 bytes.
|
||
|
||
-f FILE|PARAM
|
||
Device-specific: Either a path to a disk image file, or a param‐
|
||
eter for a non-disk device. See the rascsi(1) man page for per‐
|
||
mitted file types.
|
||
|
||
-t TYPE
|
||
Specifies the device type. This type overrides the type derived
|
||
from the file extension of the specified image. See the
|
||
rascsi(1) man page for the available device types. For some
|
||
types there are shortcuts (only the first letter is required):
|
||
hd: SCSI hard disk drive
|
||
rm: SCSI removable media drive
|
||
cd: CD-ROM
|
||
mo: Magneto-Optical disk
|
||
bridge: Bridge device (Only applicable to the Sharp X68000)
|
||
daynaport: DaynaPORT network adapter
|
||
|
||
-n VENDOR:PRODUCT:REVISION
|
||
The vendor, product and revision for the device, to be returned
|
||
with the INQUIRY data. A complete set of name components must be
|
||
provided. VENDOR may have up to 8, PRODUCT up to 16, REVISION up
|
||
to 4 characters. Padding with blanks to the maxium length is au‐
|
||
tomatically applied. Once set the name of a device cannot be
|
||
changed.
|
||
|
||
-u UNIT
|
||
Unit number (0-31). This will default to 0. This option is only
|
||
used when there are multiple SCSI devices on a shared SCSI con‐
|
||
troller. (This is not common)
|
||
|
||
EXAMPLES
|
||
Show a listing of all of the SCSI devices and their current status.
|
||
rasctl -l
|
||
|
||
Example output:
|
||
+----+----+------+-------------------------------------
|
||
| ID | UN | TYPE | DEVICE STATUS
|
||
+----+----+------+-------------------------------------
|
||
| 0 | 1 | SCHD | /home/pi/harddisk.hda
|
||
+----+----+------+-------------------------------------
|
||
|
||
Request the RaSCSI process to attach a disk (assumed) to SCSI ID 0 with
|
||
the contents of the file system image "HDIIMAGE0.HDS".
|
||
rasctl -i 0 -f HDIIMAGE0.HDS
|
||
|
||
SEE ALSO
|
||
rascsi(1), scsimon(1), rasdump(1), sasidump(1)
|
||
|
||
Full documentation is available at:
|
||
<https://www.github.com/akuker/RASCSI/wiki/>
|
||
|
||
rascsi(1)
|