'\" t .\" Title: udiskie .\" Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/07/2026 .\" Manual: udiskie .\" Source: udiskie .\" Language: English .\" .TH "UDISKIE" "8" "08/07/2026" "udiskie" "udiskie" .\" ----------------------------------------------------------------- .\" * 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)" udiskie \- سوارکننده خودکار برای رسانه‌های جداشدنی .SH "خلاصه دستور (SYNOPSIS)" .sp \fIudiskie\fR [OPTIONS] .sp \fIudiskie\-mount\fR [OPTIONS] (\-a | DEVICE\&...) .sp \fIudiskie\-umount\fR [OPTIONS] (\-a | PATH\&...) .SH "توضیحات (DESCRIPTION)" .sp برنامه \fBudiskie\fR یک رابط کاربری برای udisks2 است که با پایتون نوشته شده است. هدف اصلی آن سوار کردن خودکار رسانه‌های جداشدنی مانند دیسک‌های نوری (CD) یا فلش مموری‌ها است. این برنامه دارای اعلان‌های اختیاری سوار شدن، نماد سینی سیستم (tray) مبتنی بر GTK و ابزارهای خط فرمان سطح کاربر برای عملیات دستی سوار کردن و پیاده کردن است. رسانه در دایرکتوری جدیدی در \fI/media\fR یا \fI/run/media/USER/\fR با استفاده از نام دستگاه در صورت امکان سوار خواهد شد. .SH "گزینه‌های عمومی (COMMON OPTIONS)" .PP \fB\-h, \-\-help\fR .RS 4 نمایش پیام راهنما و خروج\&. .RE .PP \fB\-V, \-\-version\fR .RS 4 نمایش نسخه و خروج\&. .RE .PP \fB\-v, \-\-verbose\fR .RS 4 خروجی با جزئیات کامل\&. .RE .PP \fB\-q, \-\-quiet\fR .RS 4 خروجی بی‌صدا (حداقل پیام‌ها)\&. .RE .PP \fB\-c FILE, \-\-config=FILE\fR .RS 4 تعیین فایل پیکربندی\&. .RE .PP \fB\-C, \-\-no\-config\fR .RS 4 عدم استفاده از هیچ فایل پیکربندی\&. .RE .SH "گزینه‌های مشترک سوار کردن و دیمن (SHARED MOUNT AND DAEMON OPTIONS)" .PP \fB\-p COMMAND, \-\-password\-prompt=COMMAND\fR .RS 4 دستور دریافت گذرواژه. رشته با ویژگی‌های دستگاه به عنوان آرگومان‌های کلیدی قالب‌بندی می‌شود، به عنوان مثال: .sp .if n \{\ .RS 4 .\} .nf \-p "zenity \-\-entry \-\-hide\-text \-\-text \*(AqEnter password for {device_presentation}:\*(Aq" .fi .if n \{\ .RE .\} .RE .PP \fB\-P, \-\-no\-password\-prompt\fR .RS 4 غیرفعال کردن قفل‌گشایی دستگاه‌های LUKS\&. .RE .SH "گزینه‌های دیمن (DAEMON OPTIONS)" .PP \fB\-a, \-\-automount\fR .RS 4 فعال‌سازی سوار کردن خودکار دستگاه‌های جدید (پیش‌فرض)\&. .RE .PP \fB\-A, \-\-no\-automount\fR .RS 4 غیرفعال کردن سوار کردن خودکار دستگاه‌های جدید\&. .RE .PP \fB\-n, \-\-notify\fR .RS 4 فعال‌سازی اعلان‌های پنجره‌ای (pop\-up) (پیش‌فرض)\&. .RE .PP \fB\-N, \-\-no\-notify\fR .RS 4 غیرفعال کردن اعلان‌های پنجره‌ای\&. .RE .PP \fB\-t, \-\-tray\fR .RS 4 نمایش نماد در سینی سیستم (tray)\&. .RE .PP \fB\-s, \-\-smart\-tray\fR .RS 4 نمایش نماد سینی هوشمند که در صورت نبود عملیات در دسترس، به صورت خودکار پنهان می‌شود\&. .RE .PP \fB\-T, \-\-no\-tray\fR .RS 4 غیرفعال کردن نماد سینی سیستم (پیش‌فرض)\&. .RE .PP \fB\-f PROGRAM, \-\-file\-manager=PROGRAM\fR .RS 4 تعیین برنامه برای باز کردن دایرکتوری‌های سوارشده. پیش‌فرض \*(Aqxdg\-open\*(Aq است. برای غیرفعال کردن این ویژگی یک رشته خالی ارسال کنید\&. .RE .PP \fB\-F, \-\-no\-file\-manager\fR .RS 4 غیرفعال کردن مرور فایل‌ها\&. .RE .PP \fB\-\-terminal=PROGRAM\fR .RS 4 تنظیم خط فرمان ترمینال برای باز کردن دایرکتوری‌های سوارشده. پیش‌فرض هیچ است! برای غیرفعال کردن این ویژگی یک رشته خالی ارسال کنید\&. .RE .PP \fB\-\-no\-terminal\fR .RS 4 غیرفعال کردن اقدام ترمینال\&. .RE .PP \fB\-\-appindicator\fR .RS 4 استفاده از AppIndicator3 برای نماد وضعیت. اگر در Ubuntu/Unity نمادی نشان داده نمی‌شود از این گزینه استفاده کنید\&. .RE .PP \fB\-\-no\-appindicator\fR .RS 4 استفاده از Gtk\&.StatusIcon برای نماد وضعیت (پیش‌فرض)\&. .RE .PP \fB\-\-password\-cache MINUTES\fR .RS 4 ذخیره موقت گذرواژه‌ها برای پارتیشن‌های LUKS در حافظه موقت و تنظیم زمان انقضا بر حسب دقیقه\&. .RE .PP \fB\-\-no\-password\-cache\fR .RS 4 عدم ذخیره گذرواژه‌ها در حافظه موقت (پیش‌فرض)\&. .RE .PP \fB\-\-event\-hook COMMAND\fR .RS 4 دستور برای اجرا هنگام رویدادهای دستگاه. رشته دستور با استفاده از نام رویداد و فهرستی از ویژگی‌های دستگاه قالب‌بندی می‌شود (به زیر مراجعه کنید)، به عنوان مثال: .sp .if n \{\ .RS 4 .\} .nf \-\-event\-hook "zenity \-\-info \-\-text \*(Aq{event}: {device_presentation}\*(Aq" .fi .if n \{\ .RE .\} .RE .PP \fB\-\-no\-event\-hook\fR .RS 4 بدون دستور اعلان رویداد (پیش‌فرض)\&. .RE .SH "گزینه‌های سوار کردن (MOUNT OPTIONS)" .PP \fB\-a, \-\-all\fR .RS 4 سوار کردن تمامی دستگاه‌های مدیریت‌شده\&. .RE .PP \fB\-r, \-\-recursive\fR .RS 4 سوار کردن بازگشتی پارتیشن‌های متن‌آشکار (cleartext) پس از قفل‌گشایی یک دستگاه LUKS. این عمل هنگام اجرای دیمن udiskie به صورت پیش‌فرض رخ می‌دهد\&. .RE .PP \fB\-R, \-\-no\-recursive\fR .RS 4 غیرفعال کردن سوار کردن بازگشتی (پیش‌فرض)\&. .RE .PP \fB\-o OPTIONS, \-\-options=OPTIONS\fR .RS 4 تنظیم گزینه‌های سوار کردن (mount options)\&. .RE .SH "گزینه‌های پیاده کردن (UNMOUNT OPTIONS)" .PP \fB\-a, \-\-all\fR .RS 4 پیاده کردن تمامی دستگاه‌های مدیریت‌شده\&. .RE .PP \fB\-d, \-\-detach\fR .RS 4 جدا کردن درایو، به عنوان مثال با قطع برق درگاه فیزیکی آن\&. .RE .PP \fB\-D, \-\-no\-detach\fR .RS 4 عدم قطع برق و جداسازی درایو (پیش‌فرض)\&. .RE .PP \fB\-e, \-\-eject\fR .RS 4 بیرون دادن رسانه از درایو، مانند CDROM\&. .RE .PP \fB\-E, \-\-no\-eject\fR .RS 4 عدم بیرون دادن رسانه (پیش‌فرض)\&. .RE .PP \fB\-f, \-\-force\fR .RS 4 جداسازی اجباری (پیاده کردن بازگشتی)\&. .RE .PP \fB\-F, \-\-no\-force\fR .RS 4 عدم اجبار در جداسازی (پیش‌فرض)\&. .RE .PP \fB\-l, \-\-lock\fR .RS 4 قفل کردن دستگاه پس از پیاده کردن (پیش‌فرض)\&. .RE .PP \fB\-L, \-\-no\-lock\fR .RS 4 عدم قفل کردن دستگاه\&. .RE .SH "مثال‌های استفاده (EXAMPLE USAGE)" .sp اجرای \fBudiskie\fR در \fI~/\&.xinitrc\fR: .sp .if n \{\ .RS 4 .\} .nf udiskie & .fi .if n \{\ .RE .\} .sp پیاده کردن رسانه و خاموش کردن درگاه دستگاه USB: .sp .if n \{\ .RS 4 .\} .nf udiskie\-umount \-\-detach /media/Sticky .fi .if n \{\ .RE .\} .sp سوار کردن تمام رسانه‌ها: .sp .if n \{\ .RS 4 .\} .nf udiskie\-mount \-a .fi .if n \{\ .RE .\} .sp سوار کردن \fI/dev/sdb1\fR: .sp .if n \{\ .RS 4 .\} .nf udiskie\-mount /dev/sdb1 .fi .if n \{\ .RE .\} .SH "پیکربندی (CONFIGURATION)" .sp فایل \fI\&.config/udiskie/config\&.yml\fR می‌تواند برای پیکربندی مقادیر پیش‌فرض پارامترهای خط فرمان و سفارشی‌سازی تنظیمات بیشتر استفاده شود. مسیر واقعی بسته به \fI$XDG_CONFIG_HOME\fR ممکن است متفاوت باشد. قالب فایل YAML است؛ به https://en\&.wikipedia\&.org/wiki/YAML مراجعه کنید. اگر نمی‌خواهید PyYAML را نصب کنید، می‌توان از فایل معادل JSON با نام \fIconfig\&.json\fR استفاده کرد. .sp .if n \{\ .RS 4 .\} .nf # This is an example (nonsense) configuration file for udiskie\&. program_options: # Configure defaults for command line options tray: auto # [bool] Enable the tray icon\&. "auto" # means auto\-hide the tray icon when # there are no handled devices\&. menu: flat # ["flat" | "nested"] Set the # systray menu behaviour\&. automount: false # [bool] Enable automatic mounting\&. notify: true # [bool] Enable notifications\&. password_cache: 30 # [int] Password cache in minutes\&. Caching is # disabled by default\&. It can be disabled # explicitly by setting it to false file_manager: xdg\-open # [string] Set program to open directories\&. It will be invoked # with the folder path as its last command line argument\&. terminal: \*(Aqtermite \-d\*(Aq # [string] Set terminal command line to open directories\&. It will be # invoked with the folder path as its last command line argument\&. password_prompt: ["gnome\-keyring\-query", "get", "{id_uuid}"] # [string|list] Set command to retrieve passwords\&. If specified # as a list it defines the ARGV array for the program call\&. If # specified as a string, it will be expanded in a shell\-like # manner\&. Each string will be formatted using `str\&.format`\&. For a # list of device attributes, see below\&. The two special string values # "builtin:gui" and "builtin:tty" signify to use udiskie\*(Aqs # builtin password prompt\&. event_hook: "zenity \-\-info \-\-text \*(Aq{event}: {device_presentation}\*(Aq" # [string|list] Set command to be executed on any device event\&. # This is specified like `password_prompt`\&. device_config: # List of device option rules\&. Each item can match any combination of device # attributes\&. Additionally, it defines the resulting action (see below)\&. # Any rule can contain multiple filters (AND) and multiple actions\&. # Only the first matching rule that defines a given action is used\&. # The rules defined here are simply prepended to the builtin device rules, # so that it is possible to completely overwrite the defaults by specifying # a catch\-all rule (i\&.e\&. a rule without device attributes)\&. # Filter rules can be passed a list of values, in which case the rule is matched # if the attribute matches any of the values in the list\&. \- device_file: /dev/dm\-5 # [filter] ignore: false # [action] never ignore this device \- id_uuid: # [filter] match by device UUID \- 9d53\-13ba # This rule matches on either of these uids \- 8675\-309a options: [noexec, nodev] # [action] mount options can be given as list ignore: false # [action] never ignore this device (even if fs=FAT) automount: false # [action] do not automount this device \- id_type: vfat # [filter] match file system type ignore: true # [action] ignore all FAT devices \- id_type: ntfs # [filter] (optional) skip: true # [action] skip all further (even builtin) rules # for all matched devices, and resolve action result # on parent device \- ignore: true # never mount/unmount or even show this in the GUI automount: false # show but do not automount this device options: [] # additional options to be passed when mounting \- id_uuid: \&.\&.\&. # [filter] match device by UUID keyfile: /path/to/keyfile # [action] use keyfile to unlock a luks encrypted # device, bypassing the password prompt mount_options: # [deprecated] do not use ignore_device: # [deprecated] do not use notifications: # Customize which notifications are shown for how long\&. Possible # values are: # positive number timeout in seconds # false disable # \-1 use the libnotify default timeout timeout: 1\&.5 # set the default for all notifications # Specify only if you want to overwrite the default: device_mounted: 5 # mount notification device_unmounted: false # unmount notification device_added: false # device has appeared device_removed: false # device has disappeared device_unlocked: \-1 # encrypted device was unlocked device_locked: \-1 # encrypted device was locked job_failed: \-1 # mount/unlock/\&.\&. has failed quickmenu_actions: [mount, unmount, unlock, terminal, detach, delete] # List of actions to be shown in the quickmenu or the special value \*(Aqall\*(Aq\&. # The quickmenu is shown on left\-click if using flat menu type\&. notification_actions: # Define which actions should be shown on notifications\&. Note that there # are currently only a limited set of actions available for each # notification\&. Events that are not explicitly specified show the default # set of actions\&. Specify an empty list if you don\*(Aqt want to see any # notification for the specified event: device_mounted: [browse] device_added: [mount] icon_names: # Customize the icon set used by the tray widget\&. Each entry # specifies a list of icon names\&. The first installed icon from # that list will be used\&. media: [drive\-removable\-media, media\-optical] browse: [document\-open, folder\-open] terminal: [terminal, terminator, xfce\-terminal] mount: [udiskie\-mount] unmount: [udiskie\-unmount] unlock: [udiskie\-unlock] lock: [udiskie\-lock] eject: [udiskie\-eject, media\-eject] detach: [udiskie\-detach] delete: [udiskie\-eject] quit: [application\-exit] .fi .if n \{\ .RE .\} .sp تمامی کلیدها اختیاری هستند. در صورت عدم تعیین، مقادیر پیش‌فرض منطقی اعمال می‌شوند. .SH "ویژگی‌های دستگاه (DEVICE ATTRIBUTES)" .sp برخی از ورودی‌های پیکربندی از ویژگی‌های دستگاه استفاده می‌کنند. فهرست زیر از ویژگی‌ها در حال حاضر در دسترس است، اما هیچ تضمینی برای در دسترس ماندن همیشگی آن‌ها وجود ندارد: .sp .if n \{\ .RS 4 .\} .nf Attribute Hint/Example .fi .if n \{\ .RE .\} .sp .if n \{\ .RS 4 .\} .nf is_drive is_block is_partition_table is_partition is_filesystem is_luks is_loop is_toplevel is_detachable is_ejectable has_media device_file block device path, e\&.g\&. "/dev/sdb1" device_presentation display string, e\&.g\&. "/dev/sdb1" device_size block device size device_id unique, persistent device identifier id_usage E\&.g\&. "filesystem" or "crypto" is_crypto is_ignored id_type E\&.g\&. "ext4" or "crypto_LUKS" id_label device label id_uuid device UUID is_luks_cleartext is_external udisks flag HintSystem=false is_systeminternal udisks flag HintSystem=true is_mounted mount_paths list of mount paths mount_path any mount path is_unlocked in_use device or any of its children mounted should_automount ui_label loop_file file backing the loop device setup_by_uid user that setup the loop device autoclear automatically delete loop device after use symlinks drive_model drive_vendor drive_label ui_device_label ui_device_presentation ui_id_label ui_id_uuid .fi .if n \{\ .RE .\} .SH "همچنین ببینید (SEE ALSO)" .sp \fBudisks\fR(1) .sp https://www\&.freedesktop\&.org/wiki/Software/udisks .SH "تماس (CONTACT)" .sp می‌توانید برای گزارش هرگونه مشکل، پرسیدن سوالات عمومی یا پیشنهاد ویژگی‌های جدید از بخش مسائل گیت‌هاب استفاده کنید. اگر گیت‌هاب ندارید یا ترجیح نمی‌دهید، می‌توانید از طریق ایمیل تماس بگیرید: .sp https://github\&.com/coldfix/udiskie/issues .sp thomas@coldfix\&.de