474 lines
11 KiB
HTML
474 lines
11 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of EJECT</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>EJECT</H1>
|
|
Section: User Commands (1)<BR>Updated: 12 May 2005<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
eject - eject removable media
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
eject -h
|
|
<BR>
|
|
|
|
eject [-vnrsfmqp] [<name>]
|
|
<BR>
|
|
|
|
eject [-vn] -d
|
|
<BR>
|
|
|
|
eject [-vn] -a on|off|1|0 [<name>]
|
|
<BR>
|
|
|
|
eject [-vn] -c slot [<name>]
|
|
<BR>
|
|
|
|
eject [-vn] -i on|off|1|0 [<name>]
|
|
<BR>
|
|
|
|
eject [-vn] -t [<name>]
|
|
<BR>
|
|
|
|
eject [-vn] -T [<name>]
|
|
<BR>
|
|
|
|
eject [-vn] -x <speed> [<name>]
|
|
<BR>
|
|
|
|
eject [-vn] -X [<name>]
|
|
<BR>
|
|
|
|
eject -V
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
<B>Eject</B>
|
|
|
|
allows removable media (typically a CD-ROM, floppy disk, tape, or JAZ
|
|
or ZIP disk) to be ejected under software control. The command can
|
|
also control some multi-disc CD-ROM changers, the auto-eject feature
|
|
supported by some devices, and close the disc tray of some CD-ROM
|
|
drives.
|
|
<P>
|
|
The device corresponding to <name> is ejected. The name can be a
|
|
device file or mount point, either a full path or with the leading
|
|
"/dev", "/media" or "/mnt" omitted. If no name is specified, the default name
|
|
"cdrom" is used.
|
|
<P>
|
|
There are four different methods of ejecting, depending on whether the
|
|
device is a CD-ROM, SCSI device, removable floppy, or tape. By default
|
|
eject tries all four methods in order until it succeeds.
|
|
<P>
|
|
If the device is currently mounted, it is unmounted before ejecting.
|
|
<P>
|
|
<P>
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>COMMAND-LINE OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-h</B>
|
|
|
|
<DD>
|
|
This option causes
|
|
<B>eject</B>
|
|
|
|
to display a brief description of the command options.
|
|
<P>
|
|
<DT id="2"><B>-v</B>
|
|
|
|
<DD>
|
|
This makes
|
|
<B>eject</B>
|
|
|
|
run in verbose mode; more information is displayed about what the
|
|
command is doing.
|
|
<P>
|
|
<DT id="3"><B>-d</B>
|
|
|
|
<DD>
|
|
If invoked with this option,
|
|
<B>eject</B>
|
|
|
|
lists the default device name.
|
|
<P>
|
|
<DT id="4"><B>-a on|1|off|0</B>
|
|
|
|
<DD>
|
|
This option controls the auto-eject mode, supported by some devices.
|
|
When enabled, the drive automatically ejects when the device is
|
|
closed.
|
|
<P>
|
|
<DT id="5"><B>-c <slot></B>
|
|
|
|
<DD>
|
|
With this option a CD slot can be selected from an ATAPI/IDE CD-ROM
|
|
changer. Linux 2.0 or higher is required to use this feature. The
|
|
CD-ROM drive can not be in use (mounted data CD or playing a music CD)
|
|
for a change request to work. Please also note that the first slot of
|
|
the changer is referred to as 0, not 1.
|
|
<P>
|
|
<DT id="6"><B>-i on|1|off|0</B>
|
|
|
|
<DD>
|
|
This option controls locking of the hardware eject button. When
|
|
enabled, the drive will not be ejected when the button is pressed.
|
|
This is useful when you are carrying a laptop in a bag or case and
|
|
don't want it to eject if the button is inadvertently pressed.
|
|
<P>
|
|
<DT id="7"><B>-t</B>
|
|
|
|
<DD>
|
|
With this option the drive is given a CD-ROM tray close command. Not
|
|
all devices support this command.
|
|
<P>
|
|
<DT id="8"><B>-T</B>
|
|
|
|
<DD>
|
|
With this option the drive is given a CD-ROM tray close command if
|
|
it's opened, and a CD-ROM tray eject command if it's closed. Not all
|
|
devices support this command, because it uses the above CD-ROM tray
|
|
close command.
|
|
<P>
|
|
<DT id="9"><B>-x <speed></B>
|
|
|
|
<DD>
|
|
With this option the drive is given a CD-ROM select speed command.
|
|
The speed argument is a number indicating the desired speed (e.g. 8
|
|
for 8X speed), or 0 for maximum data rate. Not all devices support
|
|
this command and you can only specify speeds that the drive is capable
|
|
of. Every time the media is changed this option is cleared. This
|
|
option can be used alone, or with the -t and -c options.
|
|
<P>
|
|
<DT id="10"><B>-X </B>
|
|
|
|
<DD>
|
|
With this option the CD-ROM drive will be probed to detect the
|
|
available speeds. The output is a list of speeds which can be used as
|
|
an argument of the -x option. This only works with Linux 2.6.13 or
|
|
higher, on previous versions solely the maximum speed will be
|
|
reported. Also note that some drive may not correctly report the speed
|
|
and therefore this option does not work with them.
|
|
<P>
|
|
<DT id="11"><B>-n</B>
|
|
|
|
<DD>
|
|
With this option the selected device is displayed but no action is
|
|
performed.
|
|
<P>
|
|
<DT id="12"><B>-r</B>
|
|
|
|
<DD>
|
|
This option specifies that the drive should be ejected using a
|
|
CDROM eject command.
|
|
<P>
|
|
<DT id="13"><B>-s</B>
|
|
|
|
<DD>
|
|
This option specifies that the drive should be ejected using
|
|
SCSI commands.
|
|
<P>
|
|
<DT id="14"><B>-f</B>
|
|
|
|
<DD>
|
|
This option specifies that the drive should be ejected using a
|
|
removable floppy disk eject command.
|
|
<P>
|
|
<DT id="15"><B>-q</B>
|
|
|
|
<DD>
|
|
This option specifies that the drive should be ejected using a
|
|
tape drive offline command.
|
|
<P>
|
|
<DT id="16"><B>-p</B>
|
|
|
|
<DD>
|
|
This option allow you to use /proc/mounts instead /etc/mtab. It
|
|
also passes the -n option to <A HREF="/cgi-bin/man/man2html?1+umount">umount</A>(1).
|
|
<P>
|
|
<DT id="17"><B>-m</B>
|
|
|
|
<DD>
|
|
This option allows eject to work with device drivers which automatically
|
|
mount removable media and therefore must be always <A HREF="/cgi-bin/man/man2html?1+mount">mount</A>(1)ed.
|
|
The option tells eject to not try to unmount the given device,
|
|
even if it is mounted according to /etc/mtab or /proc/mounts.
|
|
<P>
|
|
<DT id="18"><B>-V</B>
|
|
|
|
<DD>
|
|
This option causes
|
|
<B>eject</B>
|
|
|
|
to display the program version and exit.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>LONG OPTIONS</H2>
|
|
|
|
All options have corresponding long names, as listed below. The long
|
|
names can be abbreviated as long as they are unique.
|
|
<P>
|
|
<BR>
|
|
|
|
-h --help
|
|
<BR>
|
|
|
|
-v --verbose
|
|
<BR>
|
|
|
|
-d --default
|
|
<BR>
|
|
|
|
-a --auto
|
|
<BR>
|
|
|
|
-c --changerslot
|
|
<BR>
|
|
|
|
-t --trayclose
|
|
<BR>
|
|
|
|
-T --traytoggle
|
|
<BR>
|
|
|
|
-x --cdspeed
|
|
<BR>
|
|
|
|
-X --listspeed
|
|
<BR>
|
|
|
|
-n --noop
|
|
<BR>
|
|
|
|
-r --cdrom
|
|
<BR>
|
|
|
|
-s --scsi
|
|
<BR>
|
|
|
|
-f --floppy
|
|
<BR>
|
|
|
|
-q --tape
|
|
<BR>
|
|
|
|
-V --version
|
|
<BR>
|
|
|
|
-p --proc
|
|
<BR>
|
|
|
|
-m --no-unmount
|
|
<BR>
|
|
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
<P>
|
|
|
|
Eject the default device:
|
|
<DL COMPACT>
|
|
<DT id="19"><DD>
|
|
eject
|
|
</DL>
|
|
<P>
|
|
|
|
Eject a device or mount point named cdrom:
|
|
<DL COMPACT>
|
|
<DT id="20"><DD>
|
|
eject cdrom
|
|
</DL>
|
|
<P>
|
|
|
|
Eject using device name:
|
|
<DL COMPACT>
|
|
<DT id="21"><DD>
|
|
eject /dev/cdrom
|
|
</DL>
|
|
<P>
|
|
|
|
Eject using mount point:
|
|
<DL COMPACT>
|
|
<DT id="22"><DD>
|
|
eject /mnt/cdrom/
|
|
</DL>
|
|
<P>
|
|
|
|
Eject 4th IDE device:
|
|
<DL COMPACT>
|
|
<DT id="23"><DD>
|
|
eject hdd
|
|
</DL>
|
|
<P>
|
|
|
|
Eject first SCSI device:
|
|
<DL COMPACT>
|
|
<DT id="24"><DD>
|
|
eject sda
|
|
</DL>
|
|
<P>
|
|
|
|
Eject using SCSI partition name (e.g. a ZIP drive):
|
|
<DL COMPACT>
|
|
<DT id="25"><DD>
|
|
eject sda4
|
|
</DL>
|
|
<P>
|
|
|
|
Select 5th disc on multi-disc changer:
|
|
<DL COMPACT>
|
|
<DT id="26"><DD>
|
|
eject -v -c4 /dev/cdrom
|
|
</DL>
|
|
<P>
|
|
|
|
Turn on auto-eject on a SoundBlaster CD-ROM drive:
|
|
<DL COMPACT>
|
|
<DT id="27"><DD>
|
|
eject -a on /dev/sbpcd
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>EXIT STATUS</H2>
|
|
|
|
<P>
|
|
|
|
<P>
|
|
Returns 0 if operation was successful, 1 if operation failed or command
|
|
syntax was not valid.
|
|
<P>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>NOTES</H2>
|
|
|
|
<P>
|
|
|
|
<P>
|
|
<B>Eject</B>
|
|
|
|
only works with devices that support one or more of the four methods
|
|
of ejecting. This includes most CD-ROM drives (IDE, SCSI, and
|
|
proprietary), some SCSI tape drives, JAZ drives, ZIP drives (parallel
|
|
port, SCSI, and IDE versions), and LS120 removable floppies. Users
|
|
have also reported success with floppy drives on Sun SPARC and Apple
|
|
Macintosh systems. If
|
|
<B>eject</B>
|
|
|
|
does not work, it is most likely a limitation of the kernel driver
|
|
for the device and not the
|
|
<B>eject</B>
|
|
|
|
program itself.
|
|
<P>
|
|
The -r, -s, -f, and -q options allow controlling which methods are
|
|
used to eject. More than one method can be specified. If none of these
|
|
options are specified, it tries all four (this works fine in most
|
|
cases).
|
|
<P>
|
|
<B>Eject</B>
|
|
|
|
may not always be able to determine if the device is mounted (e.g. if
|
|
it has several names). If the device name is a symbolic link,
|
|
<B>eject</B>
|
|
|
|
will follow the link and use the device that it points to.
|
|
<P>
|
|
If
|
|
<B>eject</B>
|
|
|
|
determines that the device can have multiple partitions, it will
|
|
attempt to unmount all mounted partitions of the device before
|
|
ejecting. If an unmount fails, the program will not attempt to eject
|
|
the media.
|
|
<P>
|
|
You can eject an audio CD. Some CD-ROM drives will refuse to open the
|
|
tray if the drive is empty. Some devices do not support the tray close
|
|
command.
|
|
<P>
|
|
If the auto-eject feature is enabled, then the drive will always be
|
|
ejected after running this command. Not all Linux kernel CD-ROM
|
|
drivers support the auto-eject mode. There is no way to find out the
|
|
state of the auto-eject mode.
|
|
<P>
|
|
You need appropriate privileges to access the device files. Running as
|
|
root or setuid root is required to eject some devices (e.g. SCSI
|
|
devices).
|
|
<P>
|
|
The heuristic used to find a device, given a name, is as follows. If
|
|
the name ends in a trailing slash, it is removed (this is to support
|
|
filenames generated using shell file name completion). If the name
|
|
starts with '.' or '/', it tries to open it as a device file or mount
|
|
point. If that fails, it tries prepending '/dev/', '/media/' ,'/mnt/',
|
|
'/dev/cdroms', '/dev/rdsk/', '/dev/dsk/', and finally './' to the name,
|
|
until a
|
|
device file or mount point is found that can be opened. The program
|
|
checks /etc/mtab for mounted devices. If that fails, it also checks
|
|
/etc/fstab for mount points of currently unmounted devices.
|
|
<P>
|
|
Creating symbolic links such as /dev/cdrom or /dev/zip is recommended
|
|
so that
|
|
<B>eject</B>
|
|
|
|
can determine the appropriate devices using easily remembered names.
|
|
<P>
|
|
To save typing you can create a shell alias for the eject options that
|
|
work for your particular setup.
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<B>Eject</B>
|
|
|
|
was written by Jeff Tranter (<A HREF="mailto:tranter@pobox.com">tranter@pobox.com</A>) and is released
|
|
under the conditions of the GNU General Public License. See the file
|
|
COPYING and notes in the source code for details.
|
|
<P>
|
|
The -x option was added by Nobuyuki Tsuchimura (<A HREF="mailto:tutimura@nn.iij4u.or.jp">tutimura@nn.iij4u.or.jp</A>),
|
|
with thanks to Roland Krivanek (<A HREF="mailto:krivanek@fmph.uniba.sk">krivanek@fmph.uniba.sk</A>) and his
|
|
cdrom_speed command.
|
|
<P>
|
|
The -T option was added by Sybren Stuvel (<A HREF="mailto:sybren@thirdtower.com">sybren@thirdtower.com</A>), with
|
|
big thanks to Benjamin Schwenk (<A HREF="mailto:benjaminschwenk@yahoo.de">benjaminschwenk@yahoo.de</A>).
|
|
<P>
|
|
The -X option was added by Eric Piel (<A HREF="mailto:Eric.Piel@tremplin-utc.net">Eric.Piel@tremplin-utc.net</A>).
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<P>
|
|
<A HREF="/cgi-bin/man/man2html?2+mount">mount</A>(2), <A HREF="/cgi-bin/man/man2html?2+umount">umount</A>(2), <A HREF="/cgi-bin/man/man2html?8+mount">mount</A>(8), <A HREF="/cgi-bin/man/man2html?8+umount">umount</A>(8)
|
|
<BR>
|
|
|
|
/usr/src/linux/Documentation/cdrom/
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="28"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="29"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="30"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="31"><A HREF="#lbAE">COMMAND-LINE OPTIONS</A><DD>
|
|
<DT id="32"><A HREF="#lbAF">LONG OPTIONS</A><DD>
|
|
<DT id="33"><A HREF="#lbAG">EXAMPLES</A><DD>
|
|
<DT id="34"><A HREF="#lbAH">EXIT STATUS</A><DD>
|
|
<DT id="35"><A HREF="#lbAI">NOTES</A><DD>
|
|
<DT id="36"><A HREF="#lbAJ">AUTHOR</A><DD>
|
|
<DT id="37"><A HREF="#lbAK">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:11 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|