نام (NAME)

udisksctl - ابزار خط فرمان udisks

خلاصه دستور (SYNOPSIS)

udisksctl status

udisksctl info {--object-path OBJECT | --block-device DEVICE | --drive DRIVE}

udisksctl mount {--object-path OBJECT | --block-device DEVICE} [--filesystem-type TYPE] [--options OPTIONS...] [--no-user-interaction]

udisksctl unmount {--object-path OBJECT | --block-device DEVICE} [--force] [--no-user-interaction]

udisksctl unlock {--object-path OBJECT | --block-device DEVICE} [--no-user-interaction] [--key-file PATH] [--read-only]

udisksctl lock {--object-path OBJECT | --block-device DEVICE} [--no-user-interaction]

udisksctl loop-setup --file PATH [--read-only] [--offset OFFSET] [--size SIZE] [--no-user-interaction]

udisksctl loop-delete {--object-path OBJECT | --block-device DEVICE} [--no-user-interaction]

udisksctl power-off {--object-path OBJECT | --block-device DEVICE} [--no-user-interaction]

udisksctl smart-simulate --file PATH {--object-path OBJECT | --block-device DEVICE} [--no-user-interaction]

udisksctl monitor

udisksctl dump

udisksctl help

توضیحات (DESCRIPTION)

دستور udisksctl یک برنامه خط فرمانی است که برای تعامل با پردازه دیمن udisksd(8) به کار می‌رود.

دستورها (COMMANDS)

status

اطلاعات سطح بالایی را درباره گرداننده‌های دیسک و دستگاه‌های بلوکی نمایش می‌دهد.

info

اطلاعات تفصیلی درباره OBJECT، DEVICE یا DRIVE را نشان می‌دهد.

mount

یک دستگاه را سوار (mount) می‌کند. دستگاه در یک زیردایرکتوری در سلسله‌مراتب /run/media سوار خواهد شد - پس از اتمام موفقیت‌آمیز، نقطه اتصال در خروجی استاندارد چاپ می‌شود.

-t, --filesystem-type

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

-o, --options

دستگاه با مجموعه‌ای امن از گزینه‌های پیش‌فرض سوار می‌شود. با استفاده از این گزینه می‌توانید بر گزینه‌های ارسال‌شده به دستور mount(8) تأثیر بگذارید. توجه داشته باشید که تنها گزینه‌های امن مجاز هستند - درخواست‌هایی با گزینه‌های ذاتاً ناامن مانند suid یا dev که به فراخواننده اجازه دستیابی به امتیازات بیشتر را می‌دهند، رد خواهند شد.

unmount

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

-f, --force

پیاده‌سازی با تأخیر (Lazy unmount). سیستم‌فایل را در همین لحظه از سلسله‌مراتب فایل جدا می‌کند و به محض اینکه دیگر مشغول نباشد، تمام ارجاعات به آن را پاک‌سازی می‌نماید.

unlock

قفل یک دستگاه رمزگذاری‌شده را باز می‌کند. عبارت عبور از پایانه کنترل‌کننده درخواست می‌شود و پس از تکمیل موفقیت‌آمیز، نام دستگاه رمزگشایی‌شده (cleartext) در خروجی استاندارد چاپ خواهد شد.

--key-file=PATH

خواندن عبارت عبور از فایل مشخص‌شده.

lock

یک دستگاه را قفل می‌کند. این دستور تنها در صورتی کار می‌کند که دستگاه یک دستگاه متن آشکار (cleartext) باشد که متکی بر یک دستگاه رمزنگاری‌شده است.

loop-setup

یک دستگاه loop مبتنی بر FILE راه‌اندازی می‌کند.

-f, --file=FILE

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

-r, --read-only

راه‌اندازی یک دستگاه loop به صورت فقط‌خواندنی.

-o, --offset=OFFSET

نقطه شروع داده‌ها به اندازه OFFSET بایت به درون فایل مشخص‌شده منتقل می‌شود.

-s, --size=SIZE

پایان داده‌ها حداکثر روی SIZE بایت پس از نقطه شروع داده‌ها تنظیم می‌شود.

loop-delete

یک دستگاه loop را برمی‌چیند.

power-off

مقدمات حذف ایمن و خاموش کردن درایو را فراهم می‌کند. در سمت سیستم‌عامل، این شامل اطمینان از عدم استفاده هرگونه پردازه از درایو، و سپس درخواست ثبت بافرهای در جریان و حافظه‌های موقت روی فضای ذخیره‌سازی پایدار است. مراحل دقیق خاموش کردن درایو به خود درایو و رابط اتصال مورد استفاده بستگی دارد. برای درایوهایی که از طریق USB متصل شده‌اند، اثر این دستور خارج کردن دستگاه USB از پیکربندی و در ادامه غیرفعال کردن درگاه هاب بالادستی متصل به آن است.

توجه داشته باشید که از آنجا که برخی دستگاه‌های فیزیکی حاوی چندین درایو هستند (مانند دستگاه‌های کارت‌خوان فلش ۴-در-۱ مبتنی بر USB)، خاموش کردن یک درایو ممکن است بر درایوهای دیگر نیز تأثیر بگذارد. بنابراین تضمین‌های چندانی در ارتباط با انجام این عمل وجود ندارد. معمولاً تأثیر آن به این صورت است که درایو طوری ناپدید می‌شود که گویی از دستگاه کشیده شده است.

smart-simulate

داده‌های SMART را از بلاب (blob) libatasmart مشخص‌شده توسط FILE تنظیم می‌کند - برای بلاب‌های ارائه‌شده همراه با libatasmart مسیر /usr/share/doc/libatasmart-devel-VERSION/ را ببینید. این یک ویژگی اشکال‌زدایی است که برای بررسی عملکرد صحیح برنامه‌ها هنگام خرابی یک دیسک به کار می‌رود.

-f, --file=FILE

فایل حاوی بلاب libatasmart.

monitor

دیمن را برای نظارت بر رویدادها پایش می‌کند.

dump

وضعیت فعلی دیمن را چاپ می‌کند.

help

راهنما را چاپ کرده و خارج می‌شود.

مشخص کردن دستگاه (DEVICE SPECIFICATION)

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

-b, --block-device=DEVICE

مشخص کردن یک دستگاه با استفاده از مسیر فایل دستگاه آن؛ به عنوان مثال /dev/sda.

-p, --object-path=OBJECT

مشخص کردن یک دستگاه از طریق مسیر شیء داخلی UDisks بدون پیشوند /org/freedesktop/UDisks2؛ به عنوان مثال block_devices/sda برای دیسک /dev/sda.

-d, --drive=DRIVE

مشخص کردن یک درایو بر اساس نام، برای مثال VirtIO_Disk. این گزینه در حال حاضر تنها می‌تواند همراه با دستور info استفاده شود.

گزینه‌های عمومی (COMMON OPTIONS)

گزینه --no-user-interaction می‌تواند برای درخواست این موضوع استفاده شود که در زمان بررسی مجاز بودن فراخواننده برای انجام عمل درخواستی توسط polkit(8)، هیچ تعاملی (مانند نمایش کادر محاوره‌ای احراز هویت به کاربر) رخ ندهد.

مخاطبان (AUDIENCE)

این برنامه فرض نمی‌کند که فراخواننده مدیر سیستم (super user) است - این برنامه برای استفاده توسط کاربران غیرممتاز طراحی شده و مجوزها توسط دیمن udisks با استفاده از polkit(8) بررسی می‌شوند. علاوه بر این، این برنامه برای استفاده در اسکریپت‌ها یا برنامه‌های دیگر در نظر گرفته نشده است - گزینه‌ها/دستورها ممکن است در آینده حتی در نسخه‌های نگهداری (maintenance releases) به شیوه‌هایی ناسازگار تغییر کنند. برای اطلاعات بیشتر بخش “API STABILITY” از udisks(8) را ببینید.

تکمیل خودکار بش (BASH COMPLETION)

دستور udisksctl همراه با یک اسکریپت تکمیل خودکار bash برای تکمیل دستورها، شیءها، دستگاه‌های بلوکی و برخی گزینه‌ها ارائه می‌شود.

نویسندگان (AUTHORS)

این صفحه راهنما در ابتدا برای UDisks2 توسط David Zeuthen <zeuthen@gmail.com> با کمک‌های فراوان دیگران نوشته شده است.

گزارش باگ‌ها (BUGS)

لطفاً گزارش باگ‌ها را به سامانه ردیابی اشکالات توزیع خود یا به ردیاب اشکالات بالادستی در https://github.com/storaged-project/udisks/issues ارسال کنید.

همچنین ببینید (SEE ALSO)

udisks(8), udisksd(8), umount.udisks2(8), polkit(8)