scsieject(1)

📦
version 1.3.12 · 2 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, centos-stream 10, centos-stream 9, debian bookworm, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu jammy

💖 scsieject — bestie edition 💖

okay so this is scsieject(1), a General Commands Manual page, and it's literally the tool you want when you need to boss your SCSI tape devices around. no cap. 🎀

✨ NAME ✨

scsieject — control SCSI tape devices 🦋

🌸 SYNOPSIS 🌸

scsieject [-f <scsi-generic-device>] commands

💅 DESCRIPTION 💅

so like, the scsieject command controls SCSI devices in a platform-independent manner. and the way that works is: as long as mtx works on your platform, so does scsieject. that's it, that's the vibe. 🫶

👑 OPTIONS 👑

the first argument, given following -f, is the SCSI generic device corresponding to your tape drive. please consult your operating system's documentation for more info, bestie, because it's giving "depends on your OS":

  • under Linux these are generally /dev/sg0 through /dev/sg15
  • under FreeBSD these are /dev/pass0 through /dev/passX
  • under Solaris this is usually the same as your tape drive (Solaris has a SCSI passthrough ioctl)

and listen — you can set the STAPE or TAPE environment variable rather than use -f. iconic. ✨

🔥 COMMANDS 🔥

  • load — load the medium into the drive. when this command is issued to a CD/DVD drive and the tray is extended, the tray will be retracted if the drive is capable of it. it's giving "come back here" 😭
  • unload — unload the medium from the drive (also known as eject). when this command is issued to a CD/DVD drive or a tape drive, the media will be ejected if the device supports it. bye bestie 👋
  • start — start the device. some devices require a start command after a media changer has loaded new media into the device.
  • stop — stop the device. some devices require a stop command prior to unloading the medium from the device when using a media changer.
  • lock — lock the device. locks the device so that the medium cannot be removed manually. 🔒
  • unlock — unlock the device. unlocks the device so that the medium can be removed manually. 🔓

🫶 AUTHORS 🫶

this program was written by Robert Nelson <robertnelson@users.sourceforge.net>, based on the scsitape program written by Eric Lee Green <eric@badtux.org>. major portions of the mtxl.c library used herein were written by Leonard Zubkoff. absolute legends, every single one. 👑

🌈 HINTS 🌈

under Linux, cat /proc/scsi/scsi will tell you what SCSI devices you have. you can then refer to them as /dev/sga, /dev/sgb, etc. by the order they are reported. so organized of them fr fr.

under FreeBSD, camcontrol devlist will tell you what SCSI devices you have, along with which pass device controls them. 💖

under Solaris 7 and 8, /usr/sbin/devfsadm -C will clean up your /devices directory. then find /devices -name 'st@*' -print will return a list of all tape drives. /dev on Solaris is apparently only of historical interest. 💀 iykyk.

💀 BUGS AND LIMITATIONS 💀

there are no known bugs or limitations. not me being suspiciously flawless 😌✨

⭐ AVAILABILITY ⭐

this version of scsieject is currently being maintained by Robert Nelson <robertnelson@users.sourceforge.net> as part of the mtx suite of programs. the mtx home page is http://mtx.sourceforge.net and the actual code is currently available there and via SVN from http://sourceforge.net/projects/mtx. go get it bestie 🧚

🎀 SEE ALSO 🎀

loaderinfo(1),tapeinfo(1),mtx(1)

and that's the whole page, no notes 💖 this was scsieject1.0, straight out of the General Commands Manual, and it lives right alongside its besties in the mtx suite. slay, bye! 💅🌸
📦 where this page comes from