inquire man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]


INQUIRE(8)							    INQUIRE(8)

NAME
       inquire - list devices available

SYNOPSIS
       inquire [ -a b.t.l ] [ -cl ] [ -N NDMPhost ] [ -s ] [ -T [ -t ] ]

DESCRIPTION
       The  inquire program lists SCSI devices available.  The inquire program
       returns INQUIRY data either for the named  SCSI	device	(with  the  -a
       option), or for all SCSI devices attached to the system. In addition to
       the standard SCSI inquiry  data,	 inquire  now  returns	serial	number
       information  obtained from the Vital Product Data (VPD) pages supported
       by the devices that are being queried.  There may be anywhere from zero
       to  eight  different identifiers for each device, depending on which of
       the VPD pages that particular device supports.

       Starting with NetWorker 7.2.1 and above, the support of LUS was discon‐
       tinued  for  Solaris  10 and above.  This means that after installation
       'inquire' might not necessarily show any devices meant to  be  used  by
       NetWorker. If this is the case, the Solaris Server might not be config‐
       ured correctly.

       A quick check is to run 'cfgadm -lav' to see what is  listed.   Looking
       at  the	'cfgadm'  output and if the devices are listed, make sure that
       the '/dev/rmt' path is used for the
	devices. This is the preferred NetWorker path and it is created	 auto‐
       matically  by  the Solaris 'st' driver.	If the devices are not listed;
       please refer to the NetWorker Administration Guide, SUN	Administration
       Guide and Manufacturer's Manual.

       Sample output including serial number information:

     scsidev@0.0.0:SEAGATE ST34371W SUN4.2G7462|Disk, /dev/rdsk/c0t0d0s2
		    S/N: JDY217500LUW5N
     scsidev@0.1.0:QUANTUM ATLAS IV 36 SCA 0B0B|Disk, /dev/rdsk/c0t1d0s2
		    S/N: 363009430963
		    ATNN:QUANTUM 363009430963
     scsidev@0.6.0:TOSHIBA XM5701TASUN12XCD2395|CD-ROM, /dev/rdsk/c0t6d0s2
     scsidev@4.0.0:SONY	   TSL-11000	   L1  |Tape, /dev/rmt/0cbn
		    S/N: 0001100158
		    ATNN:SONY	 TSL-11000	 0001100158
     scsidev@4.0.1:SONY	   TSL-11000	   L1  |Autochanger (Jukebox)
		    S/N: 3761633968
		    ATNN:SONY	 TSL-11000	 3761633968
     scsidev@4.2.0:IBM	   ULTRIUM-TD1	   0CE0|Tape
		    S/N: 6811004028
		    ATNN:IBM	 ULTRIUM-TD1	 6811004028
     scsidev@4.3.0:HP	   Ultrium 1-SCSI  N16D|Tape, /dev/rmt/1cbn
		    S/N: GB81A00316
		    ATNN:HP	 Ultrium 1-SCSI	 GB81A00316
     scsidev@4.4.0:IBM	   ULTRIUM-TD1	   0CE0|Tape
		    S/N: 6811003960
		    ATNN:IBM	 ULTRIUM-TD1	 6811003960
     scsidev@4.5.0:EXABYTE Exabyte 221L	   2.4 |Autochanger (Jukebox)
		    S/N: 99999999

	      Lines starting with S/N: represent the device's serial number as
	      returned by VPD page 80 hex.

	      Lines that start with a four character prefix plus a  colon  are
	      those  returned  in  SCSI-3 format on VPD page 83 hex.  The four
	      character prefix tells which of the various SCSI-3 Device	 Iden‐
	      tifiers it represents.
	  ATNN: ASCII Text identifier of unspecified format
		describing  the device itself (usually Vendor, Product, Serial
		number)
	  ATPN: ASCII Text identifier of unspecified format
		describing the port that  you  are  connected  to  the	device
		through (not commonly used)
	  VENN: An ASCII vendor specific identifier of unknown
		uniqueness describing the device itself
	  VEPN: An ASCII vendor specific identifier of unknown
		uniqueness describing the port you are connected through
	  VBNN: A binary vendor specific identifier of unknown
		uniqueness describing the device itself
	  VBPN: A binary vendor specific identifier of unknown
		uniqueness describing the port you are connected through
	  IENN: An IEEE 64-bit identifier (EUI-64) describing
		the device itself (shown in hexadecimal format)
	  IEPN: An IEEE 64-bit identifier (EUI-64) describing
		the  port you are connected through (shown in hexadecimal for‐
		mat)
	  WWNN: A Fibrechannel identifier (World Wide Node Name)
		describing the device itself  (shown in hexadecimal format)
	  WWPN: A Fibrechannel identifier (World Wide Port Name)
		describing the port you are connected through (shown in	 hexa‐
		decimal format)
	  PORT: The relative port number that you are connected
		through.  Port "A" would return a value of 1, Port "B" a value
		of 2...
	  RESV: The device returned a combination of Association
		and Identifier Type bits that was reserved at  the  time  this
		code was written.
	  UNKN: The device returned information that this program
		was unable to decipher

OPTIONS
       -a b.t.l
	      Selects  a specific ordinal SCSI address, where b is the logical
	      SCSI bus, t is the SCSI target, and l is the SCSI	 logical  unit
	      number  (LUN)  on that target. The option is not compatible with
	      -N. See libscsi(8).

       -c     (NOTE: USE WITH CAUTION)	This  flag  directly  sends  the  SCSI
	      inquiry  command	to  the device and may cause unforeseen errors
	      when there is other activity on the bus.

       -l     Performs a complete LUN search for all SCSI adapters in the sys‐
	      tem.   This  argument  is	 accepted on all systems, but does not
	      have any effect on HP-UX systems because the method used to scan
	      for  available devices on HP-UX systems always shows  all acces‐
	      sible devices.  For  systems other than HP-UX, the normal behav‐
	      ior  is  to start checking at LUN 0 for SCSI devices.  The first
	      empty LUN found will end the search for a given target ID.  With
	      the  -l  option, all LUNs present on all target IDs for all SCSI
	      busses in the system will be checked for devices.	 This can take
	      a	 very  long time and should therefore only be used when neces‐
	      sary.  For example, a Fibre Channel adapter can support 126 tar‐
	      get  IDs,	 each of which may have 80 or more LUNs.  Checking all
	      LUNs on this single adapter may  take  over  10  minutes.	  This
	      option has no affect when -N present.

       -N NDMPhost
	      Performs a device discovery on the NDMP Tape Server NDMPhost.
	       User will be prompted for the NDMP user name and password. NDMP
	      protocol exports only  Jukeboxes	and  Tape  Devices.  No	 other
	      device  types  will be discovered. When NDMP Tape Server is run‐
	      ning  at	version	  3   or   higher   and	  supports   NDMP_CON‐
	      FIG_GET_SCSI_INFO	  and	NDMP_CONFIG_GET_TAPE_INFO  interfaces,
	      inquire will display the INQUIRY	data  for  all	the  available
	      Jukeboxes	 and  Tape  Devices.  In all other cases, inquire will
	      prompt for Jukebox handle and get	 the  INQUIRY  data  for  that
	      Jukebox.	This option is not compatible with -a. See -T for more
	      details.

	      Sample output with NDMP Tape Server running at V3 and supporting
	      of SCSI and TAPE CONFIG interfaces:

	       # inquire -N server-2
	       Enter NDMP user name: ? ndmp
	       Enter 'ndmp' password on NDMP host 'server-2' (characters will not be echoed):

	       Communicating to devices on NDMP Server 'server-2', this may take a while...

	       scsidev@178.0.0:QUALSTARTLS-6110	       2.09|Autochanger (Jukebox), c178t0l0
						       S/N: 44B43014
	       scsidev@178.0.1:QUANTUM DLT8000	       0119|Tape, c178t0l1
						       S/N: CX938P2489
						       IENN:0000000000000000

	      Sample output with NDMP Tape Server running at V2:

	       # inquire -N molokai
	       Enter NDMP user name: ? root
	       Enter 'root' password on NDMP host 'molokai' (characters will not be echoed):

	       Communicating to devices on NDMP Server 'molokai', this may take a while...

	       NDMP Tape Server 'molokai' does not support of auto-discovery of SCSI and TAPE Devices.
	       Will perform the operation on a single Jukebox in which you are interested.

	       Enter NDMP Jukebox handle: ? mc1

	       scsidev@-1.2.0:EXABYTE Exabyte 215     2.3 |Autochanger (Jukebox)
							  S/N: 71000073

       -s     Suppresses  the  collection  of  serial  number  information  by
	      inquire, so that inquire returns the same	 output	 that  it  did
	      before  the serial number information was added.	This option is
	      primarily added so that any scripts that rely  on	 the  previous
	      output behavior of inquire can be used with only minor modifica‐
	      tion.

       -T     This option is only valid when -N is present else it is ignored.
	      The  option will display the NDMP Tape Devices in a non standard
	      format. The Device Model and Device Handle(s) will be displayed.
	      This  option  is useful on NDMP Tape Servers that do not support
	      NDMP_SCSI_OPEN interface on Tape Devices (For example, NetApp).

	      Sample output with -T option on NetApp Filer.

	       # inquire -N  molokai -T
	       Enter NDMP user name: ? root
	       Enter 'root' password on NDMP host 'molokai' (characters will not be echoed):

	       Communicating to devices on NDMP Server 'molokai', this may take a while...

	       scsidev@0.2.0:EXABYTE Exabyte 215     2.3 |Autochanger (Jukebox), mc1
							  S/N: 71000073
	       scsidev@0.3.0:QUANTUM Powerstor L200  0022|Autochanger (Jukebox), mc0
							  S/N: JF83801878

	       Model			   Device Handle
	       -----			   -------------

	       Quantum DLT7000		   nrst0l
					   nrst0m
					   nrst0h
					   nrst0a

	       Exabyte Mammoth-2 8mm	   nrst2l
					   nrst2m
					   nrst2h
					   nrst2a

       -t     This option is only valid when -T is present else it is ignored.
	      The  option  will	 display the vendor specific NDMP Tape Devices
	      Attributes for each tape device handles that are displayed  with
	      option -T.

	      Sample output with -t option on NetApp Filer.

	       # inquire -N rainbow -T -t
	       Enter NDMP user name: ? root
	       Enter 'root' password on NDMP host 'molokai' (characters will not be echoed):

	       Communicating to devices on NDMP Server 'molokai', this may take a while...

	       scsidev@0.3.0:QUANTUM Powerstor L200  0022|Autochanger (Jukebox), mc0
							  S/N: JF83801878

	       Model		Device Handle	 Attributes
	       -----		-------------	 ---------

	       Quantum DLT7000	nrst0l		  DENSITY		--  81633 bpi 40 GB (w/comp)
						  ELECTRICAL_NAME	--  0b.4
						  SERIAL_NUMBER		--  CX902S0678
						  WORLD_WIDE_NAME	--
						  ALIAS 0		--  st0

				nrst0m		  DENSITY		--  85937 bpi 35 GB
						  ELECTRICAL_NAME	--  0b.4
						  SERIAL_NUMBER		--  CX902S0678
						  WORLD_WIDE_NAME	--
						  ALIAS 0		--  st0

				nrst0h		  DENSITY		--  85937 bpi 50 GB (w/comp)
						  ELECTRICAL_NAME	--  0b.4
						  SERIAL_NUMBER		--  CX902S0678
						  WORLD_WIDE_NAME	--
						  ALIAS 0		--  st0

				nrst0a		  DENSITY		--  85937 bpi 70 GB (w/comp)
						  ELECTRICAL_NAME	--  0b.4
						  SERIAL_NUMBER		--  CX902S0678
						  WORLD_WIDE_NAME	--
						  ALIAS 0		--  st0

SEE ALSO
       libscsi(8)

LIMITATIONS
       The  inquire  program  always  uses the built-in system drivers to test
       SCSI devices.  The device type or path name printed by the inquire pro‐
       gram  may  be  incorrect	 for devices that require special, third-party
       drivers.

NetWorker 7.3.2			  Aug 23, 06			    INQUIRE(8)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net