vtlcmd(1)

🦋 vtlcmd(1): the user-space group chat for your virtual tape daemons 🦋

okay so this is the vtlcmd(1) manual page, a User Commands situation, and it's literally your user space utility for sending commands to vtltape(1), vtllibrary(1), and daemons. bestie, it's giving "direct line to the vibes" 💖

✨ NAME ✨

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

🌈 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 🎀

lowkey the whole menu, no cap:

• 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. The 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. honest icon behavior, not me crying 💀

📬 REPORTING BUGS 📬

Report bugs to markh794@gmail.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), mktape(1), vtllibrary(1), vtltape(1) ⭐

💖 That's the whole vtlcmd(1) manual, bestie — brought to you by mhvtl version 1.72_release+6.a11b6777660..., dated May 2025. mwah 💅