---
name: "scsieject"
section: "1"
platform: "linux"
package: "mtx"
version: "1.3.12-18"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/scsieject"
---

# scsieject(1)

control SCSI tape devices

## NAME

scsieject - control SCSI tape devices

## SYNOPSIS

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

## DESCRIPTION

The **scsieject** command controls SCSI devices in a platform-independent manner. As long as 'mtx' works on the platform, so does 'scsieject'.

## OPTIONS

The first argument, given following **-f** , is the SCSI generic device corresponding to your tape drive. Consult your operating system's documentation for more information (for example, under Linux these are generally /dev/sg0 through /dev/sgXX, 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). You can set the STAPE or TAPE environment variable rather than use -f.

## 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.

- **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.

- **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.

## HINTS

Under Linux, **lsscsi --generic** will tell you what SCSI devices you have and their device names.

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.

## BUGS AND LIMITATIONS

There are no known bugs or limitations.

## 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.

## SEE ALSO

[**loaderinfo**(1)](/loaderinfo/1.md),[**tapeinfo**(1)](/tapeinfo/1.md),[**mtx**(1)](/mtx/1.md)