'\" t
.TH "UDEVADM" "8" "" "systemd 257.13" "udevadm"
.\" -----------------------------------------------------------------
.\" * 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)"
udevadm \- ابزار مدیریت و خطایابی دستگاه‌های udev
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBudevadm\fR\ 'u
\fBudevadm\fR [\fB\-\-debug\fR] [\fB\-\-version\fR] [\fB\-\-help\fR]
.HP \w'\fBudevadm\ info\ \fR\fB[options]\fR\fB\ \fR\fB[devpath]\fR\ 'u
\fBudevadm info \fR\fB[options]\fR\fB \fR\fB[devpath]\fR
.HP \w'\fBudevadm\ trigger\ \fR\fB[options]\fR\fB\ \fR\fB[devpath]\fR\ 'u
\fBudevadm trigger \fR\fB[options]\fR\fB \fR\fB[devpath]\fR
.HP \w'\fBudevadm\ settle\ \fR\fB[options]\fR\ 'u
\fBudevadm settle \fR\fB[options]\fR
.HP \w'\fBudevadm\ control\ \fR\fB\fIoption\fR\fR\ 'u
\fBudevadm control \fR\fB\fIoption\fR\fR
.HP \w'\fBudevadm\ monitor\ \fR\fB[options]\fR\ 'u
\fBudevadm monitor \fR\fB[options]\fR
.HP \w'\fBudevadm\ test\ \fR\fB[options]\fR\fB\ \fR\fB\fIdevpath\fR\fR\ 'u
\fBudevadm test \fR\fB[options]\fR\fB \fR\fB\fIdevpath\fR\fR
.HP \w'\fBudevadm\ test\-builtin\ \fR\fB[options]\fR\fB\ \fR\fB\fIcommand\fR\fR\fB\ \fR\fB\fIdevpath\fR\fR\ 'u
\fBudevadm test\-builtin \fR\fB[options]\fR\fB \fR\fB\fIcommand\fR\fR\fB \fR\fB\fIdevpath\fR\fR
.HP \w'\fBudevadm\ verify\fR\ 'u
\fBudevadm verify\fR [options...] [\fIfile\fR...]
.HP \w'\fBudevadm\ wait\ \fR\fB[options]\fR\fB\ \fR\fB\fIdevice|syspath\fR\fR\ 'u
\fBudevadm wait \fR\fB[options]\fR\fB \fR\fB\fIdevice|syspath\fR\fR
.HP \w'\fBudevadm\ lock\ \fR\fB[options]\fR\fB\ \fR\fB\fIcommand\fR\fR\ 'u
\fBudevadm lock \fR\fB[options]\fR\fB \fR\fB\fIcommand\fR\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBudevadm\fR
انتظار یک فرمان و گزینه‌های ویژه آن فرمان را دارد\&. این ابزار رفتار زمان اجرای
\fBsystemd\-udevd\fR
را کنترل می‌کند، رویدادهای هسته را درخواست می‌نماید، صف رویدادها را مدیریت می‌کند و سازوکارهای اشکال‌زدایی ساده‌ای را فراهم می‌سازد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-d\fR, \fB\-\-debug\fR
.RS 4
چاپ پیام‌های اشکال‌زدایی در خطای استاندارد (stderr)\&. این گزینه در فرمان‌های
\fBudevadm test\fR
و
\fBudevadm test\-builtin\fR
به صورت ضمنی فعال است\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.SS "udevadm info [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]"
.PP
پرس‌وجوی پایگاه داده udev برای دریافت اطلاعات دستگاه\&.
.PP
آرگومان‌های مکانی باید برای مشخص کردن یک یا چند دستگاه استفاده شوند\&. هر کدام می‌توانند یک نام دستگاه باشند (که در این صورت باید با
/dev/
شروع شود)، یک مسیر sys (که در این صورت باید با
/sys/
شروع شود)، یا نام یک واحد دستگاه systemd (که در این صورت باید به
"\&.device"
ختم شود، به
\fBsystemd.device\fR(5)
مراجعه کنید)\&.
.PP
\fB\-q\fR, \fB\-\-query=\fR\fB\fITYPE\fR\fR
.RS 4
پرس‌وجوی پایگاه داده برای نوع مشخص‌شده از داده‌های دستگاه\&. مقادیر مجاز برای
\fITYPE\fR
عبارتند از:
\fBname\fR،
\fBsymlink\fR،
\fBpath\fR،
\fBproperty\fR،
\fBall\fR\&.
.RE
.PP
\fB\-\-property=\fR\fB\fINAME\fR\fR
.RS 4
هنگام نمایش ویژگی‌های دستگاه با استفاده از گزینه
\fB\-\-query=property\fR،
نمایش را به ویژگی‌های مشخص‌شده در آرگومان محدود می‌کند\&. آرگومان باید فهرستی از نام‌های ویژگی‌ها باشد که با ویرگول از هم جدا شده‌اند\&. در صورت عدم تعیین، همه ویژگی‌های شناخته‌شده نمایش داده می‌شوند\&.
.sp
در نسخه 250 اضافه شد\&.
.RE
.PP
\fB\-\-value\fR
.RS 4
هنگام نمایش ویژگی‌های دستگاه با استفاده از گزینه
\fB\-\-query=property\fR،
فقط مقادیر آن‌ها را چاپ کرده و از نام ویژگی و
"="
صرف‌نظر می‌کند\&.
.sp
نمی‌تواند همراه با
\fB\-x/\-\-export\fR
یا
\fB\-P/\-\-export\-prefix\fR
استفاده شود\&.
.sp
در نسخه 250 اضافه شد\&.
.RE
.PP
\fB\-p\fR, \fB\-\-path=\fR\fB\fIDEVPATH\fR\fR
.RS 4
مسیر
/sys/
دستگاه مورد پرس‌وجو، برای مثال
[/sys/]/class/block/sda\&. این گزینه جایگزینی برای آرگومان مکانی با پیشوند
/sys/
است\&. دستور
\fBudevadm info \-\-path=/class/block/sda\fR
معادل
\fBudevadm info /sys/class/block/sda\fR
است\&.
.RE
.PP
\fB\-n\fR, \fB\-\-name=\fR\fB\fIFILE\fR\fR
.RS 4
نام گره دستگاه یا پیوند نمادین (symlink) مورد پرس‌وجو، برای مثال
[/dev/]/sda\&. این گزینه جایگزینی برای آرگومان مکانی با پیشوند
/dev/
است\&. دستور
\fBudevadm info \-\-name=sda\fR
معادل
\fBudevadm info /dev/sda\fR
است\&.
.RE
.PP
\fB\-r\fR, \fB\-\-root\fR
.RS 4
چاپ مسیرهای مطلق در پرس‌وجوی
\fBname\fR
یا
\fBsymlink\fR\&.
.RE
.PP
\fB\-a\fR, \fB\-\-attribute\-walk\fR
.RS 4
چاپ تمام ویژگی‌های sysfs دستگاه مشخص‌شده که می‌توان از آن‌ها در قوانین udev برای تطبیق با دستگاه مورد نظر استفاده کرد\&. این گزینه تمام دستگاه‌های موجود در طول زنجیره را تا ریشه sysfs که در قوانین udev قابل استفاده هستند چاپ می‌کند\&.
.sp
این سوییچ از حالت خروجی JSON پشتیبانی می‌کند (به
\fB\-\-json=\fR
در زیر مراجعه کنید)\&. توجه داشته باشید از آنجا که این سوییچ چندین شیء JSON تولید می‌کند، حالت JSON\-SEQ به طور خودکار فعال می‌شود (RFC7464)\&. (نکته: ابزارهایی مانند
\m[blue]\fBjq\fR\m[]\&\s-2\u[1]\d\s+2
به صورت بومی از JSON\-SEQ از طریق سوییچ
\fB\-\-seq\fR
پشتیبانی می‌کنند\&.)
.RE
.PP
\fB\-t\fR, \fB\-\-tree\fR
.RS 4
نمایش درخت sysfs\&. این گزینه به صورت بازگشتی سلسله‌مراتب sysfs را پیمایش کرده و آن را در یک ساختار درختی نمایش می‌دهد\&. اگر مسیری مشخص شود، تنها زیردرخت زیر آن و دایرکتوری‌های والد آن نمایش داده می‌شوند\&. این کار هم موارد دستگاه و هم زیرسیستم را نشان خواهد داد\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-x\fR, \fB\-\-export\fR
.RS 4
چاپ خروجی به صورت جفت‌های کلید/مقدار\&. مقادیر در داخل گیومه تکی (single quotes) قرار می‌گیرند\&. این گزینه تنها زمانی تأثیر دارد که
\fB\-\-query=property\fR
یا
\fB\-\-device\-id\-of\-file=\fR\fB\fIFILE\fR\fR
مشخص شده باشد\&.
.RE
.PP
\fB\-P\fR, \fB\-\-export\-prefix=\fR\fB\fINAME\fR\fR
.RS 4
افزودن یک پیشوند به نام کلید مقادیر صادرشده\&. این گزینه مستلزم
\fB\-\-export\fR
است\&.
.RE
.PP
\fB\-d\fR, \fB\-\-device\-id\-of\-file=\fR\fB\fIFILE\fR\fR
.RS 4
چاپ شماره‌های اصلی/فرعی (major/minor) دستگاه زیرین که پرونده روی آن قرار دارد\&. اگر این گزینه مشخص شود، تمام آرگومان‌های مکانی نادیده گرفته می‌شوند\&.
.RE
.PP
\fB\-e\fR, \fB\-\-export\-db\fR
.RS 4
برون‌بری محتوای پایگاه داده udev\&.
.RE
.PP
\fB\-c\fR, \fB\-\-cleanup\-db\fR
.RS 4
پاک‌سازی پایگاه داده udev\&.
.RE
.PP
\fB\-w\fR\fB[SECONDS]\fR, \fB\-\-wait\-for\-initialization\fR\fB[=SECONDS]\fR
.RS 4
انتظار برای مقداردهی اولیه دستگاه\&. اگر آرگومان
\fISECONDS\fR
مشخص نشود، حالت پیش‌فرض انتظار همیشگی است\&.
.sp
در نسخه 243 اضافه شد\&.
.RE
.PP
\fB\-\-subsystem\-match\fR\fB[=SUBSYSTEM]\fR, \fB\-\-subsystem\-nomatch\fR\fB[=SUBSYSTEM]\fR
.RS 4
هنگام استفاده همراه با
\fB\-\-export\-db\fR،
به ترتیب تنها دستگاه‌های متعلق به زیرسیستم داده‌شده یا غیر از آن را نشان می‌دهد\&.
.sp
در نسخه 255 اضافه شد\&.
.RE
.PP
\fB\-\-attr\-match\fR\fB[=FILE[=VALUE]]\fR, \fB\-\-attr\-nomatch\fR\fB[=FILE[=VALUE]]\fR
.RS 4
هنگام استفاده همراه با
\fB\-\-export\-db\fR،
به ترتیب تنها دستگاه‌هایی را نشان می‌دهد که با ویژگی مشخص‌شده تطابق دارند یا ندارند\&.
.sp
در نسخه 255 اضافه شد\&.
.RE
.PP
\fB\-\-property\-match\fR\fB[=KEY=VALUE]\fR
.RS 4
هنگام استفاده همراه با
\fB\-\-export\-db\fR،
تنها دستگاه‌هایی را نشان می‌دهد که با ویژگی و مقدار داده‌شده مطابقت دارند\&.
.sp
در نسخه 255 اضافه شد\&.
.RE
.PP
\fB\-\-tag\-match\fR\fB[=TAG]\fR
.RS 4
هنگام استفاده همراه با
\fB\-\-export\-db\fR،
تنها دستگاه‌های دارای برچسب (tag) داده‌شده را نشان می‌دهد\&.
.sp
در نسخه 255 اضافه شد\&.
.RE
.PP
\fB\-\-sysname\-match\fR\fB[=NAME]\fR
.RS 4
هنگام استفاده همراه با
\fB\-\-export\-db\fR،
تنها دستگاه‌های دارای مسیر
"/sys"
داده‌شده را نشان می‌دهد\&.
.sp
در نسخه 255 اضافه شد\&.
.RE
.PP
\fB\-\-name\-match\fR\fB[=NAME]\fR
.RS 4
هنگام استفاده همراه با
\fB\-\-export\-db\fR،
تنها دستگاه‌های دارای نام داده‌شده در
"/dev"
را نشان می‌دهد\&.
.sp
در نسخه 255 اضافه شد\&.
.RE
.PP
\fB\-\-parent\-match\fR\fB[=NAME]\fR
.RS 4
هنگام استفاده همراه با
\fB\-\-export\-db\fR،
تنها دستگاه‌های دارای دستگاه والد داده‌شده را نشان می‌دهد\&.
.sp
در نسخه 255 اضافه شد\&.
.RE
.PP
\fB\-\-initialized\-match\fR, \fB\-\-initialized\-nomatch\fR
.RS 4
هنگام استفاده همراه با
\fB\-\-export\-db\fR،
به ترتیب تنها دستگاه‌هایی را نشان می‌دهد که مقداردهی اولیه شده‌اند یا نشده‌اند\&.
.sp
در نسخه 255 اضافه شد\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
نمایش خروجی با قالب‌بندی JSON\&. یکی از مقادیر زیر را می‌پذیرد:
"short"
(برای کوتاه‌ترین خروجی ممکن بدون هیچ‌گونه فاصله اضافی یا شکست خط)،
"pretty"
(برای نسخه مرتب با تورفتگی و شکست خط) یا
"off"
(برای غیرفعال کردن خروجی JSON، حالت پیش‌فرض)\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) لوله نکن\&.
.RE
.PP
خروجی تولیدشده مدخل فعلی پایگاه داده دستگاه را در قالبی مختصر نشان می‌دهد\&. در ابتدای هر خط نمایش‌داده‌شده یکی از نویسه‌های زیر به عنوان پیشوند قرار می‌گیرد:
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B جدول\ \&۱.\ \&پیشوندهای خروجی udevadm info
.TS
allbox tab(:);
lB lB.
T{
پیشوند
T}:T{
مفهوم
T}
.T&
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l
l l.
T{
"P:"
T}:T{
مسیر دستگاه در /sys/
T}
T{
"M:"
T}:T{
نام دستگاه در /sys/ (یعنی آخرین مؤلفه "P:")
T}
T{
"R:"
T}:T{
شماره دستگاه در /sys/ (یعنی پسوند عددی آخرین مؤلفه "P:")
T}
T{
"J:"
T}:T{
شناسه دستگاه
T}
T{
"U:"
T}:T{
زیرسیستم هسته
T}
T{
"B:"
T}:T{
زیرسیستم درایور
T}
T{
"T:"
T}:T{
نوع دستگاه هسته در داخل زیرسیستم
T}
T{
"D:"
T}:T{
شماره اصلی/فرعی (major/minor) گره دستگاه هسته
T}
T{
"I:"
T}:T{
اندیس رابط شبکه
T}
T{
"N:"
T}:T{
نام گره دستگاه هسته
T}
T{
"L:"
T}:T{
اولویت پیوند نمادین گره دستگاه
T}
T{
"S:"
T}:T{
پیوند نمادین گره دستگاه
T}
T{
"Q:"
T}:T{
شماره توالی دستگاه بلوکی (DISKSEQ)
T}
T{
"V:"
T}:T{
درایور متصل‌شده
T}
T{
"E:"
T}:T{
ویژگی دستگاه
T}
.TE
.sp 1
.SS "udevadm trigger [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]"
.PP
درخواست رویدادهای دستگاه از هسته\&. اساساً برای بازپخش رویدادها در زمان اتصال سرد (coldplug) سیستم استفاده می‌شود\&.
.PP
مشخصات دستگاه را به عنوان آرگومان‌های مکانی دریافت می‌کند\&. به توضیحات
\fBinfo\fR
در بالا مراجعه کنید\&.
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
چاپ فهرست دستگاه‌هایی که راه‌اندازی (trigger) خواهند شد\&.
.RE
.PP
\fB\-n\fR, \fB\-\-dry\-run\fR
.RS 4
رویداد را واقعاً راه‌اندازی نکن (اجرای آزمایشی)\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
پنهان‌سازی ثبت خطاهای ناشی از راه‌اندازی رویدادها\&.
.sp
در نسخه 248 اضافه شد\&.
.RE
.PP
\fB\-t\fR, \fB\-\-type=\fR\fB\fITYPE\fR\fR
.RS 4
راه‌اندازی نوع خاصی از دستگاه‌ها\&. انواع معتبر عبارتند از:
"all"،
"devices"
و
"subsystems"\&. مقدار پیش‌فرض
"devices"
است\&.
.RE
.PP
\fB\-c\fR, \fB\-\-action=\fR\fB\fIACTION\fR\fR
.RS 4
نوع رویدادی که باید راه‌اندازی شود\&. کنش‌های ممکن عبارتند از:
"add"،
"remove"،
"change"،
"move"،
"online"،
"offline"،
"bind"
و
"unbind"\&. همچنین می‌توان از مقدار ویژه
"help"
برای فهرست کردن کنش‌های ممکن استفاده کرد\&. مقدار پیش‌فرض
"change"
است\&.
.RE
.PP
\fB\-\-prioritized\-subsystem=\fR\fB\fISUBSYSTEM\fR\fI[,\fISUBSYSTEM\fR\&...]\fR\fR
.RS 4
فهرستی از زیرسیستم‌ها که با ویرگول از هم جدا شده‌اند را می‌پذیرد\&. هنگام راه‌اندازی رویدادها برای دستگاه‌ها، ابتدا دستگاه‌های متعلق به زیرسیستم‌های مشخص‌شده و والدین آن‌ها راه‌اندازی می‌شوند\&. به عنوان مثال، اگر
\fB\-\-prioritized\-subsystem=block,net\fR
باشد، ابتدا تمام دستگاه‌های بلوکی و والدین آن‌ها راه‌اندازی می‌شوند، سپس تمام دستگاه‌های شبکه و والدین آن‌ها راه‌اندازی می‌گردند، و در پایان سایر دستگاه‌ها راه‌اندازی می‌شوند\&. این گزینه را می‌توان چندین بار مشخص کرد که در این صورت فهرست زیرسیستم‌ها ادغام خواهد شد\&. یعنی،
\fB\-\-prioritized\-subsystem=block \-\-prioritized\-subsystem=net\fR
معادل
\fB\-\-prioritized\-subsystem=block,net\fR
است\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-s\fR, \fB\-\-subsystem\-match=\fR\fB\fISUBSYSTEM\fR\fR
.RS 4
راه‌اندازی رویدادها برای دستگاه‌هایی که متعلق به یک زیرسیستم منطبق هستند\&. این گزینه از تطبیق الگوی سبک شل پشتیبانی می‌کند\&. هنگامی که این گزینه بیش از یک بار مشخص شود، نتایج با OR منطقی ترکیب می‌شوند؛ یعنی تمام دستگاه‌های موجود در هر یک از زیرسیستم‌ها راه‌اندازی می‌شوند\&.
.RE
.PP
\fB\-S\fR, \fB\-\-subsystem\-nomatch=\fR\fB\fISUBSYSTEM\fR\fR
.RS 4
رویدادها را برای دستگاه‌هایی که متعلق به یک زیرسیستم منطبق هستند راه‌اندازی نکن\&. این گزینه از تطبیق الگوی سبک شل پشتیبانی می‌کند\&. هنگامی که این گزینه بیش از یک بار مشخص شود، نتایج با AND منطقی ترکیب می‌شوند؛ یعنی دستگاه‌هایی که با هیچ‌یک از زیرسیستم‌های مشخص‌شده مطابقت ندارند راه‌اندازی می‌شوند\&.
.RE
.PP
\fB\-a\fR, \fB\-\-attr\-match=\fR\fB\fIATTRIBUTE\fR\fR\fB=\fR\fB\fIVALUE\fR\fR
.RS 4
راه‌اندازی رویدادها برای دستگاه‌های دارای ویژگی sysfs منطبق\&. اگر مقداری همراه با نام ویژگی مشخص شده باشد، محتوای ویژگی با استفاده از تطبیق الگوی سبک شل در برابر مقدار داده‌شده سنجیده می‌شود\&. اگر مقداری تعیین نشده باشد، وجود ویژگی sysfs بررسی می‌شود\&. وقتی این گزینه چندین بار مشخص شود، نتایج با AND منطقی ترکیب می‌شوند؛ یعنی فقط دستگاه‌هایی که همه ویژگی‌های مشخص‌شده را دارند راه‌اندازی می‌شوند\&.
.RE
.PP
\fB\-A\fR, \fB\-\-attr\-nomatch=\fR\fB\fIATTRIBUTE\fR\fR\fB=\fR\fB\fIVALUE\fR\fR
.RS 4
رویدادها را برای دستگاه‌های دارای ویژگی sysfs منطبق راه‌اندازی نکن\&. اگر مقداری همراه با نام ویژگی مشخص شده باشد، محتوای ویژگی با استفاده از تطبیق الگوی سبک شل در برابر مقدار داده‌شده سنجیده می‌شود\&. اگر مقداری تعیین نشده باشد، وجود ویژگی sysfs بررسی می‌شود\&. وقتی این گزینه چندین بار مشخص شود، نتایج با AND منطقی ترکیب می‌شوند؛ یعنی فقط دستگاه‌هایی که هیچ‌یک از ویژگی‌های مشخص‌شده را ندارند راه‌اندازی می‌شوند\&.
.RE
.PP
\fB\-p\fR, \fB\-\-property\-match=\fR\fB\fIPROPERTY\fR\fR\fB=\fR\fB\fIVALUE\fR\fR
.RS 4
راه‌اندازی رویدادها برای دستگاه‌های دارای مقدار ویژگی منطبق\&. این گزینه از تطبیق الگوی سبک شل پشتیبانی می‌کند\&. هنگامی که این گزینه بیش از یک بار مشخص شود، نتایج با OR منطقی ترکیب می‌شوند؛ یعنی دستگاه‌هایی که یکی از ویژگی‌های مشخص‌شده را دارند راه‌اندازی می‌شوند\&.
.RE
.PP
\fB\-g\fR, \fB\-\-tag\-match=\fR\fB\fITAG\fR\fR
.RS 4
راه‌اندازی رویدادها برای دستگاه‌های دارای برچسب منطبق\&. هنگامی که این گزینه چندین بار مشخص شود، نتایج با AND منطقی ترکیب می‌شوند؛ یعنی دستگاه‌هایی که تمام برچسب‌های مشخص‌شده را دارند راه‌اندازی می‌شوند\&.
.RE
.PP
\fB\-y\fR, \fB\-\-sysname\-match=\fR\fB\fINAME\fR\fR
.RS 4
راه‌اندازی رویدادها برای دستگاه‌هایی که آخرین مؤلفه (یعنی نام پرونده) مسیر
/sys/
آن‌ها با
\fIPATH\fR
مشخص‌شده مطابقت دارد\&. این گزینه از تطبیق الگوی سبک شل پشتیبانی می‌کند\&. هنگامی که این گزینه بیش از یک بار مشخص شود، نتایج با OR منطقی ترکیب می‌شوند؛ یعنی همه دستگاه‌هایی که هر یک از
\fINAME\fR
های مشخص‌شده را دارند راه‌اندازی می‌شوند\&.
.RE
.PP
\fB\-\-name\-match=\fR\fB\fINAME\fR\fR
.RS 4
راه‌اندازی رویدادها برای دستگاه‌های دارای مسیر دستگاه منطبق\&. هنگامی که این گزینه بیش از یک بار مشخص شود، نتایج با OR منطقی ترکیب می‌شوند؛ یعنی تمام دستگاه‌های مشخص‌شده راه‌اندازی می‌شوند\&.
.sp
در نسخه 218 اضافه شد\&.
.RE
.PP
\fB\-b\fR, \fB\-\-parent\-match=\fR\fB\fISYSPATH\fR\fR
.RS 4
راه‌اندازی رویدادها برای تمام فرزندان یک دستگاه داده‌شده\&. هنگامی که این گزینه بیش از یک بار مشخص شود، نتایج با OR منطقی ترکیب می‌شوند؛ یعنی تمام فرزندان هر دستگاه مشخص‌شده راه‌اندازی می‌شوند\&.
.RE
.PP
\fB\-\-initialized\-match\fR, \fB\-\-initialized\-nomatch\fR
.RS 4
هنگامی که
\fB\-\-initialized\-match\fR
مشخص شود، رویدادها را برای دستگاه‌هایی که قبلاً توسط
\fBsystemd\-udevd\fR
مقداردهی اولیه شده‌اند راه‌اندازی کرده و از دستگاه‌هایی که هنوز مقداردهی اولیه نشده‌اند صرف‌نظر می‌کند\&.
.sp
هنگامی که
\fB\-\-initialized\-nomatch\fR
مشخص شود، رویدادها را برای دستگاه‌هایی که هنوز توسط
\fBsystemd\-udevd\fR
مقداردهی اولیه نشده‌اند راه‌اندازی کرده و از دستگاه‌هایی که قبلاً مقداردهی اولیه شده‌اند صرف‌نظر می‌کند\&.
.sp
به طور معمول، ضروری است برنامه‌هایی که قصد استفاده از چنین تطبیقی را دارند، مطمئن شوند که یک قاعده مناسب udev نصب شده است که حداقل یک ویژگی را روی دستگاه‌های مورد تطبیق تنظیم می‌کند\&. برای جزئیات بیشتر به بخش «دستگاه‌های مقداردهی اولیه شده» در زیر نیز مراجعه کنید\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBهشدار\fR
.ps -1
.br
\fB\-\-initialized\-nomatch\fR
می‌تواند در مقایسه با راه‌اندازی مجدد تمام دستگاه‌های سیستم، زمان قابل توجهی را صرفه‌جویی کند و مثلاً برای بهینه‌سازی زمان بوت استفاده شود\&. با این حال، استفاده از این گزینه در توالی بوت به طور کلی ایمن نیست\&. به ویژه، هنگامی که قوانین udev برای یک دستگاه به دستگاه‌های والد آن وابسته باشد (مانند کلیدهای
"ATTRS"
یا
"IMPORT{parent}"،
برای جزئیات بیشتر به
\fBudev\fR(7)
مراجعه کنید)، وضعیت نهایی دستگاه با این گزینه به راحتی ناپایدار می‌شود\&.
.sp .5v
.RE
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-w\fR, \fB\-\-settle\fR
.RS 4
علاوه بر راه‌اندازی رویدادها، منتظر اتمام آن رویدادها نیز می‌ماند\&. توجه داشته باشید که این با فراخوانی
\fBudevadm settle\fR
متفاوت است\&. دستور
\fBudevadm settle\fR
منتظر اتمام تمام رویدادها می‌ماند\&. این گزینه فقط منتظر اتمام رویدادهایی می‌ماند که توسط همین فرمان راه‌اندازی شده‌اند\&.
.sp
در نسخه 238 اضافه شد\&.
.RE
.PP
\fB\-\-uuid\fR
.RS 4
رویدادهای ساختگی (synthetic) دستگاه را راه‌اندازی کرده و یک شناسه UUID تصادفی به هر کدام اختصاص می‌دهد\&. این UUIDها در خروجی استاندارد چاپ می‌شوند (یک خط برای هر رویداد)\&. این UUIDها در بلوک محیط uevent (در ویژگی
"SYNTH_UUID="
) گنجانده شده و می‌توان از آن‌ها برای رهگیری تحویل رویدادهای تولیدشده استفاده کرد\&.
.sp
در نسخه 249 اضافه شد\&.
.RE
.PP
\fB\-\-wait\-daemon[=\fR\fB\fISECONDS\fR\fR\fB]\fR
.RS 4
پیش از راه‌اندازی ueventها، منتظر مقداردهی اولیه دیمن systemd\-udevd می‌ماند\&. به صورت اختیاری مقدار مهلت زمانی (timeout) را می‌پذیرد\&. مهلت زمانی پیش‌فرض ۵ ثانیه است\&. این معادل فراخوانی
\fBudevadm control \-\-ping\fR
قبل از
\fBudevadm trigger\fR
است\&.
.sp
در نسخه 241 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
علاوه بر این، می‌توان از آرگومان‌های مکانی اختیاری برای تعیین نام دستگاه‌ها یا مسیرهای sys استفاده کرد\&. آن‌ها باید به ترتیب با
/dev/
یا
/sys/
شروع شوند\&.
.SS "udevadm settle [\fIoptions\fR]"
.PP
صف رویدادهای udev را نظارت کرده و در صورت رسیدگی به تمام رویدادهای جاری، خارج می‌شود\&.
.PP
\fB\-t\fR, \fB\-\-timeout=\fR\fB\fISECONDS\fR\fR
.RS 4
حداکثر تعداد ثانیه‌ها برای انتظار خالی شدن صف رویدادها\&. مقدار پیش‌فرض ۱۲۰ ثانیه است\&. مقدار 0 خالی بودن صف را بررسی کرده و همیشه فوراً بازمی‌گردد\&. یک مقدار غیر صفر در صورتی که صف پیش از رسیدن به مهلت زمانی خالی شود کد خروج 0 و در غیر این صورت مقدار غیر صفر بازمی‌گرداند\&.
.RE
.PP
\fB\-E\fR, \fB\-\-exit\-if\-exists=\fR\fB\fIFILE\fR\fR
.RS 4
در صورت وجود پرونده، توقف انتظار\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
برای اطلاعات بیشتر به
\fBsystemd-udev-settle.service\fR(8)
مراجعه کنید\&.
.SS "udevadm control \fIoption\fR"
.PP
تغییر وضعیت داخلی دیمن در حال اجرای udev\&.
.PP
\fB\-e\fR, \fB\-\-exit\fR
.RS 4
ارسال سیگنال به systemd\-udevd و انتظار برای خروج آن\&. پس از این گزینه هیچ گزینه‌ای به جز
\fB\-\-timeout\fR
نمی‌تواند مشخص شود\&. توجه داشته باشید که
systemd\-udevd\&.service
شامل
\fBRestart=always\fR
است و در نتیجه، این گزینه باعث راه‌اندازی مجدد (restart) دیمن systemd\-udevd می‌شود\&. اگر می‌خواهید
systemd\-udevd\&.service
را متوقف کنید، لطفاً از دستور زیر استفاده نمایید:
.sp
.if n \{\
.RS 4
.\}
.nf
systemctl stop systemd\-udevd\-control\&.socket systemd\-udevd\-kernel\&.socket systemd\-udevd\&.service
.fi
.if n \{\
.RE
.\}
.sp
.RE
.PP
\fB\-l\fR, \fB\-\-log\-level=\fR\fB\fIvalue\fR\fR
.RS 4
تنظیم سطح گزارش‌گیری (log level) داخلی
systemd\-udevd\&.
مقادیر مجاز عبارتند از اولویت‌های عددی syslog یا معادل‌های متنی آن‌ها:
\fBemerg\fR،
\fBalert\fR،
\fBcrit\fR،
\fBerr\fR،
\fBwarning\fR،
\fBnotice\fR،
\fBinfo\fR
و
\fBdebug\fR\&.
.RE
.PP
\fB\-s\fR, \fB\-\-stop\-exec\-queue\fR
.RS 4
ارسال سیگنال به systemd\-udevd برای توقف اجرای رویدادهای جدید\&. رویدادهای ورودی در صف قرار خواهند گرفت\&.
.RE
.PP
\fB\-S\fR, \fB\-\-start\-exec\-queue\fR
.RS 4
ارسال سیگنال به systemd\-udevd برای فعال‌سازی اجرای رویدادها\&.
.RE
.PP
\fB\-R\fR, \fB\-\-reload\fR
.RS 4
ارسال سیگنال به systemd\-udevd برای بارگذاری مجدد پرونده‌های قوانین و سایر پایگاه‌های داده مانند شاخص ماژول‌های هسته\&. بارگذاری مجدد قوانین و پایگاه‌های داده هیچ تغییری روی دستگاه‌های از پیش موجود اعمال نمی‌کند؛ پیکربندی جدید تنها برای رویدادهای جدید اعمال خواهد شد\&.
.RE
.PP
\fB\-p\fR, \fB\-\-property=\fR\fB\fIKEY\fR\fR\fB=\fR\fB\fIvalue\fR\fR
.RS 4
تنظیم یک ویژگی سراسری برای همه رویدادها\&.
.RE
.PP
\fB\-m\fR, \fB\-\-children\-max=\fR\fB\fIvalue\fR\fR
.RS 4
تنظیم حداکثر تعداد رویدادهایی که systemd\-udevd به طور همزمان پردازش خواهد کرد\&. هنگامی که 0 مشخص شود، حداکثر مقدار بر اساس منابع سیستم تعیین می‌شود\&.
.RE
.PP
\fB\-\-ping\fR
.RS 4
ارسال یک پیام پینگ به systemd\-udevd و انتظار برای پاسخ\&. این ممکن است برای بررسی در حال اجرا بودن دیمن systemd\-udevd مفید باشد\&.
.sp
در نسخه 241 اضافه شد\&.
.RE
.PP
\fB\-t\fR, \fB\-\-timeout=\fR\fB\fIseconds\fR\fR
.RS 4
حداکثر تعداد ثانیه‌ها برای انتظار دریافت پاسخ از systemd\-udevd\&.
.RE
.PP
\fB\-\-load\-credentials\fR
.RS 4
هنگام تعیین، اطلاعات اعتباری (credentials) زیر در صورت ارسال استفاده می‌شوند:
.PP
\fIudev\&.conf\&.*\fR
.RS 4
این اطلاعات اعتباری باید شامل داده‌های پیکربندی معتبر
\fBudev.conf\fR(5)
باشند\&. از هر اطلاعات اعتباری منطبق یک پرونده جداگانه ایجاد می‌شود\&. مثال: اطلاعات اعتباری ارسال‌شده
udev\&.conf\&.50\-foobar
در پرونده پیکربندی
/run/udev/udev\&.conf\&.d/50\-foobar\&.conf
کپی خواهد شد\&.
.sp
در نسخه 256 اضافه شد\&.
.RE
.PP
\fIudev\&.rules\&.*\fR
.RS 4
این اطلاعات اعتباری باید شامل قوانین معتبر
\fBudev\fR(7)
باشند\&. از هر اطلاعات اعتباری منطبق یک پرونده جداگانه ایجاد می‌شود\&. مثال: اطلاعات اعتباری ارسال‌شده
udev\&.rules\&.50\-foobar
در پرونده پیکربندی
/run/udev/rules\&.d/50\-foobar\&.rules
کپی خواهد شد\&.
.sp
در نسخه 256 اضافه شد\&.
.RE
.sp
توجه داشته باشید که این گزینه
\fIمستلزم\fR
گزینه
\fB\-\-reload\fR
نیست\&. بنابراین، اگر
\fBsystemd\-udevd\fR
از قبل در حال اجرا است، لطفاً گزینه
\fB\-\-reload\fR
را نیز مشخص کنید تا پرونده‌های قوانین udev کپی‌شده توسط
\fBsystemd\-udevd\fR
مورد استفاده قرار گیرند\&.
.sp
در نسخه 256 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.SS "udevadm monitor [\fIoptions\fR]"
.PP
به ueventهای هسته و رویدادهای ارسال‌شده توسط یک قاعده udev گوش می‌دهد و devpath رویداد را در کنسول چاپ می‌کند\&. می‌توان از آن برای تحلیل زمان‌بندی رویدادها با مقایسه برچسب‌های زمانی uevent هسته و رویداد udev استفاده کرد\&.
.PP
\fB\-k\fR, \fB\-\-kernel\fR
.RS 4
چاپ ueventهای هسته\&.
.RE
.PP
\fB\-u\fR, \fB\-\-udev\fR
.RS 4
چاپ رویداد udev پس از پردازش قوانین\&.
.RE
.PP
\fB\-p\fR, \fB\-\-property\fR
.RS 4
همچنین چاپ ویژگی‌های رویداد\&.
.RE
.PP
\fB\-s\fR, \fB\-\-subsystem\-match=\fR\fB\fIstring[/string]\fR\fR
.RS 4
پالایش ueventهای هسته و رویدادهای udev بر اساس زیرسیستم[/نوع‌دستگاه]\&. تنها رویدادهای دارای مقدار زیرسیستم منطبق عبور داده می‌شوند\&. هنگامی که این گزینه بیش از یک بار مشخص شود، نتایج با OR منطقی ترکیب می‌شوند؛ یعنی تمام دستگاه‌های موجود در زیرسیستم‌های مشخص‌شده نظارت می‌شوند\&.
.RE
.PP
\fB\-t\fR, \fB\-\-tag\-match=\fR\fB\fIstring\fR\fR
.RS 4
پالایش رویدادهای udev بر اساس برچسب (tag)\&. تنها رویدادهای udev که دارای برچسب داده‌شده هستند عبور داده می‌شوند\&. هنگامی که این گزینه بیش از یک بار مشخص شود، نتایج با OR منطقی ترکیب می‌شوند؛ یعنی دستگاه‌هایی که یکی از برچسب‌های مشخص‌شده را دارند نظارت می‌شوند\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.SS "udevadm test [\fIoptions\fR] [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]"
.PP
شبیه‌سازی اجرای رویداد udev برای دستگاه داده‌شده و چاپ خروجی اشکال‌زدایی\&.
.PP
\fB\-a\fR, \fB\-\-action=\fR\fB\fIACTION\fR\fR
.RS 4
نوع رویدادی که باید شبیه‌سازی شود\&. کنش‌های ممکن عبارتند از:
"add"،
"remove"،
"change"،
"move"،
"online"،
"offline"،
"bind"
و
"unbind"\&. همچنین می‌توان از مقدار ویژه
"help"
برای فهرست کردن کنش‌های ممکن استفاده کرد\&. مقدار پیش‌فرض
"add"
است\&.
.RE
.PP
\fB\-N\fR, \fB\-\-resolve\-names=\fR\fB\fBearly\fR\fR\fB|\fR\fB\fBlate\fR\fR\fB|\fR\fB\fBnever\fR\fR
.RS 4
مشخص می‌کند که چه زمانی udevadm باید نام‌های کاربران و گروه‌ها را حل‌وفصل (resolve) کند\&. هنگامی که روی
\fBearly\fR
(پیش‌فرض) تنظیم شود، نام‌ها هنگام تجزیه قوانین حل‌وفصل می‌شوند\&. هنگامی که روی
\fBlate\fR
تنظیم شود، نام‌ها برای هر رویداد حل‌وفصل می‌شوند\&. هنگامی که روی
\fBnever\fR
تنظیم شود، نام‌ها هرگز حل‌وفصل نخواهند شد و مالکیت تمام دستگاه‌ها در اختیار کاربر root خواهد بود\&.
.sp
در نسخه 209 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.SS "udevadm test\-builtin [\fIoptions\fR] \fIcommand\fR [\fIdevpath\fR|\fIfile\fR|\fIunit\fR]"
.PP
اجرای یک فرمان توکار (built\-in)
\fICOMMAND\fR
برای دستگاه
\fIDEVPATH\fR،
و چاپ خروجی اشکال‌زدایی\&.
.PP
\fB\-a\fR, \fB\-\-action=\fR\fB\fIACTION\fR\fR
.RS 4
نوع رویدادی که باید شبیه‌سازی شود\&. کنش‌های ممکن عبارتند از:
"add"،
"remove"،
"change"،
"move"،
"online"،
"offline"،
"bind"
و
"unbind"\&. همچنین می‌توان از مقدار ویژه
"help"
برای فهرست کردن کنش‌های ممکن استفاده کرد\&. مقدار پیش‌فرض
"add"
است\&.
.sp
در نسخه 250 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش رشته کوتاه نسخه و خروج\&.
.RE
.SS "udevadm verify [\fIoptions\fR] [\fIfile\fR] \&..."
.PP
بررسی درستی نحوی، معنایی و سبک‌شناختی پرونده‌های قوانین udev\&.
.PP
می‌توان از آرگومان‌های مکانی برای مشخص کردن یک یا چند پرونده جهت بررسی استفاده کرد\&. اگر هیچ پرونده‌ای مشخص نشود، قوانین udev از پرونده‌های واقع در همان دایرکتوری‌های udev/rules\&.d که توسط دیمن udev پردازش می‌شوند خوانده خواهند شد\&.
.PP
وضعیت خروج برابر
\fB0\fR
خواهد بود اگر تمام پرونده‌های قوانین udev مشخص‌شده از نظر نحوی، معنایی و سبک‌شناختی درست باشند، و در غیر این صورت یک کد خطای غیر صفر بازگردانده می‌شود\&.
.PP
\fB\-N\fR, \fB\-\-resolve\-names=\fR\fB\fBearly\fR\fR\fB|\fR\fB\fBnever\fR\fR
.RS 4
مشخص می‌کند که چه زمانی udevadm باید نام‌های کاربران و گروه‌ها را حل‌وفصل کند\&. هنگامی که روی
\fBearly\fR
(پیش‌فرض) تنظیم شود، نام‌ها هنگام تجزیه قوانین حل‌وفصل می‌شوند\&. هنگامی که روی
\fBnever\fR
تنظیم شود، نام‌ها هرگز حل‌وفصل نخواهند شد\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-\-root=\fR\fB\fIPATH\fR\fR
.RS 4
هنگام جستجوی پرونده‌های قوانین udev واقع در دایرکتوری‌های udev/rules\&.d، روی پرونده‌های زیر مسیر ریشه مشخص‌شده
\fIPATH\fR
عملیات را انجام می‌دهد\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-\-no\-summary\fR
.RS 4
خلاصه را نشان نده\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-\-no\-style\fR
.RS 4
نادیده گرفتن مشکلات سبک نگارش\&. هنگام تعیین، حتی اگر مشکلات سبکی در پرونده‌های قوانین udev یافت شود، در صورتی که خطای نحوی یا معنایی وجود نداشته باشد وضعیت خروج
\fB0\fR
خواهد بود\&.
.sp
در نسخه 254 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.SS "udevadm wait [\fIoptions\fR] [\fIdevice|syspath\fR] \&..."
.PP
انتظار برای ایجاد و مقداردهی اولیه شدن دستگاه‌ها یا پیوندهای نمادین دستگاه توسط
\fBsystemd\-udevd\fR\&.
هر مسیر دستگاه باید با
"/dev/"
یا
"/sys/"
شروع شود، به عنوان مثال:
"/dev/sda"،
"/dev/disk/by\-path/pci\-0000:3c:00\&.0\-nvme\-1\-part1"،
"/sys/devices/pci0000:00/0000:00:1f\&.6/net/eth0"
یا
"/sys/class/net/eth0"\&. این دستور می‌تواند چندین دستگاه را بپذیرد\&. این ویژگی ممکن است برای انتظار جهت پردازش دستگاه‌ها توسط
\fBsystemd\-udevd\fR
پس از اقداماتی نظیر پارتیشن‌بندی یا قالب‌بندی (فرمت) دستگاه‌ها مفید باشد\&.
.PP
\fB\-t\fR, \fB\-\-timeout=\fR\fB\fISECONDS\fR\fR
.RS 4
حداکثر تعداد ثانیه‌ها برای انتظار ایجاد، مقداردهی اولیه یا حذف دستگاه‌ها یا پیوندهای نمادین دستگاه مشخص‌شده\&. مقدار پیش‌فرض
"infinity"
(بی‌نهایت) است\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-\-initialized=\fR\fB\fIBOOL\fR\fR
.RS 4
بررسی اینکه آیا
\fBsystemd\-udevd\fR
دستگاه‌ها را مقداردهی اولیه کرده است یا خیر\&. مقدار پیش‌فرض true است\&. در صورت تعیین false، این فرمان تنها وجود دستگاه‌های مشخص‌شده را بررسی می‌کند\&. اگر هیچ قاعده udev برای دستگاه‌های مشخص‌شده وجود ندارد، این تنظیم را روی false قرار دهید، زیرا در این حالت دستگاه‌ها هرگز به عنوان مقداردهی اولیه شده در نظر گرفته نمی‌شوند\&. برای جزئیات بیشتر به بخش «دستگاه‌های مقداردهی اولیه شده» در زیر مراجعه کنید\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-\-removed\fR
.RS 4
در صورت تعیین، این فرمان به جای ایجاد یا مقداردهی اولیه، منتظر حذف دستگاه‌ها می‌ماند\&. اگر این گزینه مشخص شود،
\fB\-\-initialized=\fR
نادیده گرفته خواهد شد\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-\-settle\fR
.RS 4
در صورت تعیین، همچنین صف رویدادهای udev را نظارت کرده و منتظر پردازش تمام رویدادهای موجود در صف توسط
\fBsystemd\-udevd\fR
می‌ماند\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.SS "udevadm lock [\fIoptions\fR] [\fIcommand\fR] \&..."
.PP
\fBudevadm lock\fR
مطابق با سند
\m[blue]\fBLocking Block Device Access\fR\m[]\&\s-2\u[2]\d\s+2
یک قفل انحصاری (مشورتی) روی یک دستگاه بلوکی (یا تمام دستگاه‌های مشخص‌شده) می‌گیرد و برنامه‌ای را با قفل‌های گرفته‌شده اجرا می‌کند\&. هنگامی که برنامه اجراشده خارج می‌شود، قفل‌ها به طور خودکار آزاد می‌شوند و مقدار بازگشتی آن به عنوان کد خروج
\fBudevadm lock\fR
منتقل می‌گردد\&.
.PP
این ابزار به ویژه برای اطمینان از اینکه
\fBsystemd-udevd.service\fR(8)
در حین اعمال تغییرات روی یک دستگاه بلوکی (به عنوان مثال ایجاد پارتیشن‌ها یا قالب‌بندی سیستم‌های پرونده) آن را کاوش (probe) نمی‌کند، مفید است\&. توجه داشته باشید که بسیاری از ابزارهایی که با دستگاه‌های بلوکی تعامل دارند، به صورت بومی از گرفتن قفل‌های مربوطه پشتیبانی می‌کنند؛ برای مثال به سوییچ
\fB\-\-lock\fR
در
\fBsfdisk\fR(8)
مراجعه کنید\&.
.PP
این فرمان انتظار دارد حداقل یک دستگاه بلوکی از طریق
\fB\-\-device=\fR
یا
\fB\-\-backing=\fR
مشخص شود، و یک خط فرمان برای اجرا به عنوان آرگومان دریافت کند\&.
.PP
\fB\-\-device=\fR\fB\fIDEVICE\fR\fR, \fB\-d \fR\fB\fIDEVICE\fR\fR
.RS 4
مسیری به گره دستگاهِ دستگاه مورد نظر برای قفل کردن را می‌پذیرد\&. این سوییچ را می‌توان چندین بار (و در ترکیب با
\fB\-\-backing=\fR)
برای قفل کردن چندین دستگاه استفاده کرد\&. اگر گره دستگاه یک پارتیشن مشخص شود، دستگاه بلوکی «کامل» دربرگیرنده آن به طور خودکار طبق مشخصات تعیین شده و برای قفل استفاده می‌شود\&. اگر چندین دستگاه مشخص شوند، موارد تکراری حذف شده، بر اساس شماره اصلی/فرعی گره‌های دستگاه مرتب می‌شوند و سپس به ترتیب قفل می‌گردند\&.
.sp
این سوییچ باید حداقل یک بار برای مشخص کردن حداقل یک دستگاه جهت قفل کردن استفاده شود\&. (همچنین می‌توانید به عنوان جایگزین از
\fB\-\-backing=\fR
استفاده کنید، به زیر مراجعه نمایید\&.)
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-\-backing=\fR\fB\fIPATH\fR\fR, \fB\-b \fR\fB\fIPATH\fR\fR
.RS 4
اگر مسیری به یک گره دستگاه مشخص شود، عملکردی یکسان با
\fB\-\-device=\fR
دارد\&. با این حال، این سوییچ می‌تواند به عنوان جایگزین، مسیری به یک پرونده یا دایرکتوری عادی را بپذیرد که در این صورت، دستگاه بلوکی سیستم پرونده‌ای که پرونده/دایرکتوری در آن قرار دارد به طور خودکار تعیین شده و به گونه‌ای استفاده می‌شود که گویی با
\fB\-\-device=\fR
مشخص شده است\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-\-timeout=\fR\fB\fISECS\fR\fR, \fB\-t \fR\fB\fISECS\fR\fR
.RS 4
مشخص می‌کند حداکثر چه مدت منتظر بماند تا تمام قفل‌ها گرفته شوند\&. مقداری بر حسب ثانیه یا واحدهای زمانی پشتیبانی‌شده معمول را می‌پذیرد، به
\fBsystemd.time\fR(7)
مراجعه کنید\&. اگر صفر تعیین شود، تلاش برای قفل کردن انجام می‌گیرد و در صورت عدم موفقیت، فراخوانی بلافاصله با شکست مواجه می‌شود\&. اگر به صورت
"infinity"
(پیش‌فرض) ارسال شود، فراخوانی به طور نامحدود تا زمان به دست آوردن قفل منتظر می‌ماند\&. اگر قفل در زمان مشخص‌شده گرفته نشود، فرمان تعیین‌شده اجرا نخواهد شد و فراخوانی با شکست مواجه می‌شود\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-\-print\fR, \fB\-p\fR
.RS 4
به جای قفل کردن دستگاه‌های مشخص‌شده و اجرای یک فرمان، صرفاً مسیرهای دستگاهی که قفل خواهند شد را چاپ کرده و هیچ فرمانی را اجرا نمی‌کند\&. این فرمان برای تعیین دستگاه بلوکی «کامل» در حالتی که یک دستگاه بلوکی پارتیشن مشخص شده است مفید است\&. دستگاه‌ها بر اساس شماره اصلی گره دستگاه به عنوان کلید مرتب‌سازی اولیه و شماره فرعی به عنوان کلید مرتب‌سازی ثانویه مرتب می‌شوند (یعنی به ترتیبی که قفل می‌شدند نمایش داده می‌شوند)\&. توجه داشته باشید که در صورتی که سوییچ‌های
\fB\-\-device=\fR
و
\fB\-\-backing=\fR
به دستگاه‌های «کامل» یکسانی اشاره کنند، تعداد خطوط چاپ‌شده در اینجا می‌تواند کمتر از تعداد سوییچ‌های مشخص‌شده باشد\&.
.sp
در نسخه 251 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش یک متن راهنمای کوتاه و خروج\&.
.RE
.SH "دستگاه‌های مقداردهی اولیه شده (INITIALIZED DEVICES)"
.PP
دستگاه‌های مقداردهی اولیه شده دستگاه‌هایی هستند که حداقل یک قاعده udev برای آن‌ها اجرای خود را به پایان رسانده است \(en برای هر کنشی به جز
"remove"
\(em که یک ویژگی یا تنظیم دیگر دستگاه را تعیین کرده باشد (و در نتیجه دارای یک مدخل در پایگاه داده دستگاه udev باشد)\&. اگر یک کنش
"remove"
برای دستگاه‌ها مشاهده شود (که مدخل آن‌ها را در پایگاه داده دستگاه udev حذف می‌کند)، دستگاه‌ها دیگر به عنوان مقداردهی اولیه شده در نظر گرفته نمی‌شوند\&. توجه داشته باشید دستگاه‌هایی که هیچ قاعده udev ندارند هرگز به عنوان مقداردهی اولیه شده در نظر گرفته نمی‌شوند، اما ممکن است همچنان از طریق sd\-device API (یا موارد مشابه) اعلام شوند\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
\fBمثال\ \&۱.\ \&قالب‌بندی (فرمت) یک سیستم پرونده\fR
.PP
گرفتن قفل روی دستگاه بلوکی پشتیبان هنگام ایجاد یک سیستم پرونده، برای اطمینان از اینکه
\fBsystemd\-udevd\fR
پیش از نوشته شدن کامل ابربلوک (superblock) جدید، آن را کاوش یا اعلام نمی‌کند:
.sp
.if n \{\
.RS 4
.\}
.nf
# udevadm lock \-\-device=/dev/sda1 mkfs\&.ext4 /dev/sda1
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۲.\ \&قالب‌بندی یک سیستم پرونده RAID\fR
.PP
مشابه قبل، اما گرفتن قفل روی چندین دستگاه به طور همزمان:
.sp
.if n \{\
.RS 4
.\}
.nf
# udevadm lock \-\-device=/dev/sda1 \-\-device=/dev/sdb1 mkfs\&.btrfs /dev/sda1 /dev/sdb1
.fi
.if n \{\
.RE
.\}
.PP
\fBمثال\ \&۳.\ \&کپی کردن یک سیستم پرونده\fR
.PP
گرفتن قفل روی دستگاه بلوکی پشتیبان هنگام کپی کردن یک تصویر سیستم پرونده آماده، برای اطمینان از اینکه
\fBsystemd\-udevd\fR
پیش از نوشته شدن کامل ابربلوک جدید، آن را کاوش یا اعلام نمی‌کند:
.sp
.if n \{\
.RS 4
.\}
.nf
# udevadm lock \-d /dev/sda1 dd if=fs\&.raw of=/dev/sda1
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBudev\fR(7), \fBsystemd-udevd.service\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
jq
.RS 4
\%https://jqlang.github.io/jq/manual
.RE
.IP " 2." 4
Locking Block Device Access
.RS 4
\%https://systemd.io/BLOCK_DEVICE_LOCKING
.RE