EJECT(1) دستورهای کاربری EJECT(1)

eject - خارج کردن رسانه‌های جداشدنی

eject [گزینه‌ها] device|mountpoint

دستور eject امکان خارج کردن رسانه‌های جداشدنی (معمولاً CD-ROM، فلاپی‌دیسک، نوار، دیسک‌های JAZ ،ZIP یا USB) را تحت کنترل نرم‌افزار فراهم می‌کند. این دستور همچنین می‌تواند برخی تعویض‌کننده‌های چنددیسکی CD-ROM، ویژگی خروج خودکار پشتیبانی‌شده توسط برخی دستگاه‌ها و بستن سینی دیسک در برخی درایوهای CD-ROM را کنترل کند.

دستگاه متناظر با device یا mountpoint خارج می‌شود. اگر نامی مشخص نشود، نام پیش‌فرض /dev/cdrom استفاده می‌شود. دستگاه را می‌توان با نام دستگاه (مانند 'sda')، مسیر دستگاه (مانند '/dev/sda')، برچسب‌های UUID=uuid یا LABEL=label مشخص کرد.

چهار روش مختلف برای خارج کردن وجود دارد که بستگی به این دارد که دستگاه یک CD-ROM، دستگاه SCSI، فلاپی جداشدنی یا نوار باشد. به‌طور پیش‌فرض eject هر چهار روش را به ترتیب امتحان می‌کند تا یکی از آن‌ها با موفقیت انجام شود.

اگر یک پارتیشن دستگاه مشخص شود، کل دستگاه دیسک استفاده می‌شود.

اگر دستگاه یا یک پارتیشن دستگاه در حال حاضر متصل (mount) باشد، پیش از خارج کردن، اتصال آن قطع (unmount) می‌شود. در صورتی که --no-unmount یا --force مشخص نشده باشند، عملیات خروج روی یک توصیف‌گر فایل دستگاه بلوکی با باز کردن انحصاری پردازش می‌شود.

-a, --auto on|off

این گزینه حالت خروج خودکار را که توسط برخی دستگاه‌ها پشتیبانی می‌شود کنترل می‌کند. در صورت فعال بودن، هنگام بسته شدن دستگاه، درایو به‌طور خودکار خارج می‌شود.

-c, --changerslot slot

با این گزینه می‌توان یک شیار دیسک را از تعویض‌کننده CD-ROM مبتنی بر ATAPI/IDE انتخاب کرد. برای کارکرد درخواست تعویض، درایو CD-ROM نباید در حال استفاده باشد (CD داده متصل‌شده یا در حال پخش CD صوتی). لطفاً توجه داشته باشید که به اولین شیار تعویض‌کننده با شماره 0 اشاره می‌شود، نه 1.

-d, --default

فهرست کردن نام دستگاه پیش‌فرض.

-F, --force

خروج اجباری؛ عدم بررسی نوع دستگاه و عدم باز کردن دستگاه با قفل انحصاری. نتیجه موفقیت‌آمیز ممکن است در دستگاه‌های فاقد قابلیت اتصال گرم (non hot-pluggable) یک نتیجه مثبت کاذب باشد.

-f, --floppy

این گزینه مشخص می‌کند که درایو باید با استفاده از دستور خروج فلاپی‌دیسک جداشدنی خارج شود.

-i, --manualeject on|off

این گزینه قفل کردن دکمه سخت‌افزاری خروج را کنترل می‌کند. در صورت فعال بودن، با فشردن دکمه، درایو خارج نخواهد شد. این قابلیت زمانی مفید است که لپ‌تاپ را در کیف حمل می‌کنید و نمی‌خواهید با فشردن تصادفی دکمه، درایو خارج شود.

-M, --no-partitions-unmount

این گزینه به eject می‌گوید که برای قطع اتصال سایر پارتیشن‌ها در دستگاه‌های پارتیشن‌بندی‌شده تلاش نکند. اگر پارتیشن دیگری همچنان متصل باشد، برنامه تلاشی برای خارج کردن رسانه نخواهد کرد. برنامه تنها تلاش می‌کند اتصال دستگاه یا نقطه اتصال مشخص‌شده در خط فرمان را قطع کند.

-m, --no-unmount

این گزینه به eject می‌گوید که اصلاً برای قطع اتصال تلاش نکند. اگر این گزینه مشخص نشود، eject دستگاه را با پرچم O_EXCL باز می‌کند تا مطمئن شود دستگاه در حال استفاده نیست (از نسخه v2.35).

-n, --noop

با این گزینه، دستگاه انتخاب‌شده نمایش داده می‌شود اما هیچ عملیاتی انجام نمی‌گیرد.

-p, --proc

این گزینه به شما اجازه می‌دهد از /proc/mounts به جای /etc/mtab استفاده کنید. همچنین گزینه -n را به umount(8) ارسال می‌کند.

-q, --tape

این گزینه مشخص می‌کند که درایو باید با استفاده از دستور آفلاین درایو نوار خارج شود.

-r, --cdrom

این گزینه مشخص می‌کند که درایو باید با استفاده از دستور خروج CDROM خارج شود.

-s, --scsi

این گزینه مشخص می‌کند که درایو باید با استفاده از دستورات SCSI خارج شود.

-T, --traytoggle

با این گزینه، در صورت باز بودن سینی CD-ROM به درایو دستور بسته شدن، و در صورت بسته بودن دستور خروج سینی داده می‌شود. همه دستگاه‌ها از این دستور پشتیبانی نمی‌کنند، زیرا از دستور بستن سینی CD-ROM که در بالا ذکر شد استفاده می‌کند.

-t, --trayclose

با این گزینه، به درایو دستور بسته شدن سینی CD-ROM داده می‌شود. همه دستگاه‌ها از این دستور پشتیبانی نمی‌کنند.

-v, --verbose

اجرا در حالت پرگو (verbose)؛ اطلاعات بیشتری درباره آنچه دستور انجام می‌دهد نمایش داده می‌شود.

-X, --listspeed

با این گزینه درایو CD-ROM برای تشخیص سرعت‌های موجود بررسی می‌شود. خروجی فهرستی از سرعت‌ها است که می‌تواند به عنوان آرگومان گزینه -x استفاده شود. این قابلیت فقط در لینوکس 2.6.13 یا بالاتر کار می‌کند؛ در نسخه‌های قبلی صرفاً حداکثر سرعت گزارش خواهد شد. همچنین توجه داشته باشید که برخی درایوها ممکن است سرعت را به‌درستی گزارش نکنند و بنابراین این گزینه با آن‌ها کار نکند.

-x, --cdspeed speed

با این گزینه، به درایو دستور انتخاب سرعت CD-ROM داده می‌شود. آرگومان speed عددی است که سرعت مورد نظر را نشان می‌دهد (مثلاً 8 برای سرعت 8X)، یا 0 برای حداکثر نرخ انتقال داده. همه دستگاه‌ها از این دستور پشتیبانی نمی‌کنند و شما تنها می‌توانید سرعت‌هایی را مشخص کنید که درایو توانایی آن را دارد. با هر بار تعویض رسانه، این گزینه بازنشانی می‌شود. این گزینه می‌تواند به‌تنهایی یا همراه با گزینه‌های -t و -c استفاده شود.

-h, --help

نمایش متن راهنما و خروج.

-V, --version

نمایش نسخه و خروج.

در صورت موفقیت‌آمیز بودن عملیات، مقدار 0 و در صورت شکست عملیات یا نامعتبر بودن نحو دستور، مقدار 1 برگردانده می‌شود.

دستور eject تنها با دستگاه‌هایی کار می‌کند که از یک یا چند روش از روش‌های چهارگانه خروج پشتیبانی کنند. این شامل اکثر درایوهای CD-ROM (از نوع IDE ،SCSI و اختصاصی)، برخی درایوهای نوار SCSI، درایوهای JAZ، درایوهای ZIP (نسخه‌های موازی، SCSI و IDE) و فلاپی‌های جداشدنی LS120 می‌شود. کاربران همچنین از عملکرد موفق درایوهای فلاپی روی سیستم‌های Sun SPARC و Apple Macintosh گزارش داده‌اند. اگر eject کار نمی‌کند، به احتمال زیاد ناشی از محدودیت درایور هسته برای آن دستگاه است و نه خود برنامه eject.

گزینه‌های -r، -s، -f و -q امکان کنترل این‌که کدام روش‌ها برای خروج استفاده شوند را فراهم می‌کنند. می‌توان بیش از یک روش را مشخص کرد. اگر هیچ‌یک از این گزینه‌ها مشخص نشود، هر چهار روش را امتحان می‌کند (این حالت در اکثر موارد به خوبی کار می‌کند).

دستور eject ممکن است همیشه نتواند متصل بودن دستگاه را تشخیص دهد (مثلاً اگر دستگاه چند نام داشته باشد). اگر نام دستگاه یک پیوند نمادین باشد، eject پیوند را دنبال کرده و از دستگاهی که به آن اشاره می‌کند استفاده خواهد کرد.

اگر eject تشخیص دهد که دستگاه می‌تواند چندین پارتیشن داشته باشد، تلاش خواهد کرد پیش از خروج، تمام پارتیشن‌های متصل‌شده دستگاه را قطع کند (همچنین به --no-partitions-unmount مراجعه کنید). اگر قطع اتصال با شکست مواجه شود، برنامه تلاشی برای خارج کردن رسانه نخواهد کرد.

می‌توانید یک CD صوتی را خارج کنید. برخی درایوهای CD-ROM در صورت خالی بودن درایو، از باز کردن سینی خودداری می‌کنند. برخی دستگاه‌ها نیز از دستور بستن سینی پشتیبانی نمی‌کنند.

اگر ویژگی خروج خودکار فعال باشد، درایو همیشه پس از اجرای این دستور خارج خواهد شد. همه درایورهای CD-ROM در هسته لینوکس از حالت خروج خودکار پشتیبانی نمی‌کنند. راهی برای آگاهی از وضعیت حالت خروج خودکار وجود ندارد.

برای دسترسی به فایل‌های دستگاه به مجوزهای مناسب نیاز دارید. برای خارج کردن برخی دستگاه‌ها (مانند دستگاه‌های SCSI) اجرای دستور با دسترسی ریشه (root) الزامی است.

Jeff Tranter <tranter@pobox.com> - نویسنده اصلی، Karel Zak <kzak@redhat.com> و Michal Luscon <mluscon@redhat.com> - نسخه util-linux.

findmnt(8)، lsblk(8)، mount(8)، umount(8)

برای گزارش باگ‌ها، از ردیاب اشکالات https://github.com/util-linux/util-linux/issues. استفاده کنید.

دستور eject بخشی از بسته util-linux است که می‌توان آن را از بایگانی هسته لینوکس https://www.kernel.org/pub/linux/utils/util-linux. دریافت کرد.

2026-06-16 util-linux 2.42.2