USBGUARD(1)                                                        USBGUARD(1)

نام (NAME)
       usbguard - رابط خط فرمانی USBGuard

خلاصه دستور (SYNOPSIS)
       usbguard [OPTIONS] <subcommand> [SUBCOMMAND-OPTIONS] ...

       usbguard get-parameter name

       usbguard set-parameter name value

       usbguard list-devices

       usbguard allow-device id | rule | partial-rule

       usbguard block-device id | rule | partial-rule

       usbguard reject-device id | rule | partial-rule

       usbguard list-rules

       usbguard append-rule rule

       usbguard remove-rule id

       usbguard generate-policy

       usbguard watch

       usbguard read-descriptor file

       usbguard add-user name

       usbguard remove-user name

توضیحات (DESCRIPTION)
       دستور usbguard یک رابط خط فرمانی (CLI) برای یک نمونه در حال اجرای
       usbguard-daemon(8) فراهم می‌کند. همچنین ابزاری برای تولید سیاست‌های اولیه
       USBGuard بر اساس دستگاه‌های USB متصل به سیستم ارائه می‌دهد.

زیردستورها (SUBCOMMANDS)
   get-parameter [OPTIONS] name
       دریافت مقدار یک پارامتر زمان اجرا. پارامتر name یکی از موارد
       InsertedDevicePolicy یا ImplicitPolicyTarget است.

       گزینه‌های در دسترس:

       -h, --help
           نمایش راهنما.

   set-parameter [OPTIONS] name value
       تنظیم مقدار یک پارامتر زمان اجرا. پارامتر name یکی از موارد
       InsertedDevicePolicy یا ImplicitPolicyTarget است.

       گزینه‌های در دسترس:

       -v, --verbose
           چاپ مقدار قبلی و جدید مشخصه.

       -h, --help
           نمایش راهنما.

   list-devices [OPTIONS]
       فهرست کردن تمام دستگاه‌های USB شناسایی‌شده توسط دیمن USBGuard.

       گزینه‌های در دسترس:

       -a, --allowed
           فهرست کردن دستگاه‌های مجاز.

       -b, --blocked
           فهرست کردن دستگاه‌های مسدودشده.

       -t, --tree
           فهرست کردن دستگاه‌ها در قالب درختی.

       -h, --help
           نمایش راهنما.

   allow-device [OPTIONS] < id | rule | partial-rule >
       مجاز کردن یک دستگاه برای تعامل با سیستم. دستگاه می‌تواند به وسیله id،
       rule یا partial-rule (قاعده بدون هدف) شناسایی شود. از هر دو مورد rule و
       partial-rule می‌توان برای مجاز کردن هم‌زمان چندین دستگاه استفاده کرد.
       توجه داشته باشید که id به شناسه داخلی device-rule (نخستین عدد در خروجی
       دستور list-devices) اشاره دارد، نه مشخصه ID دستگاه.

       گزینه‌های در دسترس:

       -p, --permanent
           دائمی کردن تصمیم. یک قاعده allow ویژه دستگاه به سیاست فعلی ضمیمه
           خواهد شد.

       -h, --help
           نمایش راهنما.

           لغو مجوز یک دستگاه. دستگاه را می‌توان با یک id دستگاه، rule، یا
           partial-rule (قاعده بدون هدف) مشخص کرد. هر دوی rule و partial-rule
           می‌توانند برای مسدودسازی هم‌زمان چندین دستگاه استفاده شوند. توجه
           داشته باشید که id به شناسه داخلی قاعده دستگاه (نخستین عدد در خروجی
           دستور list-devices) اشاره دارد، نه مشخصه شناسه دستگاه.

           گزینه‌های موجود:

           -p, --permanent
               تصمیم را دائمی می‌کند. یک قاعده مسدودسازی مختص دستگاه به سیاست
               جاری افزوده خواهد شد.

           -h, --help
               نمایش راهنما.

   reject-device [OPTIONS] < id | rule | partial-rule >
       لغو مجوز و حذف یک دستگاه. دستگاه را می‌توان با یک id دستگاه، rule، یا
       partial-rule (قاعده بدون هدف) مشخص کرد. هر دوی rule و partial-rule
       می‌توانند برای رد کردن هم‌زمان چندین دستگاه استفاده شوند. توجه داشته
       باشید که id به شناسه داخلی قاعده دستگاه (نخستین عدد در خروجی دستور
       list-devices) اشاره دارد، نه مشخصه شناسه دستگاه.

       گزینه‌های موجود:

       -p, --permanent
           تصمیم را دائمی می‌کند. یک قاعده رد کردن مختص دستگاه به سیاست جاری
           افزوده خواهد شد.

       -h, --help
           نمایش راهنما.

   list-rules [OPTIONS]
       فهرست کردن مجموعه‌قواعد (سیاست) مورد استفاده توسط دیمن USBGuard.

       گزینه‌های موجود:

       -d, --show-devices
           نمایش تمام دستگاه‌هایی که تحت تأثیر قاعده مشخص‌شده قرار می‌گیرند.

       -l, --label label
           تنها نمایش قواعدی که دارای یک برچسب مشخص هستند.

       -h, --help
           نمایش راهنما.

   append-rule [OPTIONS] rule
       افزودن rule به مجموعه‌قواعد جاری.

       گزینه‌های موجود:

       -a, --after id
           افزودن قاعده جدید پس از قاعده‌ای با id قاعده مشخص‌شده.

       -t, --temporary
           تصمیم را موقتی می‌کند. فایل سیاست قواعد به‌روزرسانی نخواهد شد.

       -h, --help
           نمایش راهنما.

   remove-rule [OPTIONS] id
       حذف قاعده‌ای مشخص‌شده با id قاعده از مجموعه‌قواعد.

       گزینه‌های موجود:

       -h, --help
           نمایش راهنما.

   generate-policy [OPTIONS]
       تولید یک مجموعه‌قواعد (سیاست) که به دستگاه‌های USB متصل فعلی مجوز می‌دهد.

       گزینه‌های موجود:

       -p, --with-ports
           تولید قواعد مختص درگاه برای همه دستگاه‌ها. به‌طور پیش‌فرض، قواعد مختص
           درگاه تنها برای دستگاه‌هایی تولید می‌شوند که مقدار iSerial را ارائه
           نمی‌دهند.

       -P, --no-ports-sn
           عدم تولید قواعد مختص درگاه برای دستگاه‌های بدون مقدار iSerial. بدون
           این گزینه، این ابزار یک مشخصه via-port را به هر دستگاهی که شماره
           سریال ارائه ندهد می‌افزاید. این یک اقدام امنیتی است تا دستگاه‌هایی را
           که نمی‌توان به‌طور یکتا شناسایی کرد، محدود کند تا تنها از طریق یک
           درگاه خاص متصل شوند. این کار دور زدن سیاست را دشوارتر می‌کند زیرا
           دستگاه واقعی در بیشتر مواقع درگاه USB مجاز را اشغال خواهد کرد.

       -d, --devpath devpath
           تنها برای دستگاه موجود در زیرمسیر مشخص‌شده از /sys قاعده تولید
           می‌کند.

       -t, --target target
           یک قاعده صریح «همه‌گیر» (catch all) با هدف مشخص‌شده تولید می‌کند. هدف
           می‌تواند یکی از مقادیر زیر باشد: allow، block، reject

       -X, --no-hashes
           برای هر دستگاه یک مشخصه hash تولید نمی‌کند.

       -H, --hash-only
           یک سیاست تنها بر پایه هش (hash-only) تولید می‌کند.

       -L, --ldif
           یک سیاست ldif برای LDAP تولید می‌کند.

       -b, --usbguardbase base
           یک سیاست ldif برای LDAP با این base تولید می‌کند. این گزینه زمانی که
           --ldif مشخص شده باشد الزامی است.

       -o, --objectclass objectclass
           یک سیاست ldif برای LDAP با این objectClass تولید می‌کند.

       -n, --name-prefix prefix
           یک سیاست ldif برای LDAP با این پیشوند نام تولید می‌کند.

       -h, --help
           نمایش راهنما.

           رویدادهای رابط IPC را زیر نظر می‌گیرد و آن‌ها را در stdout چاپ می‌کند.

           گزینه‌های موجود:

           -w, --wait
               منتظر ماندن برای در دسترس قرار گرفتن اتصال IPC.

           -o, --once
               در صورت نیاز، تنها هنگام آغاز به کار منتظر می‌ماند. با قطع
               اتصال، خارج می‌شود.

           -e, --exec path
               اجرای یک فایل اجرایی واقع در path به ازای هر رویداد. داده‌های
               رویداد از طریق متغیرهای محیطی به فرایند ارسال می‌شوند.

           -h, --help
               نمایش راهنما.

   read-descriptor [OPTIONS] file
       خواندن یک توصیف‌گر USB از یک فایل و چاپ آن به قالبی خوانا برای انسان.

       گزینه‌های موجود:

       -h, --help
           نمایش راهنما.

   add-user name [OPTIONS]
       ایجاد یک فایل کنترل دسترسی IPC که به کاربر/گروه مشخص‌شده با name اجازه
       می‌دهد از گذرگاه IPC مربوط به USBGuard استفاده کند. این تغییرات تنها پس
       از راه‌اندازی مجدد نمونهٔ usbguard-daemon(8) اعمال می‌شوند.

       گزینه‌های موجود:

       -u, --user
           مقدار مشخص‌شده برای name نمایانگر یک نام کاربری یا UID است (پیش‌فرض).

       -g, --group
           مقدار مشخص‌شده برای name نمایانگر یک نام گروه یا GID است.

       -p, --policy privileges
           مجوزهای مرتبط با خط‌مشی.

       -d, --devices privileges
           مجوزهای مرتبط با دستگاه‌ها.

       -e, --exceptions privileges
           مجوزهای مرتبط با استثناها.

       -P, --parameters privileges
           مجوزهای مرتبط با پارامترهای زمان اجرا.

       -h, --help
           نمایش راهنما.

       مجوزها:

       انتظار می‌رود privileges به صورت فهرستی جداشده با دونقطه باشد:

               $ sudo usbguard add-user joe --devices=listen,modify

       برای مشاهدهٔ فهرست دقیق مجوزهای در دسترس در هر بخش، صفحهٔ راهنمای
       usbguard-daemon.conf(5) را بررسی کنید. همچنین می‌توانید به جای
       privileges از ALL استفاده کنید تا تمام مجوزهای مرتبط با یک بخش مشخص به
       طور خودکار اختصاص یابند.

   remove-user name [OPTIONS]
       حذف فایل کنترل دسترسی IPC مرتبط با کاربر/گروه مشخص‌شده توسط name. این
       تغییر تنها پس از راه‌اندازی مجدد نمونهٔ usbguard-daemon(8) اعمال می‌شود.

       گزینه‌های موجود:

       -u, --user
           مقدار مشخص‌شده برای name نمایانگر یک نام کاربری یا UID است (پیش‌فرض).

       -g, --group
           مقدار مشخص‌شده برای name نمایانگر یک نام گروه یا GID است.

       -h, --help
           نمایش راهنما.

           ایجاد یک سیاست اولیه:

                   $ sudo usbguard generate-policy > rules.conf
                   $ vi rules.conf
                   (review/modify the rule set)
                   $ sudo install -m 0600 -o root -g root rules.conf /etc/usbguard/rules.conf
                   $ sudo systemctl restart usbguard

           مجاز کردن دستگاه(ها):

                   # Allow a device by ID(it is the very first number from the list-devices command output)
                   $ sudo usbguard allow-device 10
                   # Allow all devices named "Dell Wired Multimedia Keyboard"
                   $ sudo usbguard allow-device name \"Dell Wired Multimedia Keyboard\"

همچنین ببینید (SEE ALSO)
       usbguard-daemon(8), usbguard-daemon.conf(5), usbguard-rules.conf(5)

گزارش باگ‌ها (BUGS)
       اگر باگی در این نرم‌افزار پیدا کردید یا مایلید پیاده‌سازی قابلیتی را
       درخواست دهید، لطفاً یک تیکت در
       https://github.com/USBGuard/usbguard/issues/new ثبت کنید.

نویسندگان (AUTHORS)
       نرم‌افزار USBGuard در ابتدا توسط Daniel Kopeček نوشته شده است. افراد
       بسیاری در توسعهٔ آن مشارکت داشته‌اند.

منابع (RESOURCES)
       وب‌گاه اصلی: https://usbguard.github.io

کپی‌رایت و تکثیر (COPYRIGHT)
       مجوز GPLv2+: گنو GPL نسخهٔ ۲ یا بالاتر http://gnu.org/licenses/gpl.html.
       این یک نرم‌افزار آزاد است: شما در تغییر و توزیع مجدد آن آزاد هستید. هیچ
       ضمانتی وجود ندارد، تا جایی که قانون اجازه می‌دهد.

                                  09/05/2026                       USBGUARD(1)