Skip Headers
Oracle® Secure Backup Reference
Release 10.1

Part Number B14236-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

lsdev

Purpose

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

See Also:

"Device Commands" for related commands

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