eject man page on Solaris

Man page or keyword search:  
man Server   20652 pages
apropos Keyword Search (all sections)
Output format
Solaris logo
[printable version]

eject(1)			 User Commands			      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, depending on whether or not Volume
       Management is running.

   With Volume Management
       When  eject is used on media that can only be ejected manually, it will
       do everything except remove the media, including	 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 sup‐
       plied 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	eject‐
       ing  the	 media (see mount(1M)). If the unmount operation fails,	 eject
       prints a warning message and exits. The -f option may be used to	 spec‐
       ify  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 volcheck(1) before
       ejecting	 the  media  to inform Volume Management of the floppy's pres‐
       ence.

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  Man‐
		agement 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 Management

       To eject a  CD-ROM drive with pathname /dev/dsk/c0t3d0s2, without  Vol‐
       ume 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 attributes:

       ┌─────────────────────────────┬─────────────────────────────┐
       │      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 com‐
       mand (without Volume Management running) will work:

       example> eject /dev/dsk/c0t3d0s0

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

SunOS 5.10			  20 Sep 1996			      eject(1)
[top]

List of man pages available for Solaris

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net