User Commands

NAME¶

vtlcmd - user space utility to send commands to vtltape(1), vtllibrary(1), daemons.

SYNOPSIS¶

vtlcmd 'Q number' [ -h ] [ command ] ...

DESCRIPTION¶

Where 'Q number' is the message queue number for the drive (see vtltape(1) )

-h: display this help and exit

COMMAND¶

verbose: Toggle verbose flag. This will cycle verbose flag thru verbose settings 3 2 1 off
load <ID>: Load media ID (barcode) - Used for stand-alone tape drive daemon.
unload <ID>: Unload media ID (barcode)
compression <ZLIB|LZO>: Changes compression libraries used to compress each block of data. Valid for tape only.
delay load x: Sets a delay for loading media to x seconds. Valid values 0 - 20. ssc target returns <02/04/01> 'NOT READY/BECOMMING READY' status in response to any 'Test Unit Ready' requested until timer expires. Valid for tape only.
delay unload x: Sets a delay for unloading media to x seconds. Valid values 0 - 20. Valid for tape only.
delay rewind x: Sets a delay for rewinding media to x seconds. Valid values 0 - 30. Valid for tape only.
delay position x: Sets a delay for positioning media to x seconds. Valid values 0 - 20. Valid for tape only.
delay thread x: Sets a delay for ´threading´ media to x seconds. Valid values 0 - 20. Valid for tape only.
TapeAlert <alert flag>: Send a 64bit hex number, each bit corresponds to one TapeAlert flag as defined by t10.org. Where bit 0 is TapeAlert flag 1, and bit 63 is TapeAlert flag 64.
exit: Send a terminate message to daemon.
online: Valid for library only. Place library in 'online' mode.
offline: Valid for library only. Take library 'offline'.
add slot: Valid for library only. This will dynamically add an additional storage slot to the library. This is not persistent.
list map: Valid for library only. Returns a list of media IDs in Media Access Port (MAP).
open map: Valid for library only. Logically 'opens' the Media Access Port (MAP).
close map: Valid for library only. Logically 'closes' the Media Access Port (MAP). MAP needs to be 'closed' before the Medium Transport Element can move media to/from MAP.
empty map: Valid for library only. Clears media from Media Access Port (MAP). Only valid when MAP is in 'open' state
load map <media>: Valid for library only. Places <media> logically into the Media Access Port (MAP). Note: <media> needs to exist first, otherwise the command fails with suggestion to create media first. see mktape(1) for creating media.

AUTHOR¶

Written by Mark Harvey

BUGS¶

Needs to be made user friendly.

REPORTING BUGS¶

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