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

-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

-t, --temporary

-h, --help

remove-rule [OPTIONS] id

حذف قاعده‌ای مشخص‌شده با id قاعده از مجموعه‌قواعد.

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

-h, --help

generate-policy [OPTIONS]

تولید یک مجموعه‌قواعد (سیاست) که به دستگاه‌های USB متصل فعلی مجوز می‌دهد.

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

-p, --with-ports

-P, --no-ports-sn

-d, --devpath devpath

-t, --target target

-X, --no-hashes

-H, --hash-only

-L, --ldif

-b, --usbguardbase base

-o, --objectclass objectclass

-n, --name-prefix prefix

-h, --help

read-descriptor [OPTIONS] file

خواندن یک توصیف‌گر USB از یک فایل و چاپ آن به قالبی خوانا برای انسان.

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

-h, --help

add-user name [OPTIONS]

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

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

-u, --user

-g, --group

-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

-g, --group

-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\"