lsdev

Purpose

Use the lsdev command to list the names and attributes of one or more configured devices.

See Also:

Prerequisites

You must have the display administrative domain's configuration right to use the lsdev command.

Syntax

lsdev::=

lsd•ev [ --long/-l | --short/-s ] [ --inservice/-o | --notinservice/-O ]
[ --reservations/-v | --mount/-m | --description/-d | --borrowed/-b ]
[ --nocomm/-N ] [ --reserved/-r [ --me/-e ] ] [ --nohierarchy/-H ]
[ --notype/-T ] [ --geometry/-g ] [ --verbose/-V ] 
[ --attach/-a aspec ] [ --type/-t { tape | library } ]
devicename ...

Semantics

--long/-l: Displays data in long form. The command displays the attributes of each device and labels them. Refer to Example 2-55 for sample output. By default the command displays the device name, type, and status.
--short/-s: Displays data in short form. The command prints the name of each device on a separate line.
--inservice/-o: Displays a list of devices that are logically available to Oracle Secure Backup.
--notinservice/-O: Displays a list of devices that are not logically available to Oracle Secure Backup.
--reservations/-v: Display device reservation data, for example, the name of reserving component, and so forth. You can use the resdev command to reserve a device and the unresdev to unreserve a device.
--mount/-m: Displays a list of devices with their mount status.
--description/-d: Displays a list of devices with detailed descriptions. For any device missing a description, execute the pingdev devicename command to create one.
--borrowed/-b: Displays a list of devices with their borrowed status.
--nocomm/-N: Suppresses communication with the device.
--reserved/-r: Lists only those devices that are currently reserved.
--me/-e: Displays devices that are reserved for the logged-in user. Use with the --reserved option.
--nohierarchy/-H: For a library, suppresses the display of the tape drives contained in the library. By default, display of a library also displays the contained drives.
--notype/-T: Displays a list of devices without specifying the type (tape drive or library).
--geometry/-g: Displays the geometry and other characteristics of a tape library.
--verbose/-V: Produces verbose output (default). For each device obtool displays the device type, name, and status.
--attach/-a aspec: Displays the device with the specified attachment. Refer to "aspec" for a description of the aspec placeholder.
--type/-t tape | library: Displays the specified type of device: tape or library.
devicename ...: Specifies the name of the device for which you want to view attribute data. Refer to "devicename" for the rules governing device names.

Output

Table 2-8 shows the output for the lsdev command.

Table 2-8 lsdev Output

Label	Indicates
Device type	Type of device; setting is `tape drive` or `library`
Model	Manufacturer model, if available
Serial number	Manufacturer serial number, if available
In service	Device eligibility for use; setting is `yes` or `no`
Debug mode	Assists in troubleshooting problems; setting is `yes` or `no`
Barcode reader	Setting is `yes`, `no`, or `default`
Barcodes required	Setting is `yes` or `no`; if `yes`, tapes must be barcoded to run a backup job
Auto clean	Automatically clean the tape drive heads; setting is `yes` or `no`; configured separately
Clean interval	Amount of time between cleaning
Clean using emptiest	Use cleaning tape with the most remaining cleanings available; setting is `yes` or `no`
Unload required	Setting is `yes` or `no`
UUID	Universal Unique Identifier (UUID) for the hardware
Attachment #	Starts at `1` and increments for multiple tape drives or libraries
Host	Host name of the media server
Raw device	Device-specific file name: `/dev/rbl#` for a tape library and `/dev/rbt#` for a tape drive
Library	User-assigned Oracle Secure Backup name for the tape library
DTE	Number of the tape drive in the library
Automount	Automatically mounts the tape device; setting is `yes` or `no`
Error rate	Maximum number of errors for each tape before backup job fails
Query frequency	Hardware default
Blocking factor	Set to the default optimum value of 128 bytes; this value should not be changed arbitrarily since, if you choose a value higher than what is supported by the operating system of the server, Oracle Secure Backup aborts with an error
Max blocking factor	Set at optimum value by Oracle Secure Backup; Oracle recommends you do not change these values
Current tape	Original storage element of the tape currently in the DTE in addition to other information about the tape
Use list	Tapes residing in storage elements assigned for this drive to use
Drive usage	Amount of time since first use or since last cleaning
Cleaning required	Tape drive cleaning is required; setting is `yes` or `no`

Example

Example 2-55 lists detail for a tape library named filer_ethel_mc3.

Example 2-55 Listing Details for a Library

ob> lsdev --long filer_ethel_mc3
filer_ethel_mc3:
    Device type:            library
    Model:                  ATL
    In service:             yes
    Debug mode:             no
    Barcode reader:         default (hardware-selected)
    Barcodes required:      no
    Auto clean:             no
    Clean interval:         (not set)
    Clean using emptiest:   no
    Unload required:        yes
    UUID:                   8249461c-585c-1027-85c6-000103e0a9fc
    Attachment 1:
        Host:               filer_ethel
        Raw device:         mc3
filer_ethel_nrst7a:
    Device type:            tape
    Model:                  Quantum
    In service:             yes
    Library:                filer_ethel_mc3
    DTE:                    1
    Automount:              yes
    Error rate:             8
    Query frequency:        3003895KB (-1218978408 bytes) (from driver)
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    Current tape:           1
    Use list:               all
    Drive usage:            none
    Cleaning required:      no
    UUID:                   82665aa4-585c-1027-85c6-000103e0a9fc
    Attachment 1:
        Host:               filer_ethel
        Raw device:         nrst7a
filer_ethel_nrst8a:
    Device type:            tape
    Model:                  Quantum
    In service:             yes
    Library:                filer_ethel_mc3
    DTE:                    2
    Automount:              yes
    Query frequency:        3003895KB (-1218978408 bytes) (from driver)
    Debug mode:             no
    Blocking factor:        (default)
    Max blocking factor:    (default)
    Current tape:           [unknown]
    Use list:               all
    Drive usage:            [not set]
    Cleaning required:      [unknown]
    UUID:                   82667cdc-585c-1027-85c6-000103e0a9fc
    Attachment 1:
        Host:               filer_ethel
        Raw device:         nrst8a