scsiscan(1M) — ADMINISTRATOR COMMANDS
NAME
scsiscan − SCSI bus scanner
SYNOPSIS
scsiscan [−c] [−h] [−p delimiter]
[−A device-name] [−D device-name]
[−s [−o scan-options]]
DESCRIPTION
scsiscan is used to scan Small Computer System Interface (SCSI) buses connected to the system via Motorola supported host adapters. Two functions are provided: a reporting mechanism, which outputs information about the devices or controllers known to be attached to the system, and the scanner, which is used to explicitly scan a bus or buses, possibly locating devices which were attached or powered on after the system was booted.
If the −c option is used, the host adapter name, board number, board revision string, and firmware revision strings will be printed. If omitted, the generic device description, device identifier, online/offline status, vendor ID, product ID, revision number, and SCSI version number will be printed. The vendor ID, product ID, revision number, and SCSI version number information is derived from the SCSI inquiry data.
If the −h option is used, the table header will not be printed.
If the −p option is used, the information will be output one device per line with the fields separated by the specified single character delimiter. If omitted, the output will be in tabular form.
The -s option specifies that a SCSI bus scan is requested. If not qualified by the -o option all SCSI buses on all SCSI host adapters will be scanned using the unknown strategy described below.
The -o option specifies optional control information for SCSI scanning. The options are specified as comma separated strings in the form of keyword=value. The valid keywords are: device, which may be used to specify the specific SCSI hardware to limit the scan to, board, which further limits the scan to a specific board number, and strategy, which specifies how the scan should be conducted. The valid strategies are: exist, which will scan only those devices that the SCSI software believes exist, unknown, which will scan only those devices that the SCSI software believes to not exist and is the default strategy, and all, which will scan every possible device.
The −A (activate) option specifies that the specified device is to brought online.
The −D (deactivate) option specifies that the specified device is to brought offline. Only devices that are not currently opened may be brought offline.
NOTE
Since scsiscan may cause SCSI inquiry commands to be issued to devices the system believes exist, it is possible that the command may take a long period of time to complete (possibly hours). This will happen whenever a SCSI inquiry command must wait for an already busy SCSI device to complete the lengthy command it is executing (e.g. tapes rewinding, disks formatting).
Scanning SCSI buses is a very I/O intensive procedure. Depending on the system configuration, the system may appear to run slowly for the duration of this procedure. No device nodes are created by scanning.
The SCSI1X7 (MVME187, MVME197) driver cannot support scanning (−s) if the SCSI chip on the board is not revision D or later.
EXAMPLE
scsiscan -s -o device=MVME328,strategy=unknown
This command will scan for devices that are not known to currently exist on all MVME328 SCSI host adapters.