.TH "LVMDEVICES" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.ie t \{\
.\" PostScript/PDF with tabs
. ds TT \t
. ds DTT \t\t
.\}
.el \{\
. ds TT \&
. ds DTT \0\0\0
.\}
.
.de OPT
.ie \\n(.$>1 \\*[TT]\fB\-\\$1\fP|\\*[TT]\fB\-\-\\$2\fP\c
.el \\*[DTT]\fB\-\-\\$1\fP\c
..
.
.de OPA
.OPT \\$*
\ \c
..
.de OPS
.OPT \\$*
\&
..
.
.\"List of all options as O_string.
.
.de O_adddev
.OPA adddev
\fIPV\fP
..
.de O_addid
.OPA addid
\fIString\fP
..
.de O_addpvid
.OPA addpvid
\fIString\fP
..
.de O_check
.OPS check
..
.de O_commandprofile
.OPA commandprofile
\fIString\fP
..
.de O_config
.OPA config
\fIString\fP
..
.de O_debug
.OPA d debug
\&.\|.\|.\&
..
.de O_deldev
.OPA deldev
\fIString\fP
..
.de O_delid
.OPA delid
\fIString\fP
..
.de O_delnotfound
.OPS delnotfound
..
.de O_delpvid
.OPA delpvid
\fIString\fP
..
.de O_deviceidtype
.OPA deviceidtype
\fIString\fP
..
.de O_devices
.OPA devices
\fIPV\fP
..
.de O_devicesfile
.OPA devicesfile
\fIString\fP
..
.de O_driverloaded
.OPA driverloaded
\fBy\fP|\fBn\fP
..
.de O_force
.OPA f force
\&.\|.\|.\&
..
.de O_help
.OPS h help
..
.de O_journal
.OPA journal
\fIString\fP
..
.de O_listids
.OPA listids
\fIPV\fP
..
.de O_lockopt
.OPA lockopt
\fIString\fP
..
.de O_longhelp
.OPS longhelp
..
.de O_nohints
.OPS nohints
..
.de O_nolocking
.OPS nolocking
..
.de O_profile
.OPA profile
\fIString\fP
..
.de O_quiet
.OPA q quiet
\&.\|.\|.\&
..
.de O_refresh
.OPS refresh
..
.de O_test
.OPS t test
..
.de O_update
.OPS update
..
.de O_verbose
.OPA v verbose
\&.\|.\|.\&
..
.de O_version
.OPS version
..
.de O_yes
.OPS y yes
..
.
.SH "نام (NAME)"
lvmdevices \- مدیریت فایل لیست دستگاههای مجاز در سامانه LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBlvmdevices\fP [\fIگزینهها\fR]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBlvmdevices\fR فایل لیست دستگاههای محلی (devices file) در LVM2 را مدیریت میکند تا مشخص شود کدام دیسکها و پارتیشنها توسط دستورات LVM بررسی و استفاده شوند.
.P
فایل دستگاه‌های LVM فهرستی از دستگاه‌هایی است که دستورات lvm از آن‌ها استفاده خواهند کرد.
این فایل در مسیر
.I /etc/lvm/devices/system.devices
قرار دارد.
دستور
.BR lvmdevices (8)
این فایل را مدیریت می‌کند و برای افزودن، حذف و فهرست‌بندی دستگاه‌ها به کار می‌رود.
.P
.SS "فهرست کردن دستگاه‌ها (Listing devices)"
دستور lvmdevices را بدون هیچ گزینه یا آرگومانی اجرا کنید تا مدخل‌های موجود در system.devices نمایش داده شوند:
.br
.B lvmdevices
.P
هر خط با نام فعلی دستگاه در سیستم آغاز می‌شود، به دنبال آن شناسه دستگاه (device ID) از فایل دستگاه‌ها می‌آید، و سپس سایر جزئیات دستگاه که توسط lvm استفاده می‌شوند درج می‌گردد.
چنانچه هیچ دستگاهی در سیستم با شناسه دستگاه مطابقت نداشته باشد، خط با "Device none" آغاز می‌شود.
(مشاهده مستقیم فایل system.devices مشخص نمی‌کند که آیا دستگاهی در سیستم وجود دارد یا خیر.)
.P
.SS "افزودن دستگاه‌ها (Adding devices)"
برای استفاده از یک دستگاه با lvm، آن را با یکی از دستورهای زیر به فایل دستگاه‌ها اضافه کنید.
.P
افزودن یک دستگاه با ارجاع به مسیر دستگاه:
.br
.B lvmdevices \-\-adddev
.I device
.P
افزودن یک دستگاه با ارجاع به PVID آن:
.br
.B lvmdevices \-\-addpvid
.I PVID
.P
افزودن یک دستگاه با ارجاع به شناسه دستگاه آن:
.br
.B lvmdevices \-\-addid
.I IDNAME
.B \-\-deviceidtype
.I IDTYPE
.P
افزودن تمام PVهای موجود در یک VG:
.br
.B vgimportdevices
.I VG
.P
افزودن تمام PVهای موجود در تمامی VGهای قابل مشاهده:
.br
.B vgimportdevices \-a
.P
دستورهای
.BR pvcreate ،
.B vgcreate
و
.B vgextend
نیز خارج از فایل دستگاه‌های موجود را جستجو می‌کنند تا دستگاه هدف را بیابند، و به طور خودکار آن را به فایل دستگاه‌ها اضافه می‌نمایند.
.P
.SS "حذف دستگاه‌ها (Removing devices)"
حذف یک دستگاه از فایل دستگاه‌ها مانع از دیدن یا استفاده آن دستگاه توسط lvm می‌شود. یک دستگاه را با یکی از دستورهای زیر حذف کنید.
.P
حذف یک دستگاه با ارجاع به مسیر دستگاه:
.br
.B lvmdevices \-\-deldev
.I device
.P
حذف یک دستگاه با ارجاع به PVID آن:
.br
.B lvmdevices \-\-delpvid
.I PVID
.P
حذف یک دستگاه با ارجاع به شناسه دستگاه آن:
.br
.B lvmdevices \-\-delid
.I IDNAME
.B \-\-deviceidtype
.I IDTYPE
.P
.SS "شناسه‌های دستگاه (device IDs)"
سامانه LVM دستگاه‌ها را در فایل دستگاه‌ها با استفاده از شناسه‌های مختص به سخت‌افزار مانند WWID یا شماره سریال شناسایی می‌کند. برای انواع دستگاه‌های مجازی شناسه‌های مختص به زیرسیستم به کار می‌روند که هدف آن‌ها نیز یکتا و پایدار بودن است.
هنگامی که هیچ شناسه سخت‌افزاری یا زیرسیستمی در دسترس نباشد، lvm به عنوان راهکار جایگزین از نام دستگاه به عنوان شناسه دستگاه استفاده می‌کند. استفاده از نام دستگاه‌ها به عنوان شناسه بهینه نیست زیرا آن‌ها پایدار نیستند و معمولاً پس از راه‌اندازی مجدد سیستم تغییر می‌کنند. هنگامی که نام دستگاه‌ها به عنوان شناسه استفاده شوند، چنانچه نام دستگاه تغییر کند lvm باید پویش‌های اضافی دستگاه را برای مکان‌یابی دستگاه‌ها انجام دهد.
.P
هنگامی که شناسه‌های پایدار دستگاه استفاده شوند، lvm به دستگاه‌هایی خارج از موارد فهرست‌شده در فایل دستگاه‌ها دسترسی نخواهد داشت. هنگامی که از نام دستگاه‌ها به عنوان شناسه استفاده شود، lvm دستگاه‌های خارج از فایل دستگاه‌ها را پویش می‌کند تا PVها را روی دستگاه‌هایی که نامشان تغییر کرده است بیابد. تنظیم پیکربندی search_for_devnames می‌تواند برای کنترل رفتار lvm در یافتن مدخل‌های devname تغییر نام‌یافته استفاده شود.
.P
یک شناسه دستگاه دارای دو بخش است: IDTYPE و IDNAME.
.P
مقدار IDTYPE خاستگاه شناسه را مشخص می‌کند، و IDNAME شناسه واقعی است. مجموعه‌ای از پیش تعریف‌شده از IDTYPEها در بخش بعد فهرست شده است. یک مدخل فایل دستگاه‌ها باید یکی از این انواع شناسه را داشته باشد. هنگام افزودن دستگاه به فایل دستگاه‌ها، lvm به طور خودکار بهترین IDTYPE را انتخاب می‌کند که می‌توان آن را با گزینه
.B \-\-deviceidtype
تغییر داد (این کار به طور کلی توصیه نمی‌شود).
.P
برای نمایش تمام شناسه‌های ممکن برای یک دستگاه، یا مقدار یک نوع مشخص، از این دستورها استفاده کنید:
.P
.br
.B lvmdevices \-\-listids
.I device
.br
.B lvmdevices \-\-listids
.I device
.B \-\-deviceidtype
.I IDTYPE
.P
.SS "انواع شناسه دستگاه (device ID types)"
انواع موجود برای شناسه دستگاه عبارتند از:
.br
.IP \[bu] 2
.B sys_wwid
از مقدار wwid گزارش‌شده توسط فایل wwid در sysfs استفاده می‌کند. این نخستین انتخاب است.
.IP \[bu]
.B wwid_naa
از naa wwid رمزگشایی‌شده از فایل vpd_pg83 در sysfs استفاده می‌کند.
.IP \[bu]
.B wwid_eui
از eui wwid رمزگشایی‌شده از فایل vpd_pg83 در sysfs استفاده می‌کند.
.IP \[bu]
.B wwid_t10
از t10 wwid رمزگشایی‌شده از فایل vpd_pg83 در sysfs استفاده می‌کند.
.IP \[bu]
.B sys_serial
از شماره سریال گزارش‌شده توسط فایل sysfs سریال یا فایل vpd_pg80 استفاده می‌کند. چنانچه wwid در دسترس نباشد از شماره سریال استفاده می‌شود.
.IP \[bu]
.B mpath_uuid
برای دستگاه‌های dm multipath استفاده می‌شود و توسط sysfs گزارش می‌گردد.
.IP \[bu]
.B crypt_uuid
برای دستگاه‌های dm crypt استفاده می‌شود و توسط sysfs گزارش می‌گردد.
.IP \[bu]
.B md_uuid
برای دستگاه‌های md استفاده می‌شود و توسط sysfs گزارش می‌گردد.
.IP \[bu]
.B lvmlv_uuid
چنانچه یک PV بر روی یک LV در lvm قرار گرفته باشد استفاده می‌شود و توسط sysfs گزارش می‌گردد.
.IP \[bu]
.B loop_file
برای دستگاه‌های loop استفاده می‌شود و نام فایل پشتیبان است که توسط sysfs گزارش می‌گردد.
.IP \[bu]
.B devname
چنانچه هیچ نوع دیگری اعمال نشود از نام دستگاه استفاده می‌شود.
.IP \[bu]
.B nvme_uuid, nvme_nguid, nvme_eui64
عموماً استفاده نمی‌شوند، اما ممکن است برای دستگاه‌های nvme که مقادیر نامعتبر wwid را گزارش می‌کنند ظاهر شوند.
.P
.SS "فایل‌های sysfs (sysfs files)"
بیشتر انواع شناسه دستگاه مقدار شناسه را از sysfs می‌خوانند.
این مقادیر sysfs همچنین می‌توانند به طور مستقیم از مسیرهای زیر خوانده شوند:
.P
.nf
/sys/dev/block/\fImajor\fP:\fIminor\fP/device/wwid
/sys/dev/block/\fImajor\fP:\fIminor\fP/device/serial
/sys/dev/block/\fImajor\fP:\fIminor\fP/wwid
/sys/dev/block/\fImajor\fP:\fIminor\fP/device/vpd_pg83 (binary)
/sys/dev/block/\fImajor\fP:\fIminor\fP/device/vpd_pg80 (binary)
/sys/dev/block/\fImajor\fP:\fIminor\fP/dm/uuid (lvm reads via ioctl)
/sys/dev/block/\fImajor\fP:\fIminor\fP/md/uuid
/sys/dev/block/\fImajor\fP:\fIminor\fP/loop/backing_file
.fi
.P
(برخی از مقادیر sysfs پیش از استفاده به عنوان شناسه دستگاه دستکاری می‌شوند، مثلاً فاصله‌های خالی حذف شده یا با زیرخط جایگزین می‌شوند.)
.P
.SS "محتویات فایل دستگاه‌ها (devices file contents)"
علاوه بر شناسه‌های دستگاه، LVM اطلاعات تکمیلی دیگری را نیز در فایل دستگاه‌ها می‌نویسد. در صورت تغییر، دستورات LVM به طور خودکار این اطلاعات را به‌روز می‌کنند. این اطلاعات شامل آخرین نام شناخته‌شده دستگاه، و UUID مربوط به PV (یا PVID) برگرفته از سرآیند دیسک LVM است.
.P
بررسی اینکه آیا محتوای فایل دستگاه‌ها نیاز به به‌روزرسانی دارد:
.br
.B lvmdevices \-\-check
.P
به‌روزرسانی فیلدهای فایل دستگاه‌ها که قدیمی هستند:
.br
.B lvmdevices \-\-update
.P
فایل دستگاه‌ها برای ویرایش توسط دستورات lvm در نظر گرفته شده است، نه کاربر. فایل دستگاه‌ها حاوی یک مقدار HASH است که lvm از آن برای تشخیص تغییر فایل از زمان آخرین بازنویسی توسط lvm استفاده می‌کند.
هنگامی که lvm فایل دستگاه‌ها را به‌روزرسانی می‌کند، نسخه پیشین به مسیر
.I /etc/lvm/devices/backup/
منتقل می‌شود.
.P
فیلدهای زیر را می‌توان در فایل دستگاه‌ها یافت:
.br
VERSION: به ازای هر بار به‌روزرسانی فایل افزایش می‌یابد.
.br
PRODUCT_UUID: یک شناسه یکتای ماشین که برای تشخیص جابجایی فایل system.devices به یک ماشین جدید و نیاز احتمالی به به‌روزرسانی استفاده می‌شود. هنگامی که در دسترس نباشد از HOSTNAME استفاده می‌شود.
.P
فیلدهای مدخل دستگاه:
.br
IDTYPE: منبع مقدار شناسه دستگاه در IDNAME را نشان می‌دهد.
.br
IDNAME: مقدار یکتای شناسه دستگاه.
.br
DEVNAME: تازه‌ترین نام دستگاه مرتبط با شناسه دستگاه.
.br
PVID: مقدار UUID مربوط به LVM PV از سرآیند دیسک LVM.
.br
PART: شماره پارتیشن در صورتی که یک PV بر روی یک پارتیشن قرار داشته باشد.
.P
.SS "تازه‌سازی شناسه دستگاه (device ID refresh)"
هنگامی که lvm فایل system.devices را می‌نویسد، شناسه محلی ماشین را نیز در فایل system.devices درج می‌کند (به صورت PRODUCT_UUID یا HOSTNAME). هنگامی که lvm فایل system.devices را می‌خواند، این شناسه ذخیره‌شده ماشین را با ماشین فعلی مقایسه می‌کند، که به lvm امکان می‌دهد کپی یا بازیابی شدن system.devices روی یک ماشین دیگر را تشخیص دهد. با تشخیص تغییر ماشین، lvm حالت «تازه‌سازی شناسه دستگاه» (device ID refresh) را فعال می‌کند (پیکربندی‌شده توسط device_ids_refresh و device_ids_refresh_checks در lvm.conf).
.P
در حالت تازه‌سازی، دستگاهی در system.devices که با شناسه دستگاه خود یافت نشود، با استفاده از PVID خود پیدا خواهد شد. سامانه LVM تمام دستگاه‌های موجود در سیستم را برای جستجوی PVIDهای مفقود در system.devices پویش خواهد کرد. اگر یک PVID روی دستگاه جدیدی یافت شود، مدخل system.devices با شناسه دستگاه جدیدی منطبق با دستگاه جدیدی که PVID روی آن پیدا شده به‌روزرسانی می‌شود. حالت تازه‌سازی می‌تواند طوری پیکربندی شود که یک‌بار اجرا شود (هنگامی که تغییر ماشین برای نخستین بار تشخیص داده می‌شود)، یا برای مدت‌زمانی پس از نخستین تازه‌سازی فعال بماند، یا به طور کامل غیرفعال شود.
.P
.B device_ids_refresh = 0
.br
حالت تازه‌سازی را غیرفعال می‌کند.
.P
.B device_ids_refresh = 1
.br
یک تلاش برای تازه‌سازی شناسه‌های دستگاه را هنگام تشخیص اولیه تغییر ماشین فعال می‌کند.
.P
.B device_ids_refresh =
.I seconds
.br
حالت تازه‌سازی برای این تعداد ثانیه پس از تلاش اولیه تازه‌سازی، یا تا زمانی که تمام PVهای موجود در system.devices یافت شوند، فعال می‌ماند. در طول این دوره، یک خط REFRESH_UNTIL در system.devices ظاهر می‌شود. مقادیر مجاز بین ۱۰ تا ۶۰۰ ثانیه است.
.P
علاوه بر حالت خودکار تازه‌سازی شناسه دستگاه، تازه‌سازی می‌تواند به صورت دستی نیز انجام شود:
.P
بررسی اینکه آیا system.devices با شناسه‌های جدید دستگاه به‌روزرسانی خواهد شد:
.br
.B lvmdevices \-\-check \-\-refresh
.P
به‌روزرسانی system.devices با شناسه‌های جدید در صورتی که PVها روی دستگاه‌های جدید پیدا شوند:
.br
.B lvmdevices \-\-update \-\-refresh
.P
شناسه ماشین مورد استفاده در system.devices یا مقدار DMI product_uuid از مسیر
.IR /sys/devices/virtual/dmi/id/product_uuid
خواهد بود، یا نام میزبان برگرفته از
.BR uname (2).
برای پیکربندی این مورد به
.BR lvm.conf (5)
بخش
.B device_ids_refresh_checks
مراجعه کنید.
.P
.SS "فایل‌های سفارشی دستگاه‌ها (custom devices files)"
می‌توان چندین فایل دستگاه را در مسیر /etc/lvm/devices نگهداری کرد، که به lvm امکان می‌دهد با مجموعه‌های متفاوتی از دستگاه‌ها استفاده شود. برای نمونه، ممکن است یک برنامه کاربردی مشخص نیازی به دسترسی به دستگاه‌های سیستم نداشته باشد و سیستم نیز نیازی به دسترسی به دستگاه‌های برنامه کاربردی نداشته باشد. در این حالت، system.devices می‌تواند فقط دستگاه‌های سیستم را فهرست کند و فایل <application>.devices می‌تواند تنها دستگاه‌های آن برنامه کاربردی را فهرست نماید. گزینه
.B \-\-devicesfile <filename>
برای انتخاب فایل دستگاه‌های مورد استفاده در دستور به کار می‌رود. بدون تنظیم این گزینه، فایل پیش‌فرض system.devices استفاده می‌شود.
.P
چنانچه فایل دستگاه‌های ویژه
.I /etc/lvm/devices/dmeventd.devices
وجود داشته باشد، در این صورت dmeventd به جای system.devices از dmeventd.devices استفاده می‌کند. استفاده از dmeventd.devices در صورتی ضروری است که VGهای برگرفته از فایل‌های دستگاه‌های مجزا به خدمات dmeventd نیاز داشته باشند. در این صورت، dmeventd.devices باید دستگاه‌های تمام VGهایی که نیازمند dmeventd هستند را فهرست کند.
.P
.SS "غیرفعال‌سازی و بازنویسی (disabling and overriding)"
روش‌های متعددی برای غیرفعال‌سازی یا بازنویسی ویژگی فایل دستگاه‌ها وجود دارد:
.P
.IP \[bu] 2
عدم وجود system.devices
.br
چنانچه فایل system.devices وجود نداشته باشد، ویژگی فایل دستگاه‌ها غیرفعال است.
.IP \[bu] 2
.B use_devicesfile=0
.br
چنانچه در lvm.conf مقدار use_devicesfile برابر با 0 تنظیم شده باشد، ویژگی فایل دستگاه‌ها غیرفعال است، حتی اگر فایل system.devices وجود داشته باشد.
.br
.IP \[bu] 2
.B \-\-devicesfile\ ""
.br
اگر یک نام خالی برای فایل دستگاه‌ها در خط فرمان مشخص شود، آن دستور از فایل دستگاه‌ها استفاده نخواهد کرد.
.br
.IP \[bu] 2
.B \-\-devices
.I device
.br
چنانچه دستگاه‌های مشخصی در خط فرمان با
.B \-\-devices
نام برده شوند، دستور از فایل دستگاه‌ها استفاده نخواهد کرد و تنها به دستگاه‌های نام‌برده دسترسی خواهد داشت.
.IP \[bu] 2
.B pvs \-A
.br
در صورت ارائه گزینه
.B \-A
یا
.BR \-\-allpvs ،
دستور
.BR pvs (8)
از فایل دستگاه‌ها استفاده نخواهد کرد.
.P
هنگامی که فایل دستگاه‌ها غیرفعال باشد، دستورات lvm به استفاده از فیلتر lvm.conf بازمی‌گردند.
هنگامی که فایل دستگاه‌ها استفاده شود، دستورات lvm تنظیمات فیلتر lvm.conf را نادیده می‌گیرند، به جز vgimportdevices که فیلتر regex را هنگام جستجوی VGها برای وارد کردن به فایل دستگاه‌ها بر روی مجموعه دستگاه‌های سیستم اعمال می‌کند.
.P
.SS "متادیتای گروه حجم (VG metadata)"
دستورات LVM که متادیتای VG را می‌نویسند، شناسه دستگاه هر PV را در متادیتای VG لحاظ خواهند کرد. شناسه دستگاه می‌تواند با گزینه‌های زیر نمایش داده شود:
.P
.B pvs \-o deviceidtype,deviceid
.P
(توجه داشته باشید که دستور lvmdevices متادیتای VG را به‌روزرسانی نمی‌کند، اما دستورات بعدی lvm که متادیتا را تغییر می‌دهند، شناسه دستگاه را لحاظ خواهند کرد.)
.P
.SS "ایجاد فایل دستگاه‌ها (creating the devices file)"
.P
چنانچه فایل system.devices هنوز وجود نداشته باشد، دستورهای pvcreate یا vgcreate تنها در صورتی آن را ایجاد می‌کنند که هیچ VG موجودی را در سیستم مشاهده نکنند. دستورهای
.B lvmdevices \-\-adddev
و
.B vgimportdevices
در صورتی که فایل دستگاه‌ها هنوز وجود نداشته باشد همیشه یک فایل دستگاه‌های جدید ایجاد خواهند کرد.
.
.SH "نحوه استفاده (USAGE)"
.
.nh
.na
چاپ دستگاه‌های موجود در فایل دستگاه‌ها.
.P
.B lvmdevices
.RS
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
بررسی فایل دستگاه‌ها و گزارش مقادیر نادرست.
.P
.B lvmdevices
.O_check
.RS
[
.O_refresh
]
.br
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
به‌روزرسانی فایل دستگاه‌ها برای اصلاح مقادیر نادرست.
.P
.B lvmdevices
.O_update
.RS
[
.O_force
]
.br
[
.O_delnotfound
]
.br
[
.O_refresh
]
.br
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
افزودن یک دستگاه به فایل دستگاه‌ها.
.P
.B lvmdevices
.O_adddev
.RS
[
.O_deviceidtype
]
.br
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
حذف یک دستگاه از فایل دستگاه‌ها.
.P
.B lvmdevices
.O_deldev
.RS
[
.O_deviceidtype
]
.br
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
یافتن دستگاه با PVID مشخص‌شده و افزودن آن به فایل دستگاه‌ها.
.P
.B lvmdevices
.O_addpvid
.RS
[
.O_deviceidtype
]
.br
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
حذف مدخل فایل دستگاه‌ها برای PVID مشخص‌شده.
.P
.B lvmdevices
.O_delpvid
.RS
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
یافتن دستگاه با device_id مشخص‌شده و افزودن آن به فایل دستگاه‌ها.
.P
.B lvmdevices
.O_addid
.O_deviceidtype
.RS
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
حذف مدخل فایل دستگاه‌ها با device_id مشخص‌شده.
.P
.B lvmdevices
.O_delid
.O_deviceidtype
.RS
[ COMMON_OPTIONS ]
.RE
.
.P
\(em
.P
.
چاپ انواع و مقادیر device_id موجود برای دستگاه.
.P
.B lvmdevices
.O_listids
.RS
[
.O_deviceidtype
]
.br
[ COMMON_OPTIONS ]
.RE
.P
\(em
.P
گزینه‌های عمومی برای lvm:
.RS
[
.O_debug
]
.br
[
.O_help
]
.br
[
.O_quiet
]
.br
[
.O_test
]
.br
[
.O_verbose
]
.br
[
.O_yes
]
.br
[
.O_commandprofile
]
.br
[
.O_config
]
.br
[
.O_devices
]
.br
[
.O_devicesfile
]
.br
[
.O_driverloaded
]
.br
[
.O_journal
]
.br
[
.O_lockopt
]
.br
[
.O_longhelp
]
.br
[
.O_nohints
]
.br
[
.O_nolocking
]
.br
[
.O_profile
]
.br
[
.O_version
]
.RE
.hy
.ad
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
.O_adddev
افزودن یک دستگاه به فایل دستگاه‌ها.
.
.TP
.O_addid
یافتن دستگاه با شناسه دستگاه (device_id) داده‌شده و افزودن آن به فایل دستگاه‌ها.
.
.TP
.O_addpvid
یافتن یک دستگاه با PVID مشخص‌شده و افزودن دستگاه به فایل دستگاه‌ها.
.
.TP
.O_check
محتوای فایل دستگاه‌ها را بررسی می‌کند.
نام‌های نادرست دستگاه یا PVIDهای ناصحیح را برای مدخل‌ها گزارش می‌دهد.
.
.TP
.O_commandprofile
پروفایل دستور مورد استفاده برای پیکربندی دستور.
برای اطلاعات بیشتر درباره پروفایل‌ها به
.BR lvm.conf (5)
مراجعه کنید.
.
.TP
.O_config
تنظیمات پیکربندی برای دستور. این مقادیر تنظیمات
.BR lvm.conf (5)
را بازنویسی می‌کنند.
آرگومان رشته‌ای (String) از همان قالب
.BR lvm.conf (5)
استفاده می‌کند یا می‌تواند از ساختار بخش/فیلد بهره گیرد.
برای اطلاعات بیشتر درباره پیکربندی به
.BR lvm.conf (5)
مراجعه کنید.
.
.TP
.O_debug
تنظیم سطح اشکال‌زدایی (دیباگ). برای افزایش جزئیات پیام‌های ارسالی به فایل ثبت وقایع (لاگ) و/یا syslog (در صورت پیکربندی)، از ۱ تا ۶ بار تکرار کنید.
.
.TP
.O_deldev
حذف یک دستگاه از فایل دستگاه‌ها.
هنگامی که به تنهایی استفاده شود،
.B \-\-deldev
یک نام دستگاه را مشخص می‌کند.
هنگامی که به همراه
.B \-\-deviceidtype
استفاده شود،
.B \-\-deldev
یک شناسه دستگاه را مشخص می‌کند.
.
.TP
.O_delid
دستگاه با شناسه دستگاه (device ID) مشخص‌شده را از فایل دستگاه‌ها حذف می‌کند.
.
.TP
.O_delnotfound
مدخل‌های فایل دستگاه‌ها را که هیچ دستگاه منطبقی برای آن‌ها وجود ندارد حذف می‌کند.
.
.TP
.O_delpvid
دستگاهی با PVID مشخص‌شده را از فایل دستگاه‌ها حذف می‌کند.
.
.TP
.O_deviceidtype
نوع شناسه دستگاه (device ID) برای استفاده در دستگاه.
چنانچه نوع مشخص‌شده برای دستگاه موجود باشد، نوع پیش‌فرضی را که lvm استفاده می‌کرد بازنویسی می‌کند.
.
.TP
.O_devices
دستگاه‌های قابل مشاهده و در دسترس برای دستور را محدود می‌کند.
دستگاه‌هایی که فهرست نشده‌اند مفقود به نظر خواهند رسید. این گزینه می‌تواند تکرار شود، یا فهرستی از دستگاه‌ها را که با کاما جدا شده‌اند می‌پذیرد. این گزینه فایل دستگاه‌ها را نادیده گرفته و بازنویسی می‌کند.
.
.TP
.O_devicesfile
فایلی شامل فهرست دستگاه‌هایی که LVM باید استفاده کند.
این فایل باید در مسیر
.I /etc/lvm/devices/
موجود باشد و با دستور
.BR lvmdevices (8)
مدیریت می‌شود.
این گزینه تنظیمات
.B devices/devicesfile
و
.B devices/use_devicesfile
در
.BR lvm.conf (5)
را بازنویسی می‌کند.
.
.TP
.O_driverloaded
اگر برابر با no تنظیم شود، دستور تلاشی برای استفاده از device-mapper نخواهد کرد.
برای مقاصد آزمایش و اشکال‌زدایی.
.
.TP
.O_force
بررسی‌های گوناگون، تاییدها و حفاظت‌ها را نادیده می‌گیرد.
با احتیاط فراوان استفاده شود.
.
.TP
.O_help
نمایش متن راهنما.
.
.TP
.O_journal
ثبت اطلاعات در ژورنال systemd.
این اطلاعات علاوه بر اطلاعاتی است که توسط تنظیم log/journal در lvm.conf فعال شده است.
command: ثبت اطلاعات درباره دستور.
output: ثبت خروجی پیش‌فرض دستور.
debug: ثبت کامل اشکال‌زدایی دستور.
.
.TP
.O_listids
چاپ فهرستی از شناسه‌های دستگاه (device IDs) موجود برای دستگاه.
.
.TP
.O_lockopt
برای ارسال گزینه‌ها در موارد خاص به lvmlockd استفاده می‌شود.
برای اطلاعات بیشتر به
.BR lvmlockd (8)
مراجعه کنید.
.
.TP
.O_longhelp
نمایش متن راهنمای طولانی.
.
.TP
.O_nohints
عدم استفاده از فایل سرنخ‌ها (hints file) برای مکان‌یابی دستگاه‌ها برای PVها. در صورت عدم استفاده از سرنخ‌ها، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها بخواند. دستور همچنان باطل‌سازی استاندارد فایل سرنخ را در موارد مقتضی انجام خواهد داد.
.
.TP
.O_nolocking
غیرفعال‌سازی قفل‌گذاری. با احتیاط استفاده شود؛ دستورات هم‌روند ممکن است نتایج نادرستی ایجاد کنند.
.
.TP
.O_profile
نام مستعار برای
.B \-\-commandprofile
یا
.B \-\-metadataprofile
بسته به دستور مورد نظر.
.
.TP
.O_quiet
قطع خروجی‌ها و پیام‌های ثبت وقایع. بر
.B \-\-debug
و
.B \-\-verbose
ارجحیت دارد.
با یک بار تکرار بیشتر، همچنین هرگونه اعلان تایید با پاسخ پیش‌فرض 'no' را بی‌صدا می‌کند.
.
.TP
.O_refresh
جستجوی PVهای مفقود روی دستگاه‌های جدید، و به‌روزرسانی فایل دستگاه‌ها با شناسه‌های دستگاه جدید برای PVها در صورتی که روی دستگاه‌های جدید پیدا شوند.
این قابلیت برای نمونه زمانی مفید است که PVها به دستگاه‌های جدیدی با WWIDهای جدید منتقل شده باشند. نوع شناسه دستگاه و نام آن ممکن است هر دو برای یک PV تغییر کنند.
هشدار: اگر یک PV از سیستم جدا شود، اما دستگاهی حاوی کلون یا اسنپ‌شات از آن PV در سیستم موجود باشد، عمل تازه‌سازی شناسه صحیح دستگاه را با شناسه دستگاه کلون/اسنپ‌شات جایگزین می‌کند و lvm شروع به استفاده از دستگاه نادرست برای PV خواهد کرد. در این سناریو برای تغییر ایمن شناسه دستگاه PV از deldev/adddev استفاده کنید.
.
.TP
.O_test
اجرا در حالت آزمایشی. دستورها متادیتا را به‌روزرسانی نخواهند کرد.
این کار با غیرفعال کردن تمامی عملیات نوشتن متادیتا اما بازگرداندن وضعیت موفقیت‌آمیز به تابع فراخواننده پیاده‌سازی شده است. این امر ممکن است در عملیات چندمرحله‌ای در صورتی که ابزار بر خواندن مجدد متادیتایی تکیه کند که فرض می‌کند تغییر کرده در حالی که تغییر نکرده است، منجر به پیام‌های خطای نامعمول شود.
.
.TP
.O_update
به‌روزرسانی محتوای فایل دستگاه‌ها.
.
.TP
.O_verbose
تنظیم سطح پرگویی (verbose). برای افزایش جزئیات پیام‌های ارسالی به stdout و stderr از ۱ تا ۴ بار تکرار کنید.
.
.TP
.O_version
نمایش اطلاعات نسخه.
.
.TP
.O_yes
عدم درخواست تایید به صورت تعاملی و در نظر گرفتن همیشگی پاسخ بله (yes). با احتیاط فراوان استفاده شود.
(برای پاسخ خودکار خیر،
.B \-qq
را ببینید.)
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I String
برای کسب اطلاعات درباره محتوای رشته، توضیحات مربوط به گزینه را ببینید.
.
.TP
.IR Size [UNIT]
مقدار Size یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد.
واحدهای ورودی همواره به صورت مبنای ۲ در نظر گرفته می‌شوند، صرف‌نظر از کوچک یا بزرگ بودن حروف؛ برای نمونه 'k' و 'K' هر دو به ۱۰۲۴ اشاره دارند.
واحد ورودی پیش‌فرض با حرف و به دنبال آن |UNIT مشخص می‌شود.
UNIT نشان‌دهنده سایر واحدهای ورودی ممکن است:
.BR b | B
بایت،
.BR s | S
بخش‌های (سکتورهای) ۵۱۲ بایتی،
.BR k | K
کیبی‌بایت (KiB)،
.BR m | M
مبی‌بایت (MiB)،
.BR g | G
گیبی‌بایت (GiB)،
.BR t | T
تبی‌بایت (TiB)،
.BR p | P
پبی‌بایت (PiB)،
.BR e | E
اکسبی‌بایت (EiB).
(این مورد نباید با گزینه کنترلی خروجی
.B \-\-units
اشتباه گرفته شود که در آن حروف بزرگ به مضارب ۱۰۰۰ اشاره دارند.)
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
برای اطلاعات درباره متغیرهای محیطی استفاده‌شده توسط lvm به
.BR lvm (8)
مراجعه کنید.
برای نمونه، معمولاً
.B LVM_VG_NAME
می‌تواند جایگزین یک پارامتر الزامی VG شود.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.nh
.na
.BR lvm (8),
.BR lvm.conf (5),
.BR lvmconfig (8),
.BR lvmdevices (8),
.P
.BR pvchange (8),
.BR pvck (8),
.BR pvcreate (8),
.BR pvdisplay (8),
.BR pvmove (8),
.BR pvremove (8),
.BR pvresize (8),
.BR pvs (8),
.BR pvscan (8),
.P
.BR vgcfgbackup (8),
.BR vgcfgrestore (8),
.BR vgchange (8),
.BR vgck (8),
.BR vgcreate (8),
.BR vgconvert (8),
.BR vgdisplay (8),
.BR vgexport (8),
.BR vgextend (8),
.BR vgimport (8),
.BR vgimportclone (8),
.BR vgimportdevices (8),
.BR vgmerge (8),
.BR vgmknodes (8),
.BR vgreduce (8),
.BR vgremove (8),
.BR vgrename (8),
.BR vgs (8),
.BR vgscan (8),
.BR vgsplit (8),
.P
.BR lvcreate (8),
.BR lvchange (8),
.BR lvconvert (8),
.BR lvdisplay (8),
.BR lvextend (8),
.BR lvreduce (8),
.BR lvremove (8),
.BR lvrename (8),
.BR lvresize (8),
.BR lvs (8),
.BR lvscan (8),
.P
.BR lvm\-fullreport (8),
.BR lvm\-lvpoll (8),
.BR blkdeactivate (8),
.BR lvmdump (8),
.P
.BR dmeventd (8),
.BR lvmpolld (8),
.BR lvmlockd (8),
.BR lvmlockctl (8),
.BR cmirrord (8),
.BR lvmdbusd (8),
.BR fsadm (8),
.P
.BR lvmsystemid (7),
.BR lvmreport (7),
.BR lvmcache (7),
.BR lvmraid (7),
.BR lvmthin (7),
.BR lvmvdo (7),
.BR lvmautoactivation (7)