.TH DMSETUP 8 "Mar 26 2025" Linux "MAINTENANCE COMMANDS"
.
.if !dEX \{\
.de EX
.nf
..
.de EE
.fi
..
\}
.
.\" So use .SY only for graphical rendering (postscript/pdf)
.\" and keep using .TP for ascii renderers
.de NSY
.  ie t .SY \\$1
.  el \{\
.    ie \\n(.$>1 \{\
.      PD 0
.      TP \\w'\\$1\ 'u
.    \}
.    el .TP
.    B \\$1
.    na
.    nh
.\}
..
.
.\" Use .SY for command synopsis
.de _NSY
.  SY \\$1
..
.de CMS
.  na
.  nh
..
.
.ds CBR \&
.
.de CME
.  hy
.  ad
\\*[CBR]
..
.
.\" Still prefer .HP as it gives slightly better look
.\" for man pages rendered in text terminal.
.\" With .TP html rendering would likely also need .sp
.de NTP
.\".  sp
.  ie t .HP
.  el .HP
..
.
.\" Use instead of plain .sh as some html renderers
.\" are simply misaligning otherwise
.de NSP
.  br
\&
.  br
..
.
.\" avoid hyphenation of these keywords
.hw dmsetup
.
.SH "نام (NAME)"
.
dmsetup \- ابزار سطح پایین پیکربندی و مدیریت نگاشتگر دستگاه (Device-Mapper)
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.NSY dmsetup 1
.de CMD_CLEAR
.  CMS
.  BR clear " "\c
.  IR device_name \&
.  CME
..
.CMD_CLEAR
.
.NSY dmsetup
.de CMD_CREATE
.  CMS
.  BR create " "\c
.  IR device_name " "\c
.  RB [ \-n | \-\-notable |\: \-\-table\ \c
.  IR table |\: table_file ] " "\c
.  RB [ \-\-readahead " [" + ]\c
.  IR sectors |\:\c
.  BR auto | none ] " "\c
.  RB [ \-u | \-\-uuid\ \c
.  IR uuid ] " "\c
.  RB [ \-\-addnodeoncreate |\: \-\-addnodeonresume ]
.  B \&  \" Mask '\-T html' rendering bug
.  CME
..
.CMD_CREATE
.
.NSY dmsetup
.de CMD_CREATE_CONCISE
.  CMS
.  BR create \  \-\-concise " "\c
.  RI [ concise_de\%vice_spe\%cification ] " "\c
.  B \&
.  CME
..
.CMD_CREATE_CONCISE
.
.NSY dmsetup
.de CMD_DEPS
.  CMS
.  BR deps " "\c
.  RB [ \-o\ \c
.  IR options ] " "\c
.  RI [ device_name \ .\|.\|.]
.  CME
..
.CMD_DEPS
.
.NSY dmsetup
.de CMD_HELP
.  CMS
.  BR help " "\c
.  RB [ \-c | \-C | \-\-columns ]
.  CME
..
.CMD_HELP
.
.NSY dmsetup
.de CMD_INFO
.  CMS
.  BR info " "\c
.  RI [ device_name \ .\|.\|.]
.  CME
..
.CMD_INFO
.
.NSY dmsetup
.de CMD_INFOLONG
.  CMS
.  BR info " "\c
.  BR \-c | \-C | \-\-columns " "\c
.  RB [ \-\-count\ \c
.  IR count ] " "\c
.  RB [ \-\-interval\ \c
.  IR seconds ] " "\c
.  RB [ \-\-noheadings |\: \-\-headings\ \c
.  BR none | abbrev |\: full |\: 0 | 1 | 2 ] " "\c
.  RB [ \-o\ \c
.  IR fields ] " "\c
.  RB [ \-O | \-\-sort\ \c
.  IR sort_fields ] " "\c
.  RB [ \-\-nameprefixes ] " "\c
.  RB [ \-\-separator\ \c
.  IR separator ] " "\c
.  RI [ device_name ]
.  CME
..
.CMD_INFOLONG
.
.NSY dmsetup
.de CMD_LOAD
.  CMS
.  BR load " "\c
.  IR device_name " "\c
.  RB [ \-\-table\ \c
.  IR table |\: table_file ]
.  CME
..
.CMD_LOAD
.
.NSY dmsetup
.de CMD_LS
.  CMS
.  BR ls " "\c
.  RB [ \-\-target\ \c
.  IR target_type ] " "\c
.  RB [ \-o\ \c
.  IR options ] " "\c
.  RB [ \-\-exec\ \c
.  IR command ] " "\c
.  RB [ \-\-tree ]
.  CME
..
.CMD_LS
.
.NSY dmsetup
.de CMD_MANGLE
.  CMS
.  BR mangle " "\c
.  RI [ device_name \ .\|.\|.]
.  CME
..
.CMD_MANGLE
.
.NSY dmsetup
.de CMD_MEASURE
.  CMS
.  BR measure " "\c
.  RI [ device_name \ .\|.\|.]
.  CME
..
.CMD_MEASURE
.
.NSY dmsetup
.de CMD_MESSAGE
.  CMS
.  BR message " "\c
.  IR device_name " " sector " " message
.  CME
..
.CMD_MESSAGE
.
.NSY dmsetup
.de CMD_MKNODES
.  CMS
.  BR mknodes " "\c
.  RI [ device_name \ .\|.\|.]
.  CME
..
.CMD_MKNODES
.
.NSY dmsetup
.de CMD_RELOAD
.  CMS
.  BR reload " "\c
.  IR device_name " "\c
.  RB [ \-\-table\ \c
.  IR table |\: table_file ]
.  CME
..
.CMD_RELOAD
.
.NSY dmsetup
.de CMD_REMOVE
.  CMS
.  BR remove " "\c
.  RB [ \-f | \-\-force ] " "\c
.  RB [ \-\-retry ] " "\c
.  RB [ \-\-deferred ] " "\c
.  IR device_name \ .\|.\|.\&
.  CME
..
.CMD_REMOVE
.
.NSY dmsetup
.de CMD_REMOVE_ALL
.  CMS
.  BR remove_all " "\c
.  RB [ \-f | \-\-force ] " "\c
.  RB [ \-\-deferred ]
.  CME
..
.CMD_REMOVE_ALL
.
.NSY dmsetup
.de CMD_RENAME
.  CMS
.  BR rename " "\c
.  IR device_name " " new_name
.  CME
..
.CMD_RENAME
.
.NSY dmsetup
.de CMD_RENAME_UUID
.  CMS
.  BR rename " "\c
.  IR device_name " "\c
.  BR \-\-setuuid \ \c
.  IR uuid \&
.  CME
..
.CMD_RENAME_UUID
.
.NSY dmsetup
.de CMD_RESUME
.  CMS
.  BR resume " "\c
.  IR device_name \ .\|.\|.\& " "\c
.  RB [ \-\-addnodeoncreate |\: \-\-addnodeonresume ] " "\c
.  RB [ \-\-noflush ] " "\c
.  RB [ \-\-nolockfs ] " "\c
.  RB [ \-\-readahead\ \c
.  RB [ + ]\c
.  IR sec\%tors |\:\c
.  BR auto | none ]
.  CME
..
.CMD_RESUME
.
.NSY dmsetup
.de CMD_SETGEOMETRY
.  CMS
.  BR setgeometry " "\c
.  IR device_name " " cyl " " head " " sect " " start
.  CME
..
.CMD_SETGEOMETRY
.
.NSY dmsetup
.de CMD_SPLITNAME
.  CMS
.  BR splitname " "\c
.  IR device_name " "\c
.  RI [ subsystem ]
.  CME
..
.CMD_SPLITNAME
.
.NSY dmsetup
.de CMD_STATS
.  CMS
.  BR stats " "\c
.  IR command " [" options ]
.  CME
..
.CMD_STATS
.
.NSY dmsetup
.de CMD_STATUS
.  CMS
.  BR status " "\c
.  RB [ \-\-target\ \c
.  IR target_type ] " "\c
.  RB [ \-\-noflush ] " "\c
.  RI [ device_name \ .\|.\|.]
.  CME
..
.CMD_STATUS
.
.NSY dmsetup
.de CMD_SUSPEND
.  CMS
.  BR suspend " "\c
.  IR device_name \ .\|.\|.\& " "\c
.  RB [ \-\-nolockfs ] " "\c
.  RB [ \-\-noflush ]
.  CME
..
.CMD_SUSPEND
.
.NSY dmsetup
.de CMD_TABLE
.  CMS
.  BR table " "\c
.  RB [ \-\-concise ] " "\c
.  RB [ \-\-target\ \c
.  IR target_type ] " "\c
.  RB [ \-\-showkeys ] " "\c
.  RI [ device_name \ .\|.\|.]
.  B \&
.  CME
..
.CMD_TABLE
.
.NSY dmsetup
.de CMD_TARGETS
.  CMS
.  B targets
.  CME
..
.CMD_TARGETS
.
.NSY dmsetup
.de CMD_UDEVCOMPLETE
.  CMS
.  BR udevcomplete " "\c
.  IR cookie \&
.  CME
..
.CMD_UDEVCOMPLETE
.
.NSY dmsetup
.de CMD_UDEVCOMPLETE_ALL
.  CMS
.  BR udevcomplete_all " "\c
.  RI [ age_in_minutes ]
.  CME
..
.CMD_UDEVCOMPLETE_ALL
.
.NSY dmsetup
.de CMD_UDEVCOOKIES
.  CMS
.  B udevcookie
.  CME
..
.CMD_UDEVCOOKIES
.
.NSY dmsetup
.de CMD_UDEVCREATECOOKIE
.  CMS
.  B udevcreatecookie
.  CME
..
.CMD_UDEVCREATECOOKIE
.
.NSY dmsetup
.de CMD_UDEVFLAGS
.  CMS
.  BR udevflags " "\c
.  IR cookie \&
.  CME
..
.CMD_UDEVFLAGS
.
.NSY dmsetup
.de CMD_UDEVRELEASECOOKIE
.  CMS
.  BR udevreleasecookie " "\c
.  RI [ cookie ]
.  CME
..
.CMD_UDEVRELEASECOOKIE
.
.NSY dmsetup
.de CMD_VERSION
.  CMS
.  B version
.  CME
..
.CMD_VERSION
.
.NSY dmsetup
.de CMD_WAIT
.  CMS
.  BR wait " "\c
.  IR device_name " "\c
.  RB [ \-\-noflush ] " "\c
.  RI [ event_nr ]
.  CME
..
.CMD_WAIT
.
.NSY dmsetup
.de CMD_WIPE_TABLE
.  CMS
.  BR wipe_table " "\c
.  IR device_name \ .\|.\|.\& " "\c
.  RB [ \-f | \-\-force ] " "\c
.  RB [ \-\-noflush ] " "\c
.  RB [ \-\-nolockfs ]
.  CME
..
.CMD_WIPE_TABLE
.
.PD
.
.P
.B devmap_name
.I major minor
.br
.
.B devmap_name
.IR major : minor
.
.ad
.hy
.
.SH "توضیحات (DESCRIPTION)"
.
دستور dmsetup دستگاه‌های منطقی را که از درایور نگاشتگر دستگاه (device-mapper) استفاده می‌کنند، مدیریت می‌کند.
دستگاه‌ها با بارگذاری یک جدول نگاشت ایجاد می‌شوند که برای هر سکتور (۵۱۲ بایت) در دستگاه منطقی،
یک هدف (target) مشخص می‌کند.
.P
آرگومان اول dmsetup یک دستور است.
آرگومان دوم نام دستگاه منطقی یا uuid آن است.
.P
فراخوانی ابزار dmsetup به‌صورت \fBdevmap_name\fP
(که به‌طور معمول توزیع نمی‌شود و تنها به دلایل تاریخی پشتیبانی می‌شود) معادل است با:
.na
.BI "dmsetup info \-c \-\-noheadings \-j " major " \-m " minor .
.ad
.
.SH "گزینهها (OPTIONS)"
.
.TP
.B \-\-addnodeoncreate
اطمینان از وجود گره \fI/dev/mapper\fP پس از اجرای \fBdmsetup create\fP.
.
.TP
.B \-\-addnodeonresume
اطمینان از وجود گره \fI/dev/mapper\fP پس از اجرای \fBdmsetup\ resume\fP
(پیشفرض با udev).
.
.TP
.B \-\-checks
انجام بررسی‌های تکمیلی روی عملیات درخواستی و گزارش مشکلات احتمالی.
هنگام اشکال‌زدایی اسکریپت‌ها مفید است.
در برخی موارد ممکن است این بررسی‌ها سرعت عملیات را به‌طور چشمگیری کاهش دهند.
.
.TP
.BR \-c | \-C | \-\-columns
نمایش خروجی در قالب ستون‌ها به‌جای خطوط «Field: Value».
.
.TP
\fB\-\-count\fP \fIcount\fP
تعداد دفعات تکرار گزارش را مشخص می‌کند.
این مقدار را روی صفر تنظیم کنید تا گزارش تا زمان توقف توسط کاربر ادامه یابد.
فاصله زمانی پیشفرض یک ثانیه است.
.
.TP
.BR \-f | \-\-force
تلاش بیشتر برای تکمیل عملیات (اجبار).
.
.TP
.BR \-h | \-\-help
خلاصه‌ای از دستورات موجود را به همراه فهرست فیلدهای گزارش (به‌صورت اختیاری) نمایش می‌دهد (هم‌معنی با دستور \fBhelp\fP).
.
.TP
.B \-\-inactive
هنگام دریافت هرگونه اطلاعات جدول نگاشت از هسته، به‌جای جدول فعال (live)، اطلاعات مربوط به جدول غیرفعال گزارش داده می‌شود.
نیازمند درایور هسته نسخه 4.16.0 یا بالاتر است.
.
.TP
\fB\-\-interval\fP \fIseconds\fP
فاصله زمانی بین تکرارهای متوالی گزارش‌ها را برحسب ثانیه مشخص می‌کند.
اگر گزینه \fB\-\-interval\fP مشخص شود اما \fB\-\-count\fP تعیین نگردد،
تکرار گزارش‌ها تا زمان توقف ادامه می‌یابد.
فاصله زمانی پیشفرض یک ثانیه است.
.
.TP
.BR \-\-manglename " " auto | hex | none
در زمان پردازش نام‌ها و UUIDهای دستگاه‌های نگاشتگر دستگاه، هر کاراکتری را که در فهرست سفید (whitelist) نباشد با استفاده از mangling_mode تغییر شکل (mangle) می‌دهد. نام‌ها و UUIDها در ورودی تغییر شکل داده می‌شوند و در خروجی بازگردانی می‌شوند (unmangled)، که حالت تغییر شکل یکی از موارد زیر است:
\fBauto\fP (فقط در صورتی تغییر شکل می‌دهد که قبلاً انجام نشده باشد، اگر از قبل تغییر یافته باشد کاری انجام نمی‌دهد، در صورت حالت ترکیبی خطا می‌دهد)،
\fBhex\fP (همیشه تغییر شکل را اعمال می‌کند) و
\fBnone\fP (بدون تغییر شکل).
حالت پیشفرض \fBauto\fP است.
فهرست سفید کاراکترها:
.BR 0 \(en 9 ,
.BR A \(en Z ,
.BR a \(en z ,
.BR #+\-.:=@_ .
این فهرست سفید توسط udev نیز پشتیبانی می‌شود.
هر کاراکتری که در فهرست سفید نباشد با مقدار هگزادسیمال آن (دو رقم) با پیشوند \ex جایگزین می‌شود.
حالت تغییر شکل را می‌توان از طریق متغیر محیطی
.B DM_DEFAULT_NAME_MAN\%GLING_MODE
نیز تنظیم کرد.
.
.TP
\fB\-j\fP|\fB \-\-major\fP \fImajor\fP
شماره عمده (major) دستگاه را مشخص می‌کند.
.
.TP
\fB\-m\fP|\fB\-\-minor\fP \fIminor\fP
شماره فرعی (minor) دستگاه را مشخص می‌کند.
.
.TP
.BR \-n | \-\-notable
هنگام ایجاد یک دستگاه، هیچ جدول نگاشتی بارگذاری نشود.
.
.TP
.B \-\-nameprefixes
افزودن پیشوند "DM_" به‌علاوه نام فیلد به خروجی.
در ترکیب با گزینه \fB\-\-noheadings\fP برای تولید فهرستی از جفت‌های field=value جهت تنظیم متغیرهای محیطی مفید است
(برای نمونه، در قوانین
.BR udev (7)
).
.
.TP
.B \-\-noheadings
حذف خط عناوین هنگام استفاده از خروجی ستونی.
.
.TP
.BR \-\-headings " " none |\: abbrev | full |\: 0 | 1 | 2
نوع خط عناوین مورد استفاده برای خروجی ستونی.
.br
\fBnone\fP یا \fB0\fP \(en بدون عناوین.
.br
\fBabbrev\fP یا \fB1\fP \(en نام‌های اختصاری ستون‌ها.
.br
\fBfull\fP یا \fB2\fP \(en نام‌های کامل ستون‌ها.
.
.TP
.B \-\-noflush
هنگام تعلیق یک دستگاه، عملیات I/O معلق را تخلیه (flush) نمی‌کند، یا هنگام دریافت وضعیت thin\-pool، متادیتای thin\-pool را کامیت نمی‌کند.
.
.TP
.B \-\-nolockfs
تلاشی برای همگام‌سازی سیستم‌فایل انجام نمی‌دهد، برای نمونه هنگام تعلیق یک دستگاه.
.
.TP
.B \-\-noopencount
به هسته اطلاع می‌دهد که تعداد ارجاعات باز بودن (open reference count) دستگاه را ارائه ندهد.
.
.TP
.B \-\-noudevrules
به udev اجازه مدیریت گره‌ها را برای دستگاه‌های موجود در پوشه نگاشتگر دستگاه نمی‌دهد.
.
.TP
.B \-\-noudevsync
هنگام ایجاد، تغییر نام یا حذف دستگاه‌ها، با udev همگام‌سازی انجام نمی‌دهد.
.
.TP
\fB\-o\fP|\fB\-\-options\fP \fIoptions\fP
مشخص می‌کند که کدام فیلدها در خروجی نمایش داده شوند.
.
.TP
\fB\-\-readahead\fP [\fB+\fP]\fIsectors\fP|\:\fBauto\fP|\:\fBnone\fP
اندازه پیش‌خوانی (read ahead) را برحسب سکتور مشخص می‌کند.
مقدار پیشفرض \fBauto\fP است که به هسته اجازه می‌دهد یک مقدار مناسب را به‌طور خودکار انتخاب کند.
پیشوند \fB+\fP به شما امکان می‌دهد حداقل مقداری را مشخص کنید که اگر کمتر از مقدار انتخابی هسته باشد، استفاده نخواهد شد.
مقدار \fBnone\fP معادل تعیین صفر است.
.
.TP
.BR \-r | \-\-readonly
جدول نگاشت در حال بارگذاری را فقط‌خواندنی می‌کند.
.
.TP
\fB\-S\fP|\fB\-\-select\fP \fIselection\fP
فقط مواردی را که با معیارهای \fIselection\fP تطابق دارند پردازش می‌کند.
اگر دستور در حال تولید خروجی گزارش باشد،
افزودن ستون "selected" (با \fB\-o selected\fP) همه سطرها را نمایش می‌دهد و اگر سطر با \fIselection\fP مطابقت داشته باشد عدد 1 و در غیر این صورت 0 را نشان می‌دهد.
معیارهای انتخاب با تعیین نام ستون‌ها و مقادیر معتبر آن‌ها با استفاده از عملگرهای مقایسه‌ای پشتیبانی‌شده تعریف می‌شوند.
برای راهنمای سریع و مشاهده فهرست کامل نام ستون‌های قابل استفاده در گزینش و مجموعه عملگرهای انتخابی پشتیبانی‌شده،
خروجی دستور زیر را بررسی کنید:
.na
.nh
.B dmsetup info \-c \-S help
.hy
.ad
.
.TP
\fB\-\-table\fP \fItable\fP
یک جدول نگاشت یک‌خطی را مستقیماً در خط فرمان مشخص می‌کند.
برای اطلاعات بیشتر در مورد قالب جدول نگاشت به بخش‌های زیر مراجعه کنید.
.
.TP
\fB\-\-udevcookie\fP \fIcookie\fP
استفاده از کوکی (cookie) برای همگام‌سازی با udev.
.br
نکته: باید برای عملیات یکسان از کوکی یکسان استفاده شود،
یعنی ایجاد چندین دستگاه مختلف.
ترکیب عملیات مختلف بر روی یک دستگاه منفرد توصیه نمی‌شود.
.
.TP
\fB\-u\fP|\fB\-\-uuid\fP \fIuuid\fP
مشخص کردن \fIuuid\fP.
.
.TP
.BR \-y | \-\-yes
پاسخ بله به تمام اعلان‌ها به‌طور خودکار.
.
.TP
.BR \-v | \-\-verbose " [" \-v |\: \-\-verbose ]
تولید خروجی با جزئیات بیشتر.
برای افزایش جزئیات تا ۴ بار تکرار کنید (\fB\-vvvv\fP):
گزینه \fB\-vv\fP پیام‌های اشکال‌زدایی را فعال می‌کند،
گزینه \fB\-vvv\fP زمان سپری‌شده پس از هر ioctl را اضافه می‌کند،
گزینه \fB\-vvvv\fP نام فایل مبدأ و شماره خطوط را درج می‌کند.
.
.TP
.B \-\-verifyudev
در صورت فعال بودن همگام‌سازی udev، بررسی می‌شود که عملیات udev به‌درستی انجام شود و در غیر این صورت تلاش می‌شود بعداً گره‌های دستگاه اصلاح گردند.
.
.TP
.B \-\-version
نمایش نسخه کتابخانه و درایور هسته.
.
.SH "دستورات (COMMANDS)"
.ds CBR .br
.
.NTP
.CMD_CLEAR
جدول نگاشت موجود در اسلات جدول غیرفعال را برای device_name نابود می‌کند.
.
.NTP
.CMD_CREATE
دستگاهی با نام داده‌شده ایجاد می‌کند.
اگر \fItable\fP یا \fItable_file\fP ارائه شود،
جدول نگاشت بارگذاری شده و فعال (live) می‌شود.
در غیر این صورت جدول از ورودی استاندارد خوانده می‌شود مگر آنکه از \fB\-\-notable\fP استفاده شود.
شناسه اختیاری \fIuuid\fP می‌تواند در دستورات بعدی dmsetup به‌جای device_name استفاده شود.
در صورت موفقیت، دستگاه در جدول نگاشت ظاهر می‌شود و برای دستگاه فعال گره
.na
.I /dev/mapper/device_name
ایجاد می‌گردد.
برای اطلاعات بیشتر درباره قالب جدول نگاشت به بخش‌های زیر مراجعه کنید.
.ad
.
.NTP
.CMD_CREATE_CONCISE
یک یا چند دستگاه را از روی مشخصات فشرده دستگاه ایجاد می‌کند.
هر دستگاه با یک فهرست جداشده با کاما مشخص می‌شود:
.IR name ", " uuid ", " "minor number" ", " flags ,
.IR "comma-separated table lines" .
پرچم‌ها به‌طور پیشفرض خواندن-نوشتن (rw) هستند یا می‌توانند فقط‌خواندنی (ro) باشند.
شناسه‌های Uuid، minor number و flags اختیاری هستند، بنابراین این فیلدها می‌توانند خالی باشند.
یک نقطه-ویرگول مشخصات دستگاه‌های مختلف را از هم جدا می‌کند.
برای اسکیپ کردن کاراکتر بعدی از بک‌اسلش استفاده کنید،
برای نمونه یک کاما یا نقطه-ویرگول در نام یا جدول نگاشت.
همچنین بخش
.B "قالب فشرده (CONCISE FORMAT)"
در زیر را ببینید.
.
.NTP
.CMD_DEPS
فهرستی از دستگاه‌های ارجاع داده‌شده توسط جدول فعال را برای دستگاه مشخص‌شده نمایش می‌دهد. نام دستگاه‌ها در خروجی می‌تواند با گزینه‌های زیر سفارشی‌سازی شود:
\fBdevno\fP (جفت major و minor، استفاده‌شده به‌طور پیشفرض)،
\fBblkdevname\fP (نام دستگاه بلوکی)،
\fBdevname\fP (نام نگاشت برای دستگاه‌های نگاشتگر دستگاه، در غیر این صورت معادل blkdevname).
.
.NTP
.CMD_HELP
خلاصه‌ای از دستورات موجود را نمایش می‌دهد و می‌تواند به‌طور اختیاری شامل فهرست فیلدهای گزارش باشد.
.
.NTP
.CMD_INFO
اطلاعات مختصری درباره دستگاه به این شکل نمایش می‌دهد:
.RS
.RS
.na
.nh
State: SUSPENDED|\:ACTIVE, READ-ONLY
.br
Read Ahead: sectors
.br
Tables present: LIVE and/or INACTIVE
.br
Open reference count
.br
Last event sequence number (used by \fBwait\fP)
.br
Major and minor device number
.br
Number of targets in the live table
.br
UUID
.RE
.RE
.
.NTP
.CMD_INFOLONG
خروجی که می‌توانید آن را سفارشی‌سازی کنید.
فیلدها با کاما از یکدیگر جدا می‌شوند و از فهرست زیر انتخاب می‌گردند:
.BR name ,
.BR major ,
.BR minor ,
.BR attr ,
.BR open ,
.BR segments ,
.BR events ,
.BR uuid .
ویژگی‌ها عبارتند از:
.RB ( L )ive,
.RB ( I )nactive,
.RB ( s )uspended,
.RB ( r )ead-only,
.RB read-( w )rite.
علامت '\fB+\fP' را قبل از فهرست قرار دهید تا به‌جای جایگزینی، به ستون‌های پیشفرض افزوده شود.
علامت '\fB\-\fP' را قبل از هر فیلد مرتب‌سازی قرار دهید تا مرتب‌سازی معکوس روی آن ستون اعمال شود.
.
.NTP
.CMD_LS
فهرست نام دستگاه‌ها. به‌طور اختیاری تنها دستگاه‌هایی را فهرست می‌کند که دست‌کم یک هدف از نوع مشخص‌شده دارند. به‌طور اختیاری برای هر دستگاه یک دستور را اجرا می‌کند. نام دستگاه به انتهای دستور ارائه‌شده الحاق می‌شود.
نام دستگاه‌ها در خروجی می‌تواند با گزینه‌های زیر سفارشی شود:
\fBdevno\fP (جفت major و minor، استفاده‌شده به‌طور پیشفرض)،
\fBblkdevname\fP (نام دستگاه بلوکی)،
\fBdevname\fP (نام نگاشت برای دستگاه‌های نگاشتگر دستگاه، در غیر این صورت معادل blkdevname).
گزینه \fB\-\-tree\fP وابستگی‌های بین دستگاه‌ها را به‌صورت یک درخت نمایش می‌دهد.
این گزینه فهرستی از گزینه‌ها با جداکننده کاما را می‌پذیرد.
برخی از آن‌ها اطلاعات نمایش‌داده‌شده برای هر گره را مشخص می‌کنند:
.BR device\  /\: \ nodevice ;
.BR blkdevname ;
.BR active ,
.BR open ,
.BR rw ,
.BR uuid .
برخی دیگر نحوه نمایش درخت را مشخص می‌کنند:
.BR ascii ,
.BR utf ,
.BR vt100 ;
.BR compact ,
.BR inverted ,
.BR notrunc .
.
.NTP
.CMD_RELOAD
بارگذاری \fItable\fP یا \fItable_file\fP
در اسلات جدول غیرفعال برای device_name.
اگر هیچ‌کدام ارائه نشود، جدول را از ورودی استاندارد می‌خواند.
.
.NTP
.CMD_MANGLE
اطمینان حاصل می‌کند که \fIdevice_name\fP و UUID دستگاه نگاشتگر دستگاه موجود، در قالب تغییر شکل‌یافته (mangled) صحیح و حاوی فقط کاراکترهای فهرست سفید (پشتیبانی‌شده توسط udev) باشد و در صورت لزوم تغییر نام انجام می‌دهد.
هر کاراکتری که در فهرست سفید نباشد بر اساس تنظیم \fB\-\-manglename\fP تغییر شکل می‌یابد. تغییر نام خودکار فقط برای نام دستگاه‌ها عمل می‌کند و برای UUID دستگاه‌ها کار نمی‌کند، زیرا هسته اجازه تغییر دادن UUID دستگاه‌های فعال را نمی‌دهد. هرگونه UUID نادرست تنها گزارش می‌شود و باید با غیرفعال کردن اولیه دستگاه و سپس فعال‌سازی مجدد آن با حالت تغییر شکل مناسب، به‌صورت دستی اصلاح شود (گزینه \fB\-\-manglename\fP را نیز ببینید).
.
.NTP
.CMD_MEASURE
داده‌هایی را نمایش می‌دهد که در صورت راه‌اندازی اندازه‌گیری در زمان جاری، توسط \fIdevice_name\fP به زیرسیستم IMA گزارش می‌شد.
این دستور صرفاً برای اشکال‌زدایی است و در عمل اندازه‌گیری را آغاز نمی‌کند.
.
.NTP
.CMD_MESSAGE
ارسال پیام به هدف (target). اگر به سکتور نیازی نیست از 0 استفاده کنید.
.
.NTP
.CMD_MKNODES
اطمینان حاصل می‌کند که گره موجود در \fI/dev/mapper\fP برای \fIdevice_name\fP صحیح است.
اگر هیچ device_name ارائه نشود، اطمینان حاصل می‌کند که تمام گره‌های موجود در \fI/dev/mapper\fP مربوط به دستگاه‌های نگاشت‌شده‌ای هستند که در حال حاضر توسط درایور کرنل نگاشتگر دستگاه بارگذاری شده‌اند، و در صورت لزوم گره‌ها را اضافه، تغییر یا حذف می‌کند.
.
.NTP
.CMD_REMOVE
یک دستگاه را حذف می‌کند.
دستگاه دیگر برای dmsetup قابل مشاهده نخواهد بود.
دستگاه‌های باز (open) را نمی‌توان حذف کرد، اما افزودن \fB\-\-force\fP جدول نگاشت را با جدولی جایگزین می‌کند که همه عملیات I/O را با خطا مواجه می‌سازد.
گزینه \fB\-\-deferred\fP حذف با تأخیر دستگاه‌های باز را فعال می‌کند \-
دستگاه هنگامی که آخرین کاربر آن را ببندد حذف خواهد شد.
قابلیت حذف با تأخیر از نسخه 4.27.0 درایور نگاشتگر دستگاه در نسخه هسته بالادستی 3.13 پشتیبانی می‌شود.
(از \fBdmsetup version\fP برای بررسی این مورد استفاده کنید.)
اگر تلاشی برای حذف دستگاه ناموفق باشد، احتمالاً به این دلیل که فرآیندی ناشی از اجرای یک قانون سریع udev موقتاً دستگاه را باز کرده است،
گزینه \fB\-\-retry\fP موجب می‌شود که عملیات پیش از اعلام شکست، برای چند ثانیه مجدداً تکرار شود.
گزینه‌های \fB\-\-force\fP و \fB\-\-udevcookie\fP را با یکدیگر ترکیب نکنید،
زیرا ممکن است udev پردازش قوانین udev را در میانه جایگزینی هدف با خطا آغاز کند و منجر به نتایج پیش‌بینی‌نشده شود.
.
.NTP
.CMD_REMOVE_ALL
تلاش برای حذف تمام تعاریف دستگاه‌ها، یعنی بازنشانی درایور (reset).
این دستور همچنین پس از آن \fBmknodes\fP را اجرا می‌کند.
با احتیاط استفاده کنید!
دستگاه‌های باز را نمی‌توان حذف کرد، اما افزودن \fB\-\-force\fP جدول نگاشت را با جدولی جایگزین می‌کند که همه عملیات I/O را با خطا مواجه می‌سازد.
گزینه \fB\-\-deferred\fP حذف با تأخیر دستگاه‌های باز را فعال می‌کند \-
دستگاه با بسته شدن توسط آخرین کاربر حذف خواهد شد.
قابلیت حذف با تأخیر از نسخه 4.27.0 درایور نگاشتگر دستگاه موجود در نسخه بالادستی 3.13 هسته پشتیبانی می‌شود.
.
.NTP
.CMD_RENAME
تغییر نام یک دستگاه.
.
.NTP
.CMD_RENAME_UUID
تنظیم uuid برای دستگاهی که بدون uuid ایجاد شده است.
پس از تنظیم، uuid قابل تغییر نیست.
.
.NTP
.CMD_RESUME
خروج دستگاه از حالت تعلیق.
اگر یک جدول نگاشت غیرفعال بارگذاری شده باشد، فعال می‌شود.
سپس I/O به تعویق افتاده مجدداً برای پردازش در صف قرار می‌گیرد.
.
.NTP
.CMD_SETGEOMETRY
تنظیم هندسه دستگاه برحسب C/H/S.
.
.NTP
.CMD_SPLITNAME
نام دستگاه داده‌شده (\fIdevice name\fP) را به مؤلفه‌های تشکیل‌دهنده \fIsubsystem\fP تفکیک می‌کند.
زیرسیستم پیشفرض LVM است.
در حال حاضر LVM نام دستگاه‌ها را با الحاق نام‌های گروه حجم (Volume Group)، حجم منطقی (Logical Volume) و هر لایه داخلی با خط تیره به‌عنوان جداکننده تولید می‌کند.
هر خط تیره درون نام‌ها برای اسکیپ شدن دو برابر می‌شود.
کدگذاری دقیق ممکن است در نسخه‌های بعدی بدون اطلاع قبلی تغییر کند، بنابراین توصیه می‌کنیم همیشه با استفاده از نسخه فعلی این دستور رمزگشایی را انجام دهید.
.
.NTP
.CMD_STATS
مدیریت نواحی آمار IO برای دستگاه‌ها.
برای جزئیات بیشتر
.BR dmstats (8)
را ببینید.
.
.NTP
.CMD_STATUS
نمایش اطلاعات وضعیت برای هریک از اهداف دستگاه.
با گزینه \fB\-\-target\fP، تنها اطلاعات مربوط به نوع هدف مشخص‌شده نمایش داده می‌شود.
با گزینه \fB\-\-noflush\fP، هدف thin (از نسخه 1.3.0) هیچ‌یک از تغییرات معلق را پیش از گزارش آمار خود بر روی دیسک کامیت نمی‌کند.
.
.NTP
.CMD_SUSPEND
تعلیق یک دستگاه. هر عملیات I/O که قبلاً توسط دستگاه نگاشت شده اما هنوز کامل نشده است تخلیه (flush) خواهد شد. هرگونه I/O بعدی به آن دستگاه تا زمانی که دستگاه در حالت تعلیق است به تعویق خواهد افتاد.
اگر سیستم‌فایلی روی دستگاه باشد که از این عملیات پشتیبانی کند، ابتدا تلاشی برای همگام‌سازی (sync) آن انجام می‌شود مگر اینکه \fB\-\-nolockfs\fP مشخص شده باشد.
برخی از اهداف مانند نسخه‌های اخیر multipath (اکتبر ۲۰۰۶) ممکن است از گزینه \fB\-\-noflush\fP پشتیبانی کنند. این گزینه به I/Oهای معلقی که هنوز به دستگاه نرسیده‌اند اجازه می‌دهد تخلیه‌نشده باقی بمانند.
.
.NTP
.CMD_TABLE
جدول نگاشت فعلی دستگاه را در قالبی نمایش می‌دهد که می‌توان با دستورات create یا load مجدداً از آن استفاده کرد.
با گزینه \fB\-\-target\fP، تنها اطلاعات مربوط به نوع هدف مشخص‌شده نمایش داده می‌شود.
کلیدهای رمزنگاری واقعی در خروجی جدول برای اهداف crypt و integrity پنهان می‌شوند مگر اینکه پارامتر \fB\-\-showkeys\fP ارائه شود. ارجاعات کلید هسته با پیشوند \fB:\fP تحت تأثیر این پارامتر قرار نمی‌گیرند و همیشه نمایش داده می‌شوند (فقط برای هدف crypt).
با گزینه \fB\-\-concise\fP، خروجی به‌صورت فشرده در یک خط ارائه می‌شود.
سپس کاماها نام، uuid، شماره فرعی دستگاه، پرچم‌ها ('ro' یا 'rw') و جدول نگاشت (در صورت وجود) را از هم جدا می‌کنند. نقطه-ویرگول‌ها دستگاه‌ها را جدا می‌سازند.
بک‌اسلش‌ها کاماها، نقطه-ویرگول‌ها یا بک‌اسلش‌ها را اسکیپ می‌کنند.
بخش
.B "قالب فشرده (CONCISE FORMAT)"
در زیر را ببینید.
.
.NTP
.CMD_TARGETS
نام‌ها و نسخه‌های اهداف در حال حاضر بارگذاری‌شده را نمایش می‌دهد.
.
.NTP
.CMD_UDEVCOMPLETE
بیدار کردن فرآیندهایی که در انتظار اتمام پردازش کوکی مشخص‌شده توسط udev هستند.
.
.NTP
.CMD_UDEVCOMPLETE_ALL
حذف تمام کوکی‌های قدیمی‌تر از تعداد دقایق مشخص‌شده.
هر فرآیندی که روی یک کوکی در انتظار باشد بلافاصله از سر گرفته می‌شود.
.
.NTP
.CMD_UDEVCOOKIES
فهرست تمام کوکی‌های موجود. کوکی‌ها سمافورهای سراسری سیستم هستند که کلیدهای آن‌ها با دو بایت از پیش تعیین‌شده (0x0D4D) پیشوندگذاری شده‌اند.
.
.NTP
.CMD_UDEVCREATECOOKIE
یک کوکی جدید برای همگام‌سازی اقدامات با پردازش udev ایجاد می‌کند.
خروجی، مقدار کوکی است. معمولاً نیازی به ایجاد کوکی نداریم زیرا dmsetup به‌طور خودکار آن‌ها را برای هر اقدام ایجاد کرده و از بین می‌برد.
با این حال، می‌توانیم به‌طور صریح یک کوکی بسازیم تا چندین اقدام را با هم گروه‌بندی کرده و در عوض تنها از یک کوکی استفاده کنیم.
می‌توانیم با استفاده از گزینه \fB\-\-udevcookie\fP کوکی مورد استفاده را برای هر دستور مربوطه تعریف کنیم.
همچنین می‌توانیم این مقدار را در متغیر محیطی فرآیند dmsetup با نام \fBDM_UDEV_COOKIE\fP صادر (export) کنیم تا به‌طور خودکار در تمام دستورات بعدی تا زمان حذف متغیر استفاده شود.
فراخوانی این دستور یک سمافور سراسری در سیستم ایجاد می‌کند که باید با فراخوانی صریح دستور udevreleasecookie پاکسازی گردد.
.
.NTP
.CMD_UDEVFLAGS
مقدار \fIcookie\fP داده‌شده را تجزیه می‌کند و هرگونه پرچم‌های کنترلی udev کدگذاری‌شده را استخراج می‌نماید.
خروجی در قالب کلید متغیر محیطی است که برای استفاده در قوانین udev مناسب است. اگر پرچم نام نمادین داشته باشد، خروجی به شکل زیر است:
.na
DM_UDEV_FLAG_\:<flag_\:name> =\ '1'،
DM_UDEV_FLAG\:<flag_\:position> =\ '1'
.ad
در غیر این صورت.
پرچم‌های udev زیرسیستم فاقد نام‌های نمادین هستند و این پرچم‌ها همیشه به‌صورت:
.na
DM_SUBSYSTEM_\:UDEV_\:FLAG\:<flag_\:position> =\ '1'.
.ad
گزارش می‌شوند.
در مجموع ۱۶ پرچم udev وجود دارد.
.
.NTP
.CMD_UDEVRELEASECOOKIE
منتظر تمامی پردازش‌های معلق udev مرتبط با مقدار کوکی داده‌شده می‌ماند و کوکی را همراه با سمافور زیرین آن پاکسازی می‌کند. اگر کوکی مستقیماً مشخص نشده باشد، دستور تلاش می‌کند از مقدار تعریف‌شده توسط متغیر محیطی \fBDM_UDEV_COOKIE\fP استفاده کند.
.
.NTP
.CMD_VERSION
نمایش اطلاعات نسخه.
.
.NTP
.CMD_WAIT
تا زمانی که شمارنده رویداد برای device_name از event_nr بیشتر شود، متوقف می‌شود (sleep).
برای مشاهده شماره رویداد برگردانده‌شده از \fB\-v\fP استفاده کنید.
برای صبر کردن تا زمان فعال‌سازی رویداد بعدی، از \fBinfo\fP برای یافتن آخرین شماره رویداد استفاده کنید.
با گزینه \fB\-\-noflush\fP، هدف thin (از نسخه 1.3.0) هیچ‌یک از تغییرات معلق را قبل از گزارش آماری خود روی دیسک کامیت نمی‌کند.
.
.NTP
.CMD_WIPE_TABLE
منتظر می‌ماند تا تمامی عملیات I/O در حال اجرا از طریق دستگاه کامل شوند، سپس جدول نگاشت را با جدولی جدید جایگزین می‌کند که هرگونه I/O ارسالی جدید به دستگاه را با خطا مواجه می‌سازد. در صورت موفقیت، این عمل باید هر دستگاهی را که توسط جدول(های) دستگاه باز نگه داشته شده است، آزاد کند.
.
.SH "قالب جدول (TABLE FORMAT)"
.
هر خط از جدول نگاشت، یک هدف (target) منفرد را مشخص می‌کند و به شکل زیر است:
.P
.shc \\
.na
.nh
.I \%logical_start_sector\%\ num_sectors\%\ \c
.B target_type\%\ \c
.I target_args
.hy
.ad
.shc
.
.sp
انواع ساده هدف و آرگومان‌های هدف عبارتند از:
.
.NTP
.CMS
\fBlinear\fP \fIdestination_device start_sector\fP
.CME
نگاشت خطی مرسوم.
.
.NTP
.CMS
\fBstriped\fP \fInum_stripes chunk_size\fP \
[\fIdestination start_sector\fP]\ .\|.\|.
.CME
ایجاد یک ناحیه راه‌راه (striped).
.br
.na
برای نمونه striped 2 32 /dev/hda1 0 /dev/hdb1 0
اولین چانک (16\ KiB) را به این صورت نگاشت می‌کند:
.RS
.RS
LV chunk 1 \[->] hda1, chunk 1
.br
LV chunk 2 \[->] hdb1, chunk 1
.br
LV chunk 3 \[->] hda1, chunk 2
.br
LV chunk 4 \[->] hdb1, chunk 2
.br
و غیره.
.RE
.RE
.na
.
.TP
.B error
هرگونه I/O به این ناحیه را با خطا مواجه می‌کند. برای آزمایش یا ایجاد دستگاه‌هایی با حفره (hole) درون آن‌ها کاربرد دارد.
.
.TP
.B zero
هنگام خواندن، بلوک‌هایی از صفر را برمی‌گرداند.
هر داده‌ای که نوشته شود بی سر و صدا دور انداخته می‌شود.
این یک معادل دستگاه بلوکی از سینک داده دستگاه کاراکتری \fI/dev/zero\fP شرح داده‌شده در \fBnull\fP(4) است.
.P
اهداف پیچیده‌تر عبارتند از:
.
.TP
.B cache
کارایی یک دستگاه بلوکی (مانند یک هارد دیسک چرخشی) را با مهاجرت پویای بخشی از داده‌های آن به یک دستگاه کوچک‌تر و سریع‌تر (مانند یک SSD) بهبود می‌بخشد.
.
.TP
.B crypt
رمزنگاری شفاف دستگاه‌های بلوکی با استفاده از API رمزنگاری هسته (crypto API).
.
.TP
.B delay
خواندن و/یا نوشتن روی دستگاه‌های مختلف را به تأخیر می‌اندازد.
برای آزمایش مفید است.
.
.TP
.B flakey
نگاشتی شبیه به هدف linear ایجاد می‌کند
اما به‌صورت دوره‌ای رفتارهای نامطمئن و خطا از خود نشان می‌دهد.
برای شبیه‌سازی خرابی دستگاه‌ها هنگام آزمایش کاربرد دارد.
.
.TP
.B mirror
داده‌ها را روی دو یا چند دستگاه آینه‌سازی (mirror) می‌کند.
.
.TP
.B multipath
دسترسی را از طریق چندین مسیر به یک دستگاه واحد میانجی‌گری می‌کند.
.
.TP
.B raid
یک رابط به درایور RAID نرم‌افزاری هسته، یعنی md ارائه می‌دهد.
.
.TP
.B snapshot
پشتیبانی از اسنپ‌شات‌های (تصاویر لحظه‌ای) دستگاه‌ها را فراهم می‌کند.
.
.TP
.BR thin ", " thin\-pool
از تخصیص پویای فضا (thin provisioning) در دستگاه‌ها پشتیبانی می‌کند و همچنین پشتیبانی بهتری از اسنپ‌شات ارائه می‌دهد.
.P
برای کسب اطلاعات بیشتر درباره اهداف گوناگون، قالب‌های جدول نگاشت آن‌ها و خطوط وضعیت، لطفاً فایل‌های موجود در دایرکتوری
Documentation/device-mapper
در درخت کد منبع هسته را مطالعه کنید.
(ممکن است توزیع شما نسخه‌ای از این اطلاعات را در پوشه مستندات بسته device-mapper گنجانده باشد.)
.
.SH "مثال‌ها (EXAMPLES)"
.
.EX
# A table to join two disks together
0 1028160 linear /dev/hda 0
1028160 3903762 linear /dev/hdb 0
.sp
# A table to stripe across the two disks,
# and add the spare space from
# hdb to the back of the volume
0 2056320 striped 2 32 /dev/hda 0 /dev/hdb 0
2056320 2875602 linear /dev/hdb 1028160
.EE
.
.SH "قالب فشرده (CONCISE FORMAT)"
.
نمایش فشرده از یک یا چند دستگاه:
.
.PD 0
.
.IP \(bu 2
یک کاما فیلدهای هر دستگاه را از هم جدا می‌کند.
.
.IP \(bu
یک نقطه-ویرگول دستگاه‌ها را جدا می‌کند.
.
.PD
.
.P
نمایش یک دستگاه به شکل زیر است:
.RS
.shc \\
.na
.nh
.RI \%< name >,< uuid >,\%< minor >,< flags >,\%< table >\%\c
.RI [,< table >+]\%\c
.RI [;< name >,< uuid >,\%< minor >,< flags >,\%< table >\%\c
.RI [,< table >+]]
.hy
.ad
.shc
.RE
.
.P
فیلدها عبارتند از:
.
.TP
.I name
نام دستگاه.
.
.TP
.I uuid
شناسه UUID دستگاه (یا خالی).
.
.TP
.I minor
شماره فرعی (minor) دستگاه.
اگر خالی باشد، هسته یک شماره فرعی مناسب اختصاص می‌دهد.
.
.TP
.I flags
پرچم‌های پشتیبانی‌شده عبارتند از:
.
.PD 0
.RS
.
.TP 4
.B ro
جدول نگاشت در حال بارگذاری را برای دستگاه فقط‌خواندنی تنظیم می‌کند
.
.TP
.B rw
جدول نگاشت در حال بارگذاری را برای دستگاه خواندن-نوشتن تنظیم می‌کند (پیشفرض)
.RE
.PD
.
.TP
.I table
یک خط از جدول نگاشت. بخش «قالب جدول» در بالا را ببینید.
.
.SH "مثال‌ها (EXAMPLES)"
.
.EX
# A simple linear read-only device
test-linear\-small,,,ro,\\
\ 0 2097152 linear /dev/loop0\ 0,\\
\ 2097152 2097152 linear /dev/loop1 0
.sp
# Two linear devices
test-linear\-small,,,,\\
\ 0 2097152 linear /dev/loop0 0;\\
\ test-linear\-large,,,,\\
\ 0 2097152 linear /dev/loop1 0,\\
\ 2097152 2097152 linear /dev/loop2 0
.EE
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
.TP
.B DM_DEV_DIR
نام دایرکتوری دستگاه‌ها.
پیشفرض "\fI/dev\fP" است و باید یک مسیر مطلق باشد.
.
.TP
.B DM_UDEV_COOKIE
کوکی مورد استفاده برای تمام دستورات مربوطه جهت همگام‌سازی با پردازش udev.
این یک جایگزین برای استفاده از گزینه \fB\-\-udevcookie\fP است.
.
.TP
.B DM_DEFAULT_NAME_MANGLING_MODE
حالت پیشفرض تغییر شکل (mangling).
پیشفرض "\fBauto\fP" است
و یک جایگزین برای استفاده از گزینه \fB\-\-manglename\fP است.
.
.TP
.B DM_DEBUG_WITH_LINE_NUMBERS
تنظیم روی \fB1\fP برای افزودن فایل مبدأ و شماره خط به پیام‌های اشکال‌زدایی.
به‌طور خودکار توسط \fB\-vvvv\fP فعال می‌شود.
.
.SH "نویسندگان (AUTHORS)"
.
.na
.nh
نسخه اصلی:
.MT thornber@redhat.com
Joe Thornber
.ME
.
.SH "همچنین ببینید (SEE ALSO)"
.
.na
.nh
.BR dmstats (8),
.BR udev (7),
.BR udevadm (8)
.P
.UR https://\:www.sourceware.org/lvm2
صفحه منابع LVM2:
.UE
.br
.UR https://\:www.sourceware.org/dm
صفحه منابع نگاشتگر دستگاه:
.UE