'\" t
.\"     Title: udisksctl
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: August 2018
.\"    Manual: User Commands
.\"    Source: udisks 2.11.2
.\"  Language: English
.\"
.TH "UDISKSCTL" "1" "August 2018" "udisks 2\&.11\&.2" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
udisksctl \- ابزار خط فرمان udisks
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR status
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR info {\-\-object\-path\ \fIOBJECT\fR | \-\-block\-device\ \fIDEVICE\fR | \-\-drive\ \fIDRIVE\fR}
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR mount {\-\-object\-path\ \fIOBJECT\fR | \-\-block\-device\ \fIDEVICE\fR} [\-\-filesystem\-type\ \fITYPE\fR] [\-\-options\ \fIOPTIONS\fR...] [\-\-no\-user\-interaction]
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR unmount {\-\-object\-path\ \fIOBJECT\fR | \-\-block\-device\ \fIDEVICE\fR} [\-\-force] [\-\-no\-user\-interaction]
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR unlock {\-\-object\-path\ \fIOBJECT\fR | \-\-block\-device\ \fIDEVICE\fR} [\-\-no\-user\-interaction] [\-\-key\-file\ \fIPATH\fR] [\-\-read\-only]
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR lock {\-\-object\-path\ \fIOBJECT\fR | \-\-block\-device\ \fIDEVICE\fR} [\-\-no\-user\-interaction]
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR loop\-setup \-\-file\ \fIPATH\fR [\-\-read\-only] [\-\-offset\ \fIOFFSET\fR] [\-\-size\ \fISIZE\fR] [\-\-no\-user\-interaction]
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR loop\-delete {\-\-object\-path\ \fIOBJECT\fR | \-\-block\-device\ \fIDEVICE\fR} [\-\-no\-user\-interaction]
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR power\-off {\-\-object\-path\ \fIOBJECT\fR | \-\-block\-device\ \fIDEVICE\fR} [\-\-no\-user\-interaction]
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR smart\-simulate \-\-file\ \fIPATH\fR {\-\-object\-path\ \fIOBJECT\fR | \-\-block\-device\ \fIDEVICE\fR} [\-\-no\-user\-interaction]
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR monitor
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR dump
.HP \w'\fBudisksctl\fR\ 'u
\fBudisksctl\fR help
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBudisksctl\fR
یک برنامه خط فرمانی است که برای تعامل با پردازه دیمن
\fBudisksd\fR(8)
به کار می‌رود\&.
.SH "دستورها (COMMANDS)"
.PP
\fBstatus\fR
.RS 4
اطلاعات سطح بالایی را درباره گرداننده‌های دیسک و دستگاه‌های بلوکی نمایش می‌دهد\&.
.RE
.PP
\fBinfo\fR
.RS 4
اطلاعات تفصیلی درباره
\fIOBJECT\fR،
\fIDEVICE\fR
یا
\fIDRIVE\fR
را نشان می‌دهد\&.
.RE
.PP
\fBmount\fR
.RS 4
یک دستگاه را سوار (mount) می‌کند\&. دستگاه در یک زیردایرکتوری در سلسله‌مراتب
/run/media
سوار خواهد شد \- پس از اتمام موفقیت‌آمیز، نقطه اتصال در خروجی استاندارد چاپ می‌شود\&.
.PP
\fB\-t\fR, \fB\-\-filesystem\-type\fR
.RS 4
نوع سیستم‌فایل مورد استفاده\&. در صورت عدم تعیین، نوع سیستم‌فایل شناسایی‌شده به طور خودکار به کار خواهد رفت\&.
.RE
.PP
\fB\-o\fR, \fB\-\-options\fR
.RS 4
دستگاه با مجموعه‌ای امن از گزینه‌های پیش‌فرض سوار می‌شود\&. با استفاده از این گزینه می‌توانید بر گزینه‌های ارسال‌شده به دستور
\fBmount\fR(8)
تأثیر بگذارید\&. توجه داشته باشید که تنها گزینه‌های امن مجاز هستند \- درخواست‌هایی با گزینه‌های ذاتاً ناامن مانند
\fIsuid\fR
یا
\fIdev\fR
که به فراخواننده اجازه دستیابی به امتیازات بیشتر را می‌دهند، رد خواهند شد\&.
.RE
.RE
.PP
\fBunmount\fR
.RS 4
یک دستگاه را پیاده (unmount) می‌کند\&. این دستور تنها در صورتی کار می‌کند که دستگاه سوار شده باشد\&. گزینه
\fB\-\-force\fR
می‌تواند برای درخواست پیاده‌سازی دستگاه حتی در صورت وجود ارجاعات فعال، به کار رود\&.
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
پیاده‌سازی با تأخیر (Lazy unmount)\&. سیستم‌فایل را در همین لحظه از سلسله‌مراتب فایل جدا می‌کند و به محض اینکه دیگر مشغول نباشد، تمام ارجاعات به آن را پاک‌سازی می‌نماید\&.
.RE
.RE
.PP
\fBunlock\fR
.RS 4
قفل یک دستگاه رمزگذاری‌شده را باز می‌کند\&. عبارت عبور از پایانه کنترل‌کننده درخواست می‌شود و پس از تکمیل موفقیت‌آمیز، نام دستگاه رمزگشایی‌شده (cleartext) در خروجی استاندارد چاپ خواهد شد\&.
.PP
\fB\-\-key\-file=\fR\fB\fIPATH\fR\fR
.RS 4
خواندن عبارت عبور از فایل مشخص‌شده\&.
.RE
.RE
.PP
\fBlock\fR
.RS 4
یک دستگاه را قفل می‌کند\&. این دستور تنها در صورتی کار می‌کند که دستگاه یک دستگاه متن آشکار (cleartext) باشد که متکی بر یک دستگاه رمزنگاری‌شده است\&.
.RE
.PP
\fBloop\-setup\fR
.RS 4
یک دستگاه loop مبتنی بر
\fIFILE\fR
راه‌اندازی می‌کند\&.
.PP
\fB\-f\fR, \fB\-\-file=\fR\fB\fIFILE\fR\fR
.RS 4
فایلی که دستگاه loop برای آن راه‌اندازی می‌شود\&.
.RE
.PP
\fB\-r\fR, \fB\-\-read\-only\fR
.RS 4
راه‌اندازی یک دستگاه loop به صورت فقط‌خواندنی\&.
.RE
.PP
\fB\-o\fR, \fB\-\-offset=\fR\fB\fIOFFSET\fR\fR
.RS 4
نقطه شروع داده‌ها به اندازه
\fIOFFSET\fR
بایت به درون فایل مشخص‌شده منتقل می‌شود\&.
.RE
.PP
\fB\-s\fR, \fB\-\-size=\fR\fB\fISIZE\fR\fR
.RS 4
پایان داده‌ها حداکثر روی
\fISIZE\fR
بایت پس از نقطه شروع داده‌ها تنظیم می‌شود\&.
.RE
.RE
.PP
\fBloop\-delete\fR
.RS 4
یک دستگاه loop را برمی‌چیند\&.
.RE
.PP
\fBpower\-off\fR
.RS 4
مقدمات حذف ایمن و خاموش کردن درایو را فراهم می‌کند\&. در سمت سیستم‌عامل، این شامل اطمینان از عدم استفاده هرگونه پردازه از درایو، و سپس درخواست ثبت بافرهای در جریان و حافظه‌های موقت روی فضای ذخیره‌سازی پایدار است\&. مراحل دقیق خاموش کردن درایو به خود درایو و رابط اتصال مورد استفاده بستگی دارد\&. برای درایوهایی که از طریق USB متصل شده‌اند، اثر این دستور خارج کردن دستگاه USB از پیکربندی و در ادامه غیرفعال کردن درگاه هاب بالادستی متصل به آن است\&.
.sp
توجه داشته باشید که از آنجا که برخی دستگاه‌های فیزیکی حاوی چندین درایو هستند (مانند دستگاه‌های کارت‌خوان فلش ۴-در-۱ مبتنی بر USB)، خاموش کردن یک درایو ممکن است بر درایوهای دیگر نیز تأثیر بگذارد\&. بنابراین تضمین‌های چندانی در ارتباط با انجام این عمل وجود ندارد\&. معمولاً تأثیر آن به این صورت است که درایو طوری ناپدید می‌شود که گویی از دستگاه کشیده شده است\&.
.RE
.PP
\fBsmart\-simulate\fR
.RS 4
داده‌های SMART را از بلاب (blob) libatasmart مشخص‌شده توسط
\fIFILE\fR
تنظیم می‌کند \- برای بلاب‌های ارائه‌شده همراه با libatasmart مسیر
/usr/share/doc/libatasmart\-devel\-VERSION/
را ببینید\&. این یک ویژگی اشکال‌زدایی است که برای بررسی عملکرد صحیح برنامه‌ها هنگام خرابی یک دیسک به کار می‌رود\&.
.PP
\fB\-f\fR, \fB\-\-file=\fR\fB\fIFILE\fR\fR
.RS 4
فایل حاوی بلاب libatasmart\&.
.RE
.RE
.PP
\fBmonitor\fR
.RS 4
دیمن را برای نظارت بر رویدادها پایش می‌کند\&.
.RE
.PP
\fBdump\fR
.RS 4
وضعیت فعلی دیمن را چاپ می‌کند\&.
.RE
.PP
\fBhelp\fR
.RS 4
راهنما را چاپ کرده و خارج می‌شود\&.
.RE
.SH "مشخص کردن دستگاه (DEVICE SPECIFICATION)"
.PP
برای دستورهایی که به عنوان آرگومان به یک دستگاه نیاز دارند، می‌توان از گزینه‌های زیر برای مشخص کردن آن استفاده کرد\&.
.PP
\fB\-b\fR, \fB\-\-block\-device=\fR\fB\fIDEVICE\fR\fR
.RS 4
مشخص کردن یک دستگاه با استفاده از مسیر فایل دستگاه آن؛ به عنوان مثال
\fI/dev/sda\fR\&.
.RE
.PP
\fB\-p\fR, \fB\-\-object\-path=\fR\fB\fIOBJECT\fR\fR
.RS 4
مشخص کردن یک دستگاه از طریق مسیر شیء داخلی UDisks بدون پیشوند /org/freedesktop/UDisks2؛ به عنوان مثال
\fIblock_devices/sda\fR
برای دیسک
/dev/sda\&.
.RE
.PP
\fB\-d\fR, \fB\-\-drive=\fR\fB\fIDRIVE\fR\fR
.RS 4
مشخص کردن یک درایو بر اساس نام، برای مثال
\fIVirtIO_Disk\fR\&.
این گزینه در حال حاضر تنها می‌تواند همراه با دستور
\fBinfo\fR
استفاده شود\&.
.RE
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.PP
گزینه
\fB\-\-no\-user\-interaction\fR
می‌تواند برای درخواست این موضوع استفاده شود که در زمان بررسی مجاز بودن فراخواننده برای انجام عمل درخواستی توسط
\fBpolkit\fR(8)\c
، هیچ تعاملی (مانند نمایش کادر محاوره‌ای احراز هویت به کاربر) رخ ندهد\&.
.SH "مخاطبان (AUDIENCE)"
.PP
این برنامه فرض نمی‌کند که فراخواننده مدیر سیستم (super user) است \- این برنامه برای استفاده توسط کاربران غیرممتاز طراحی شده و مجوزها توسط دیمن udisks با استفاده از
\fBpolkit\fR(8)
بررسی می‌شوند\&. علاوه بر این، این برنامه برای استفاده در اسکریپت‌ها یا برنامه‌های دیگر در نظر گرفته نشده است \- گزینه‌ها/دستورها ممکن است در آینده حتی در نسخه‌های نگهداری (maintenance releases) به شیوه‌هایی ناسازگار تغییر کنند\&. برای اطلاعات بیشتر بخش
\(lqAPI STABILITY\(rq
از
\fBudisks\fR(8)
را ببینید\&.
.SH "تکمیل خودکار بش (BASH COMPLETION)"
.PP
دستور
\fBudisksctl\fR
همراه با یک اسکریپت تکمیل خودکار bash برای تکمیل دستورها، شیءها، دستگاه‌های بلوکی و برخی گزینه‌ها ارائه می‌شود\&.
.SH "نویسندگان (AUTHORS)"
.PP
این صفحه راهنما در ابتدا برای UDisks2 توسط David Zeuthen
<zeuthen@gmail\&.com>
با کمک‌های فراوان دیگران نوشته شده است\&.
.SH "گزارش باگ‌ها (BUGS)"
.PP
لطفاً گزارش باگ‌ها را به سامانه ردیابی اشکالات توزیع خود یا به ردیاب اشکالات بالادستی در
\m[blue]\fB\%https://github.com/storaged-project/udisks/issues\fR\m[]
ارسال کنید\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBudisks\fR(8),
\fBudisksd\fR(8),
\fBumount.udisks2\fR(8),
\fBpolkit\fR(8)