'\" t .\" Title: usbguard .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 09/05/2026 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" .TH "USBGUARD" "1" "09/05/2026" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * 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)" usbguard \- رابط خط فرمانی USBGuard .SH "خلاصه دستور (SYNOPSIS)" .sp usbguard [OPTIONS]\ \&\ \&[SUBCOMMAND\-OPTIONS]\ \&\&... .sp usbguard get\-parameter \fIname\fR .sp usbguard set\-parameter \fIname\fR \fIvalue\fR .sp usbguard list\-devices .sp usbguard\ \&allow\-device\ \&\fIid\fR | \fIrule\fR | \fIpartial\-rule\fR .sp usbguard\ \&block\-device\ \&\fIid\fR | \fIrule\fR | \fIpartial\-rule\fR .sp usbguard\ \&reject\-device\ \&\fIid\fR | \fIrule\fR | \fIpartial\-rule\fR .sp usbguard\ \&list\-rules .sp usbguard\ \&append\-rule\ \&\fIrule\fR .sp usbguard\ \&remove\-rule\ \&\fIid\fR .sp usbguard\ \&generate\-policy .sp usbguard\ \&watch .sp usbguard read\-descriptor \fIfile\fR .sp usbguard add\-user \fIname\fR .sp usbguard remove\-user \fIname\fR .SH "توضیحات (DESCRIPTION)" .sp دستور usbguard یک رابط خط فرمانی (CLI) برای یک نمونه در حال اجرای usbguard\-daemon(8) فراهم می‌کند\&. همچنین ابزاری برای تولید سیاست‌های اولیه USBGuard بر اساس دستگاه‌های USB متصل به سیستم ارائه می‌دهد\&. .SH "زیردستورها (SUBCOMMANDS)" .SS "get\-parameter [\fIOPTIONS\fR] \fIname\fR" .sp دریافت مقدار یک پارامتر زمان اجرا\&. پارامتر \fIname\fR یکی از موارد \fIInsertedDevicePolicy\fR یا \fIImplicitPolicyTarget\fR است\&. .sp گزینه‌های در دسترس: .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "set\-parameter [\fIOPTIONS\fR] \fIname\fR \fIvalue\fR" .sp تنظیم مقدار یک پارامتر زمان اجرا\&. پارامتر \fIname\fR یکی از موارد \fIInsertedDevicePolicy\fR یا \fIImplicitPolicyTarget\fR است\&. .sp گزینه‌های در دسترس: .PP \fB\-v, \-\-verbose\fR .RS 4 چاپ مقدار قبلی و جدید مشخصه\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "list\-devices [\fIOPTIONS\fR]" .sp فهرست کردن تمام دستگاه‌های USB شناسایی‌شده توسط دیمن USBGuard\&. .sp گزینه‌های در دسترس: .PP \fB\-a, \-\-allowed\fR .RS 4 فهرست کردن دستگاه‌های مجاز\&. .RE .PP \fB\-b, \-\-blocked\fR .RS 4 فهرست کردن دستگاه‌های مسدودشده\&. .RE .PP \fB\-t, \-\-tree\fR .RS 4 فهرست کردن دستگاه‌ها در قالب درختی\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "allow\-device [\fIOPTIONS\fR] < \fIid\fR | \fIrule\fR | \fIpartial\-rule\fR >" .sp مجاز کردن یک دستگاه برای تعامل با سیستم\&. دستگاه می‌تواند به وسیله \fIid\fR، \fIrule\fR یا \fIpartial\-rule\fR (قاعده بدون هدف) شناسایی شود\&. از هر دو مورد \fIrule\fR و \fIpartial\-rule\fR می‌توان برای مجاز کردن هم‌زمان چندین دستگاه استفاده کرد\&. توجه داشته باشید که \fIid\fR به شناسه داخلی device\-rule (نخستین عدد در خروجی دستور list\-devices) اشاره دارد، نه مشخصه ID دستگاه\&. .sp گزینه‌های در دسترس: .PP \fB\-p, \-\-permanent\fR .RS 4 دائمی کردن تصمیم\&. یک قاعده allow ویژه دستگاه به سیاست فعلی ضمیمه خواهد شد\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE.SS "block\-device [\fIOPTIONS\fR] < \fIid\fR | \fIrule\fR | \fIpartial\-rule\fR >" .sp لغو مجوز یک دستگاه\&. دستگاه را می‌توان با یک \fIid\fR دستگاه، \fIrule\fR، یا \fIpartial\-rule\fR (قاعده بدون هدف) مشخص کرد\&. هر دوی \fIrule\fR و \fIpartial\-rule\fR می‌توانند برای مسدودسازی هم‌زمان چندین دستگاه استفاده شوند\&. توجه داشته باشید که \fIid\fR به شناسه داخلی قاعده دستگاه (نخستین عدد در خروجی دستور list\-devices) اشاره دارد، نه مشخصه شناسه دستگاه\&. .sp گزینه‌های موجود: .PP \fB\-p, \-\-permanent\fR .RS 4 تصمیم را دائمی می‌کند\&. یک قاعده مسدودسازی مختص دستگاه به سیاست جاری افزوده خواهد شد\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "reject\-device [\fIOPTIONS\fR] < \fIid\fR | \fIrule\fR | \fIpartial\-rule\fR >" .sp لغو مجوز و حذف یک دستگاه\&. دستگاه را می‌توان با یک \fIid\fR دستگاه، \fIrule\fR، یا \fIpartial\-rule\fR (قاعده بدون هدف) مشخص کرد\&. هر دوی \fIrule\fR و \fIpartial\-rule\fR می‌توانند برای رد کردن هم‌زمان چندین دستگاه استفاده شوند\&. توجه داشته باشید که \fIid\fR به شناسه داخلی قاعده دستگاه (نخستین عدد در خروجی دستور list\-devices) اشاره دارد، نه مشخصه شناسه دستگاه\&. .sp گزینه‌های موجود: .PP \fB\-p, \-\-permanent\fR .RS 4 تصمیم را دائمی می‌کند\&. یک قاعده رد کردن مختص دستگاه به سیاست جاری افزوده خواهد شد\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "list\-rules [\fIOPTIONS\fR]" .sp فهرست کردن مجموعه‌قواعد (سیاست) مورد استفاده توسط دیمن USBGuard\&. .sp گزینه‌های موجود: .PP \fB\-d, \-\-show\-devices\fR .RS 4 نمایش تمام دستگاه‌هایی که تحت تأثیر قاعده مشخص‌شده قرار می‌گیرند\&. .RE .PP \fB\-l, \-\-label\fR \fIlabel\fR .RS 4 تنها نمایش قواعدی که دارای یک برچسب مشخص هستند\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "append\-rule [\fIOPTIONS\fR] \fIrule\fR" .sp افزودن \fIrule\fR به مجموعه‌قواعد جاری\&. .sp گزینه‌های موجود: .PP \fB\-a, \-\-after\fR \fIid\fR .RS 4 افزودن قاعده جدید پس از قاعده‌ای با \fIid\fR قاعده مشخص‌شده\&. .RE .PP \fB\-t, \-\-temporary\fR .RS 4 تصمیم را موقتی می‌کند\&. فایل سیاست قواعد به‌روزرسانی نخواهد شد\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "remove\-rule [\fIOPTIONS\fR] \fIid\fR" .sp حذف قاعده‌ای مشخص‌شده با \fIid\fR قاعده از مجموعه‌قواعد\&. .sp گزینه‌های موجود: .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "generate\-policy [\fIOPTIONS\fR]" .sp تولید یک مجموعه‌قواعد (سیاست) که به دستگاه‌های USB متصل فعلی مجوز می‌دهد\&. .sp گزینه‌های موجود: .PP \fB\-p, \-\-with\-ports\fR .RS 4 تولید قواعد مختص درگاه برای همه دستگاه‌ها\&. به‌طور پیش‌فرض، قواعد مختص درگاه تنها برای دستگاه‌هایی تولید می‌شوند که مقدار iSerial را ارائه نمی‌دهند\&. .RE .PP \fB\-P, \-\-no\-ports\-sn\fR .RS 4 عدم تولید قواعد مختص درگاه برای دستگاه‌های بدون مقدار iSerial\&. بدون این گزینه، این ابزار یک مشخصه via\-port را به هر دستگاهی که شماره سریال ارائه ندهد می‌افزاید\&. این یک اقدام امنیتی است تا دستگاه‌هایی را که نمی‌توان به‌طور یکتا شناسایی کرد، محدود کند تا تنها از طریق یک درگاه خاص متصل شوند\&. این کار دور زدن سیاست را دشوارتر می‌کند زیرا دستگاه واقعی در بیشتر مواقع درگاه USB مجاز را اشغال خواهد کرد\&. .RE .PP \fB\-d, \-\-devpath\fR \fIdevpath\fR .RS 4 تنها برای دستگاه موجود در زیرمسیر مشخص‌شده از /sys قاعده تولید می‌کند\&. .RE .PP \fB\-t, \-\-target\fR \fItarget\fR .RS 4 یک قاعده صریح «همه‌گیر» (catch all) با هدف مشخص‌شده تولید می‌کند\&. هدف می‌تواند یکی از مقادیر زیر باشد: \fBallow\fR، \fBblock\fR، \fBreject\fR .RE .PP \fB\-X, \-\-no\-hashes\fR .RS 4 برای هر دستگاه یک مشخصه hash تولید نمی‌کند\&. .RE .PP \fB\-H, \-\-hash\-only\fR .RS 4 یک سیاست تنها بر پایه هش (hash\-only) تولید می‌کند\&. .RE .PP \fB\-L, \-\-ldif\fR .RS 4 یک سیاست ldif برای LDAP تولید می‌کند\&. .RE .PP \fB\-b, \-\-usbguardbase\fR \fIbase\fR .RS 4 یک سیاست ldif برای LDAP با این base تولید می‌کند\&. این گزینه زمانی که \-\-ldif مشخص شده باشد الزامی است\&. .RE .PP \fB\-o, \-\-objectclass\fR \fIobjectclass\fR .RS 4 یک سیاست ldif برای LDAP با این objectClass تولید می‌کند\&. .RE .PP \fB\-n, \-\-name\-prefix\fR \fIprefix\fR .RS 4 یک سیاست ldif برای LDAP با این پیشوند نام تولید می‌کند\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE.SS "watch [\fIOPTIONS\fR]" .sp رویدادهای رابط IPC را زیر نظر می‌گیرد و آن‌ها را در stdout چاپ می‌کند\&. .sp گزینه‌های موجود: .PP \fB\-w, \-\-wait\fR .RS 4 منتظر ماندن برای در دسترس قرار گرفتن اتصال IPC\&. .RE .PP \fB\-o, \-\-once\fR .RS 4 در صورت نیاز، تنها هنگام آغاز به کار منتظر می‌ماند\&. با قطع اتصال، خارج می‌شود\&. .RE .PP \fB\-e, \-\-exec\fR \fIpath\fR .RS 4 اجرای یک فایل اجرایی واقع در \fIpath\fR به ازای هر رویداد\&. داده‌های رویداد از طریق متغیرهای محیطی به فرایند ارسال می‌شوند\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "read\-descriptor [\fIOPTIONS\fR] \fIfile\fR" .sp خواندن یک توصیف‌گر USB از یک فایل و چاپ آن به قالبی خوانا برای انسان\&. .sp گزینه‌های موجود: .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .SS "add\-user \fIname\fR [\fIOPTIONS\fR]" .sp ایجاد یک فایل کنترل دسترسی IPC که به کاربر/گروه مشخص‌شده با \fIname\fR اجازه می‌دهد از گذرگاه IPC مربوط به USBGuard استفاده کند\&. این تغییرات تنها پس از راه‌اندازی مجدد نمونهٔ usbguard\-daemon(8) اعمال می‌شوند\&. .sp گزینه‌های موجود: .PP \fB\-u, \-\-user\fR .RS 4 مقدار مشخص‌شده برای \fIname\fR نمایانگر یک نام کاربری یا UID است (پیش‌فرض)\&. .RE .PP \fB\-g, \-\-group\fR .RS 4 مقدار مشخص‌شده برای \fIname\fR نمایانگر یک نام گروه یا GID است\&. .RE .PP \fB\-p, \-\-policy\fR \fIprivileges\fR .RS 4 مجوزهای مرتبط با خط‌مشی\&. .RE .PP \fB\-d, \-\-devices\fR \fIprivileges\fR .RS 4 مجوزهای مرتبط با دستگاه‌ها\&. .RE .PP \fB\-e, \-\-exceptions\fR \fIprivileges\fR .RS 4 مجوزهای مرتبط با استثناها\&. .RE .PP \fB\-P, \-\-parameters\fR \fIprivileges\fR .RS 4 مجوزهای مرتبط با پارامترهای زمان اجرا\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE .sp مجوزها: .sp انتظار می‌رود \fIprivileges\fR به صورت فهرستی جداشده با دونقطه باشد: .sp .if n \{\ .RS 4 .\} .nf $ sudo usbguard add\-user joe \-\-devices=listen,modify .fi .if n \{\ .RE .\} .sp برای مشاهدهٔ فهرست دقیق مجوزهای در دسترس در هر بخش، صفحهٔ راهنمای usbguard\-daemon\&.conf(5) را بررسی کنید\&. همچنین می‌توانید به جای \fIprivileges\fR از \fIALL\fR استفاده کنید تا تمام مجوزهای مرتبط با یک بخش مشخص به طور خودکار اختصاص یابند\&. .SS "remove\-user \fIname\fR [\fIOPTIONS\fR]" .sp حذف فایل کنترل دسترسی IPC مرتبط با کاربر/گروه مشخص‌شده توسط \fIname\fR\&. این تغییر تنها پس از راه‌اندازی مجدد نمونهٔ usbguard\-daemon(8) اعمال می‌شود\&. .sp گزینه‌های موجود: .PP \fB\-u, \-\-user\fR .RS 4 مقدار مشخص‌شده برای \fIname\fR نمایانگر یک نام کاربری یا UID است (پیش‌فرض)\&. .RE .PP \fB\-g, \-\-group\fR .RS 4 مقدار مشخص‌شده برای \fIname\fR نمایانگر یک نام گروه یا GID است\&. .RE .PP \fB\-h, \-\-help\fR .RS 4 نمایش راهنما\&. .RE.SH "مثال‌ها (EXAMPLES)" .sp ایجاد یک سیاست اولیه: .sp .if n \{\ .RS 4 .\} .nf $ 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 .fi .if n \{\ .RE .\} .sp مجاز کردن دستگاه(ها): .sp .if n \{\ .RS 4 .\} .nf # 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 \e"Dell Wired Multimedia Keyboard\e" .fi .if n \{\ .RE .\} .SH "همچنین ببینید (SEE ALSO)" .sp usbguard\-daemon(8), usbguard\-daemon\&.conf(5), usbguard\-rules\&.conf(5) .SH "گزارش باگ‌ها (BUGS)" .sp اگر باگی در این نرم‌افزار پیدا کردید یا مایلید پیاده‌سازی قابلیتی را درخواست دهید، لطفاً یک تیکت در https://github\&.com/USBGuard/usbguard/issues/new ثبت کنید\&. .SH "نویسندگان (AUTHORS)" .sp نرم‌افزار USBGuard در ابتدا توسط Daniel Kopeček نوشته شده است\&. افراد بسیاری در توسعهٔ آن مشارکت داشته‌اند\&. .SH "منابع (RESOURCES)" .sp وب‌گاه اصلی: https://usbguard\&.github\&.io .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .sp مجوز GPLv2+: گنو GPL نسخهٔ ۲ یا بالاتر http://gnu\&.org/licenses/gpl\&.html\&. این یک نرم‌افزار آزاد است: شما در تغییر و توزیع مجدد آن آزاد هستید\&. هیچ ضمانتی وجود ندارد، تا جایی که قانون اجازه می‌دهد\&.