.\" This file Copyright (C) 1994-2005 Jeff Tranter
.\" (tranter@pobox.com)
.\" It may be distributed under the GNU Public License, version 2, or
.\" any higher version. See section COPYING of the GNU Public license
.\" for conditions under which this file may be redistributed.
.\"
.\" Japanese Version Copyright (c) 2000 OOGAMI Atsushi
.\"         all rights reserved.
.\" Translated Tue Oct 31 20:58:03 JST 2000
.\"         by OOGAMI Atsushi <ati@ff.iij4u.or.jp>, eject-2.0.2
.\" Updated & Modified Sat Sep 29 09:34:15 JST 2001
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>, eject-2.0.10
.\" Updated & Modified Fri Oct 20 04:18:25 JST 2006
.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>, eject-2.1.5
.\"
.\"WORD:	eject				イジェクトする
.\"WORD:	multi-disc CD-ROM changer	連装 CD-ROM チェンジャ
.\"WORD:	auto-eject			自動イジェクト
.\"WORD:	tray				トレイ
.\"WORD:	proprietary			独自規格
.\"
.TH EJECT 1 "12 May 2005" "Linux" "User Commands"
.SH 名前
eject \- リムーバブルメディアをイジェクトする
.SH 書式
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] \-t [<name>]
.br
eject [\-vn] \-T [<name>]
.br
eject [\-vn] \-x <speed> [<name>]
.br
eject [\-vn] \-X [<name>]
.br
eject \-V

.SH 説明

.B eject
を用いると、リムーバブルメディア (CD-ROM、フロッピーディスク、テープ、
JAZ/ZIP ディスクなど) をソフトウェア制御によってイジェクトできる。
また eject は、連装 CD-ROM チェンジャを制御したり、
デバイスの自動イジェクト機能を制御したり、CD-ROM ドライブのディスクトレイを
閉じることもできる (製品によってはできないこともある)。

引き数 <name> に対応するデバイスがイジェクトされる。
name はデバイスファイルまたはマウントポイントであり、フルパスでも先頭の
"/dev", "/media", "/mnt" を省略した形でもどちらでもよい。
name が指定されない場合、デフォルトでは "cdrom" が対象となる。

対象デバイスが CD-ROM、SCSI デバイス、リムーバブルフロッピー、
テープであるかによって、4 つの異なるイジェクト方法がある。
デフォルトでは、eject は 4 つの方法全てを成功するまで順に試行する。

対象デバイスがマウントされている場合、イジェクト前にアンマウントされる。

.PP
.SH "コマンド行オプション"
.TP 0.5i
.B \-h
このオプションは、
.B eject
にコマンドオプションの簡単な説明を表示させる。

.TP 0.5i
.B \-v
.B eject
を詳細表示モードで実行する; eject が実行していることについて、
より多くの情報が表示される。

.TP 0.5i
.B \-d
このオプションとともに実行すると、
.B eject
はデフォルトのデバイス名を表示する。

.TP 0.5i
.B \-a on|1|off|0
このオプションは、いくつかのデバイスでサポートされている
自動イジェクトモードを制御する。
自動イジェクトモードを有効にすると、
対象デバイスがクローズされたときにそのドライブは自動的にイジェクトする。

.TP 0.5i
.B \-c <slot>
このオプションにより、ATAPI/IDE CD-ROM チェンジャの CD スロットを選択できる。
この機能を利用するには、Linux 2.0 以上が必要である。
スロット切替要求が機能するためには、
CD-ROM ドライブが動作中 (データ CD をマウントしていたり、
音楽 CD を演奏していたり) であってはならない。
チェンジャの最初のスロットが、
1 ではなく 0 で参照される点についても注意してほしい。

.TP 0.5i
.B \-t
このオプションは、ドライブに CD-ROM トレイのクローズコマンドを与える。
全てのデバイスがこのコマンドをサポートするわけではない。

.TP 0.5i
.B \-T
このオプションは、CD-ROM トレイがオープンしている場合には、
クローズコマンドを与える。
また CD-ROM トレイがクローズしている場合には、イジェクトコマンドを与える。
このオプションは上記の CD-ROM トレイのクローズコマンドを使うので、
全てのデバイスでこのコマンドがサポートされている訳ではない。

.TP 0.5i
.B \-x <speed>
このオプションはドライブに CD-ROM スピード選択コマンドを与える。
speed 引き数は希望するスピード (たとえば 8 倍速の場合は 8) を表す数字である。
最大データレートにする場合は 0 にする。
全てのデバイスがこのコマンドをサポートしているわけではないので、
これをサポートしているデバイスにのみ指定できる。
メディアを交換するたびに、このオプションはクリアされる。
このオプションは単独で使用するか、-t と -c オプションとともに使用する。

.TP 0.5i
.B \-X 
このオプションは CD-ROM ドライブで利用可能なスピードを調べる。
出力はスピードのリストで、\-x オプションの引き数として指定可能である。
このオプションは Linux 2.6.13 以降でのみ動作し、
それ以前のバージョンでは単に最大スピードだけが返される。
スピードを正確に返さないドライブもあり、
そのようなドライブでは、このオプションが動作しない点に注意すること。

.TP 0.5i
.B \-n
このオプションは選択されたデバイスを表示するが、何の操作も行わない。

.TP 0.5i
.B \-r
このオプションは、CDROM イジェクトコマンドを用いて対象ドライブを
イジェクトするよう指定する。
.TP 0.5i

.B \-s
このオプションは、SCSI コマンドを用いて対象ドライブをイジェクト
するよう指定する。

.TP 0.5i
.B \-f
このオプションは、リムーバブルフロッピーディスクイジェクトコマンド
を用いて対象ドライブをイジェクトするよう指定する。

.TP 0.5i
.B \-q
このオプションは、テープドライブオフラインコマンドを用いて対象
ドライブをイジェクトするよう指定する。

.TP 0.5i
.B \-p
このオプションを指定すると、
/etc/mtab ではなく /proc/mounts を使うことができる。
このオプションは umount(1) に -n オプションを渡す。

.TP 0.5i
.B \-m
このオプションを指定すると、リムーバブルメディアを自動的にマウントする
デバイスドライバと共に eject を使用することができる。
そのためリムーバブルメディアに対して常に mount() が実行される。
指定されたデバイスが /etc/mtab または /proc/mounts に基づいて
マウントされていても、このオプションは eject にアンマウントを行わせない。

.TP 0.5i
.B \-V
このオプションを使うと、
.B eject
はプログラムのバージョンを表示して終了する。

.SH 長いオプション
以下に示すように、全てのオプションには対応する長い名前がある。
これらは、一意に識別できる長さまで省略することができる。

.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

.SH 例
.PP
デフォルトのデバイスをイジェクトする:
.IP
eject
.PP
cdrom という名前のデバイスまたはマウントポイントをイジェクトする:
.IP
eject cdrom
.PP
デバイス名でイジェクトする:
.IP
eject /dev/cdrom
.PP
マウントポイントでイジェクトする:
.IP
eject /mnt/cdrom/
.PP
4 番目の IDE デバイスをイジェクトする:
.IP
eject hdd
.PP
1 番目の SCSI デバイスをイジェクトする:
.IP
eject sda
.PP
SCSI パーティション名 (例えば、ZIP ドライブ) でイジェクトする:
.IP
eject sda4
.PP
連装チェンジャの 5 番目のディスクを選択する:
.IP
eject \-v \-c4 /dev/cdrom
.PP
SoundBlaster CD-ROM ドライブの自動イジェクトを有効にする:
.IP
eject \-a on /dev/sbpcd

.SH 返り値
.PP

操作が成功すると 0 を返す。
操作が失敗、またはコマンドの構文が間違っていると 1 を返す。

.SH 注意
.PP

.B eject
は、4 つのイジェクト方法のうち 1 つ以上をサポートするデバイスに対して
のみ有効である。
これには、ほとんどの CD-ROM ドライブ (IDE、SCSI、独自規格)、
何種類かの SCSI テープドライブ、JAZ ドライブ、
ZIP ドライブ (パラレルポート版、SCSI 版、IDE 版)、
LS120 リムーバブルフロッピーが含まれる。
Sun SPARC と Apple Macintosh のフロッピードライブについても、
ユーザーからの成功報告がある。
.B eject
が動作しないのは、ほとんどの場合、
そのデバイスのカーネルドライバの制限によるものであり、
.B eject
プログラム自体の制限ではない。

\-r, \-s, \-f, \-q オプションで、どのイジェクト方法を用いるかを制御できる。
複数のイジェクト方法を指定することができる。
これらのオプションが全く指定されないと、eject は 4 つの方法全てを試行する
(これはほとんどの場合に上手く動作する)。

.B eject
は、対象デバイスがマウントされているかどうかを常に判断できるわけではない
(例えば、そのデバイスに複数の名前がある場合)。
デバイス名がシンボリックリンクである場合、
.B eject
はリンクを辿り、リンク先のデバイスを使用する。

対象デバイスが複数のパーティションを持ち得ると判断した場合、
.B eject
は、そのデバイスのマウントされたパーティションを
イジェクト前に全てアンマウントしようとする。
アンマウントに失敗すると、eject はメディアのイジェクトを中止する。

音楽 CD をイジェクトすることができる。 CD-ROM ドライブによっては、
ドライブが空である場合にトレイを開くことを拒否するものもある。
トレイクローズコマンドをサポートしないデバイスもある。

自動イジェクト機能が有効になると、
そのドライブは eject を実行すると常にイジェクトされるようになる。
全ての Linux カーネル CD-ROM ドライバが、
自動イジェクトモードをサポートするわけではない。
自動イジェクトモードの状態を確認する方法は無い。

デバイスファイルへのアクセスには適切な権限が必要である。デバイスによっては
(例えば SCSI デバイス)、 eject を root で実行しなければならなかったり、
または eject を root に setuid しておくことが必要だったりする。

名前からデバイスを発見するために用いる探索法は、以下の通りである。
名前の末尾がスラッシュで終わる場合、それを取り除く
(シェルのファイル名補完機能を使って生成された名前をサポートするため)。
名前が '.' または '/' で始まる場合は、名前をデバイスファイルまたは
マウントポイントとみなしてオープンを試みる。
オープンに失敗すると、オープン可能なデバイスファイルまたは
マウントポイントが見つかるまで、
eject は名前の先頭に '/dev/', '/media/' ,'/mnt/',
\&'/dev/cdroms', '/dev/rdsk/', '/dev/dsk/', './' を挿入して試す。
eject は、マウントされたデバイスを /etc/mtab でチェックする。
これに失敗すると、eject は現在マウントされていないデバイスの
マウントポイントを確認するために /etc/fstab もチェックする。

/dev/cdrom や /dev/zip のようなシンボリックリンクを作っておくことを勧める。
こうすれば
.B eject
は適切なデバイスを覚えやすい名前を用いて特定できるようになるからである。

キー入力数を節約するため、あなたの環境固有の設定に合わせた eject オプション
へのシェルエイリアスを作るのもよいだろう。

.SH 著者
.B eject
は Jeff Tranter (tranter@pobox.com) によって開発され、
GNU 一般公有使用許諾書の条件下でリリースされる。
詳細については、COPYING ファイルと、ソースコードの注記を参照のこと。

\-x オプションは Nobuyuki Tsuchimura (tutimura@nn.iij4u.or.jp) によって
追加された。
Roland Krivanek (krivanek@fmph.uniba.sk) の cdrom_speed コマンドに感謝する。

\-T オプションは Sybren Stuvel (sybren@thirdtower.com) によって追加された。
Benjamin Schwenk (benjaminschwenk@yahoo.de) には非常に感謝している。

\-X オプションは Eric Piel (Eric.Piel@tremplin-utc.net) によって追加された。

.SH 関連項目

mount(2), umount(2), mount(8), umount(8)
.br
/usr/src/linux/Documentation/cdrom/