scan|scanj

Edit online

scan command scans the system for connected tape and changer devices, and displays the list of connected devices. For each detected device following information will be reported. scanj command is similar to scan command but generates the output in JSON format.
  • Special file name
  • Vendor ID
  • Firmware version
  • Serial-number
  • SCSI bus address
  • Associated changer
  • Device driver name
Parameters:
[-force-generic-dd]
[-o formatstring]
[-start=device] 
[-end=device]
[-exclude=device]
[-showallpaths]
Following is an example of an output from scan command:
[root@franc ITDT]# ./itdt scan
Scanning SCSI Bus ...
#0 /dev/IBMtape7n - [03592E07]-[3C84] S/N:000013D00123 H4-B0-T8-L0  (IBM-Device)
#1 /dev/IBMtape6n - [03592E07]-[3C84] S/N:000013D00123 H4-B0-T7-L0  (IBM-Device)
#2 /dev/IBMtape5n - [03592E05]-[1F05] S/N:000001365271 H4-B0-T6-L0  (IBM-Device)
Exit with code: 0
Following is an example of an output from scanj command:
[root@franc ITDT]# ./itdt scanj
[
  {
    "index": 0 ,
    "driverName": "/dev/IBMtape7n" ,
    "modelName": "03592E07" ,
    "firmwareVersion": "3C84" ,
    "serialNumber": "000013D00123" ,
    "hostAdapterId": 4 ,
    "busNumber": 0 ,
    "targetId": 8 ,
    "lunId": 0 ,
    "deviceSpecialFile": "IBM"
  },
  {
    "index": 1 ,
    "driverName": "/dev/IBMtape6n" ,
    "modelName": "03592E07" ,
    "firmwareVersion": "3C84" ,
    "serialNumber": "000013D00123" ,
    "hostAdapterId": 4 ,
    "busNumber": 0 ,
    "targetId": 7 ,
    "lunId": 0 ,
    "deviceSpecialFile": "IBM"
  },
  {
    "index": 2 ,
    "driverName": "/dev/IBMtape5n" ,
    "modelName": "03592E05" ,
    "firmwareVersion": "1F05" ,
    "serialNumber": "000001365271" ,
    "hostAdapterId": 4 ,
    "busNumber": 0 ,
    "targetId": 6 ,
    "lunId": 0 ,
    "deviceSpecialFile": "IBM"
  }}

By using the optional parameter -force-generic-dd, the usage of the generic Operating System driver (not with the IBM® Tape Device Driver) is forced.

With the parameters -start, -end, and -exclude, the scan can be limited to only a particular HBA or target ID range (partial scan). It starts at -start=device to search for supported devices until -end=device is reached. Devices that are specified with -exclude are skipped during the scan. Multiple excluded devices must be separated by colons. Supported formats are devicename and H B T L.

The format string controls the output and specifies how the connected devices must be reported. It can include any alphanumeric character. The default format string is “"#%# %D - [%P]-[%F] S/N:%S H%H-B%B-T%T-L%L".

The following list contains all the interpreted identifiers: 
%D device name
%V vendor name
%P product name
%F firmware version
%S serial number
%H host adapter
%B bus number
%T target id
%L logical unit
%h host adapter as hexadecimal value
%b bus number as hexadecimal value
%t target id as hexadecimal value
%l logical unit as hexadecimal value
%I interface type
%# enumeration number
%C serial number of associated changer device
Any combination of the identifiers that are listed here are supported.

An integer that is placed between a % sign and the format command acts as a minimum field width specifier. A negative value uses right text alignment.

Following is an example of scan command with format string: 
./itdt scan -o "%-2#. %-18S %-12P %F %I"
Scanning SCSI Bus ...
 0.         1310115166  ULT3580-TD4 97F2 Fibre
 1.         1310034311  ULT3580-TD4 A232 Fibre
 2.         1168001104  ULT3580-TD5 B170 Fibre
 3.   00L4U78D6118_LL0      3573-TL 9.20 N/A
 4.   00L2U78G8705_LL0      3573-TL 9.20 N/A
 5.       000001327208     03592E06 26CA Fibre
 6.         cigen22164  ULT3580-TD2 73V1 Fibre
 7.       000001365271     03592E05 1DD1 Fibre


Exit with code: 0

The option -showallpaths forces ITDT to display all available data paths that are detected during the device scan. The default device serial number-based filtering is not performed.

Supported platforms: All