eject(1)




NAME

     eject - eject media such as CD-ROM and floppy from drive


SYNOPSIS

     eject [-dfnpq] [device | nickname]


DESCRIPTION

     The eject utility is used for those removable media  devices
     that  do  not  have a manual eject button, or for those that
     do, but are managed by Volume Management (see vold(1M)). The
     device  may  be  specified  by its name or by a nickname; if
     Volume Management is running and no  device   is  specified,
     the default device is used.

     Only  devices  that  support  eject  under  program  control
     respond to this command. eject responds differently, depend-
     ing on whether or not Volume Management is running.

  With Volume Management
     When eject is used on media that can only be  ejected  manu-
     ally, it will do everything except remove the media, includ-
     ing unmounting the file system if it  is  mounted.  In  this
     case,  eject  displays  a  message that the media can now be
     manually ejected. If a window system is running, the message
     is  displayed  as  a  pop-up window, unless the -p option is
     supplied. If no window system is running or the -p option is
     supplied,  a  message is displayed both to stderr and to the
     system console that the media can now be physically removed.

     Volume Management has the concept of a default device, which
     eject  uses if no pathname or nickname is specified. Use the
     -d option to check what default device will be used.

  Without Volume Management
     When Volume Management is not  running  and  a  pathname  is
     specified,  eject  sends the eject command to that pathname.
     If a nickname is supplied instead of a pathname, eject  will
     recognize the following list:

     ____________________________________________________________
    |          Nickname           |             Path            |
    | fd                          | /dev/rdiskette              |
    | fd0                         | /dev/rdiskette              |
    | fd1                         | /dev/rdiskette1             |
    | diskette                    | /dev/rdiskette              |
    | diskette0                   | /dev/rdiskette0             |
    | diskette1                   | /dev/rdiskette1             |
    | rdiskette                   | /dev/rdiskette              |
    | rdiskette0                  | /dev/rdiskette0             |
    | rdiskette1                  | /dev/rdiskette1             |
    | floppy                      | /dev/rdiskette              |
    | floppy0                     | /dev/rdiskette0             |
    | floppy1                     | /dev/rdiskette1             |
    |_____________________________|_____________________________|

     The list above can be reproduced with the -n option.

     Do not physically eject media from a device  which  contains
     mounted  file  systems. eject automatically searches for any
     mounted file systems which reside on the device and attempts
     to  umount them prior to ejecting the media (see mount(1M)).
     If the unmount operation fails,  eject prints a warning mes-
     sage  and  exits.  The  -f  option may be used to specify an
     eject even if the device contains mounted  partitions;  this
     option works only if Volume Management is not running.

     eject can also display its default  device  and  a  list  of
     nicknames.

     If you have inserted a floppy diskette, you  must  use  vol-
     check(1)  before ejecting the media to inform Volume Manage-
     ment of the floppy's presence.


OPTIONS

     The following options are supported:

     -d    Displays the name of the default device to be ejected.

     -f    Forces the device to eject even  if  it  is  busy,  if
           Volume Management is not running.

     -n    Displays  the  nickname  to  device  name  translation
           table.

     -p    Does not try to call the  eject_popup program.

     -q    Queries to see if the media is present.


OPERANDS


     The following operands are supported:

     device
           Specifies which  device  to  eject,  by  the  name  it
           appears in the directory /dev.

     nickname
           Specifies which device to eject, by  its  nickname  as
           known to this command.


EXAMPLES

     Example 1: Ejecting a CD while Volume Management is running

     To eject a CD from its drive,  while  Volume  Management  is
     running (assuming only one CD-ROM drive):

     example> eject cdrom0

     Example 2: Ejecting a CD-ROM without running Volume  Manage-
     ment

     To eject a  CD-ROM drive  with  pathname  /dev/dsk/c0t3d0s2,
     without Volume Management running:

     example> eject /dev/dsk/c0t3d0s2

     Example 3: Ejecting a floppy disk

     To eject a floppy disk (whether or not Volume Management  is
     running):

     example> eject floppy0


EXIT STATUS

     The following exit codes are returned:

     0     The operation was successful or, with the  -q  option,
           the media is in the drive.

     1     The  operation  was   unsuccessful  or,  with  the  -q
           option, the media is not in the drive.

     2     Invalid options were specified.

     3     An ioctl() request failed.

     4     Manually ejectable media is now okay to remove.


FILES

     /dev/diskette0
           default diskette file

     /dev/sr0
           default CD-ROM file (deprecated)

     /dev/dsk/c0t6d0s2
           default CD-ROM file

     /usr/lib/vold/eject_popup
           popup used for manually ejected media


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|


SEE ALSO

     volcancel(1),   volcheck(1),    volmissing(1),    mount(1M),
     rmmount(1M),     vold(1M),     ioctl(2),    rmmount.conf(4),
     vold.conf(4), attributes(5), volfs(7FS)


DIAGNOSTICS

     A short help message is printed  if  an  unknown  option  is
     specified. A diagnostic is printed if the device name cannot
     be opened or does not support eject.

     Device Busy
           An attempt was made to  eject  a  device  that  has  a
           mounted file system. A warning message is printed when
           doing a forced eject of a mounted device.


BUGS

     There should be a way to change the default  on  a  per-user
     basis.

     If Volume Management is not running, it is possible to eject
     a  volume  that  is  currently  mounted (see mount(1M)). For
     example, if you have a  CD-ROM  drive  at  /dev/dsk/c0t3d0s2
     mounted  on  /mnt,  the  following  command  (without Volume
     Management running) will work:

     example> eject /dev/dsk/c0t3d0s0

     since both slices s0  and  s2  reference  the  whole  CD-ROM
     drive.


Man(1) output converted with man2html