NAME¶

device.conf - Configuration file for vtllibrary(1) and vtltape(1)

DESCRIPTION¶

Each configured device contains a unique entry in device.conf

Each section starts at column 1 and is terminated by a blank line.

e.g.

Library: 10 CHANNEL: 00 TARGET: 00 LUN: 00
Vendor identification: SPECTRA
Product identification: PYTHON
Product revision level: 550V
Unit serial number: XYZZY_A
NAA: 10:22:33:44:ab:00:00:00
Home directory: /var/lib/mhvtl/Spectra
fifo: /var/tmp/mhvtl
PERSIST: True

Where descriptor Library: or Drive: starts each section The descriptor is followed by a unique ID (a decimal number)

On the same line following the descriptor is the SCSI corrordinates for the device described.

Vendor identification, Product identification, Product revision level and Unit serial number are common fields across all device types.

NAA field is used by some backup software (e.g. Legato) as means to uniquely identify devices. It is used by INQUIRY VPD page 0x83. Most software uses the Unit serial number as the unique identifier.

Compression: factor X enabled Y

Where

X is 1 through 9.

1 is fastest compression, 9 is best compression.

Y

1: compression is enabled, 0: compression is disabled.

Compression type: zlib or lzo

Backoff: Value between 10 and 10000. Default is 1000. This value is added to existing 'usleep' time in between ioctl polls. If there is work to do, the usleep time is reset to 10.

Home directory: /some/where/with/space

Specify a parent directory for the virtual media associated with this library. Only in valid ^Library: entries (not for ^Tape: entries)

fifo: /some/where/for/named/pipe

If fifo: is defined, (near) real time state information will be available for external applications by reading from this named pipe.

Note: the '-f fifo' switch on daemon startup has higher precedence

PERSIST: True | False If PERSIST is set to 'Yes' or 'True' - enable saving state on shutdown. A file 'library_contents.XX.persist' will be created on shutdown to save persistent state. On startup - Default to read the library_contents.XX.persist if the file exists. Fall back to library_contents.XX if no .persist file exists.

AUTHOR¶

Written by Mark Harvey

BUGS¶

REPORTING BUGS¶

Report bugs to <markh794@gmail.com> <mark.harvey@nutanix.com>.

COPYRIGHT¶

Copyright © 2005 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO¶

library_contents(5) make_vtl_media(1), mktape(1), vtlcmd(1), vtllibrary(1), vtltape(1)