.TH "VGCHANGE" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgchange \- تغییر ویژگیها و وضعیت گروههای حجم در LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgchange\fP [\fIگزینهها\fR] [\fIگروه_حجم\fR...]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgchange\fR ویژگیهای یک یا چند گروه حجم (Volume Group) را تغییر میدهد؛ از جمله فعال یا غیرفعال کردن حجمهای منطقی (-a)، تنظیم حداکثر تعداد حجمها و کنترل قفلها.
.P
دستور \fBvgchange\fR ویژگی‌های گروه حجم (VG) را تغییر می‌دهد، وضعیت فعال‌سازی حجم منطقی (LV) را در هسته دگرگون می‌سازد و ابزارهای کمکی دیگری را برای نگهداری و مدیریت گروه حجم فراهم می‌آورد.
.
.SH "کاربرد (USAGE)"
.
تغییر یکی از ویژگی‌های عمومی VG.
.br
برای گزینه‌های فهرست‌شده درون پرانتز، انتخاب حداقل یکی الزامی است و پس از آن، گزینه‌های دیگر اختیاری خواهند بود.
.br
.P
\fBvgchange\fP
.RS 4
( \fB\-l\fP|\fB\-\-logicalvolume\fP \fINumber\fP
.br
  \fB\-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP
.br
  \fB\-u\fP|\fB\-\-uuid\fP
.br
  \fB\-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT]
.br
  \fB\-x\fP|\fB\-\-resizeable\fP \fBy\fP|\fBn\fP
.br
     \fB\-\-addtag\fP \fITag\fP
.br
     \fB\-\-deltag\fP \fITag\fP
.br
     \fB\-\-alloc\fP \c
.nh
\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
.hy
.br
     \fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.br
     \fB\-\-\fP[\fBvg\fP]\fBmetadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP
.br
     \fB\-\-profile\fP \fIString\fP
.br
     \fB\-\-detachprofile\fP
.br
     \fB\-\-metadataprofile\fP \fIString\fP
.br
     \fB\-\-setautoactivation\fP \fBy\fP|\fBn\fP )
.RE
.br
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[    \fB\-\-poll\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-ignoremonitoring\fP ]
.br
[    \fB\-\-noudevsync\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP|\fISelect\fP ... ]
.RE
.P
\(em
.P
آغاز یا توقف نظارت بر LVها از سوی dmeventd.
.br
.P
\fBvgchange\fP \fB\-\-monitor\fP \fBy\fP|\fBn\fP
.br
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[    \fB\-\-sysinit\fP ]
.br
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-poll\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-ignoremonitoring\fP ]
.br
[    \fB\-\-noudevsync\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP|\fISelect\fP ... ]
.RE
.P
\(em
.P
آغاز یا توقف پردازش تبدیل‌های LV.
.br
.P
\fBvgchange\fP \fB\-\-poll\fP \fBy\fP|\fBn\fP
.br
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-ignoremonitoring\fP ]
.br
[    \fB\-\-noudevsync\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP|\fISelect\fP ... ]
.RE
.P
\(em
.P
فعال‌سازی یا غیرفعال‌سازی LVها.
.br
.P
\fBvgchange\fP \fB\-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP
.br
.RS 4
.na
[ \fB\-K\fP|\fB\-\-ignoreactivationskip\fP ]
.br
[ \fB\-P\fP|\fB\-\-partial\fP ]
.br
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[    \fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ]
.br
[    \fB\-\-sysinit\fP ]
.br
[    \fB\-\-readonly\fP ]
.br
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-monitor\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-poll\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-autoactivation\fP \fIString\fP ]
.br
[    \fB\-\-ignoremonitoring\fP ]
.br
[    \fB\-\-noudevsync\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP|\fISelect\fP ... ]
.RE
.P
\(em
.P
فعال‌سازی مجدد LVها با استفاده از تازه‌ترین متادیتا.
.br
.P
\fBvgchange\fP \fB\-\-refresh\fP
.br
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[    \fB\-\-sysinit\fP ]
.br
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-poll\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-ignoremonitoring\fP ]
.br
[    \fB\-\-noudevsync\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP|\fISelect\fP ... ]
.RE
.P
\(em
.P
تغییر شناسه سیستم (system ID) یک VG.
.br
.P
\fBvgchange\fP \fB\-\-systemid\fP \fIString\fP \fIVG\fP|\fITag\fP|\fISelect\fP
.br
.RS 4
.na
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[    \fB\-\-majoritypvs\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.P
\(em
.P
راه‌اندازی فضای قفل (lockspace) یک VG اشتراکی در lvmlockd.
.br
.P
\fBvgchange\fP \fB\-\-lockstart\fP
.br
.RS 4
.na
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP|\fISelect\fP ... ]
.RE
.P
\(em
.P
متوقف ساختن فضای قفل (lockspace) یک VG اشتراکی در lvmlockd.
.br
.P
\fBvgchange\fP \fB\-\-lockstop\fP
.br
.RS 4
.na
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP|\fISelect\fP ... ]
.RE
.P
\(em
.P
تغییر نوع قفل برای یک VG اشتراکی.
.br
.P
\fBvgchange\fP \fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP \fIVG\fP
.br
.RS 4
.na
[ \fIگزینه‌های_عمومی\fP ]
.ad
.RE
.P
\(em
.P
گزینه‌های عمومی برای lvm:
.
.RS 4
.na
[ \fB\-d\fP|\fB\-\-debug\fP ]
.br
[ \fB\-h\fP|\fB\-\-help\fP ]
.br
[ \fB\-q\fP|\fB\-\-quiet\fP ]
.br
[ \fB\-t\fP|\fB\-\-test\fP ]
.br
[ \fB\-v\fP|\fB\-\-verbose\fP ]
.br
[ \fB\-y\fP|\fB\-\-yes\fP ]
.br
[    \fB\-\-commandprofile\fP \fIString\fP ]
.br
[    \fB\-\-config\fP \fIString\fP ]
.br
[    \fB\-\-devices\fP \fIPV\fP ]
.br
[    \fB\-\-devicesfile\fP \fIString\fP ]
.br
[    \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-journal\fP \fIString\fP ]
.br
[    \fB\-\-lockopt\fP \fIString\fP ]
.br
[    \fB\-\-longhelp\fP ]
.br
[    \fB\-\-nohints\fP ]
.br
[    \fB\-\-nolocking\fP ]
.br
[    \fB\-\-profile\fP \fIString\fP ]
.br
[    \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.HP
\fB\-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP
.br
تغییر وضعیت فعال بودن حجم‌های منطقی (LVs).
یک LV فعال از طریق یک دستگاه بلوکی (block device) قابل استفاده است و امکان دسترسی به داده‌های روی LV را فراهم می‌سازد.
مقدار \fBy\fP حجم‌های منطقی را فعال یا در دسترس می‌کند.
مقدار \fBn\fP حجم‌های منطقی را غیرفعال یا از دسترس خارج می‌کند.
دستگاه بلوکی مربوط به LV با استفاده از device-mapper در هسته به سیستم اضافه یا از آن حذف می‌شود.
یک پیوند نمادین (symbolic link) به صورت /dev/VGName/LVName که به گره دستگاه اشاره دارد نیز اضافه یا حذف می‌شود.
تمام نرم‌افزارها و اسکریپت‌ها باید از طریق این پیوند نمادین به دستگاه دسترسی داشته باشند و آن را به عنوان نام دستگاه ارائه دهند.
مکان و نام گره دستگاه زیربنایی ممکن است به توزیع، پیکربندی (مانند udev) یا نسخه انتشار سیستم بستگی داشته باشد.
مقدار \fBay\fP فعال‌سازی خودکار (autoactivation) را مشخص می‌کند که توسط دستورات فعال‌سازی سیستمی استفاده می‌شود. به طور پیش‌فرض، LVها به صورت خودکار فعال می‌شوند.
ویژگی خودفعال‌سازی را می‌توان روی یک VG یا LV تنظیم کرد تا فعال‌سازی خودکار غیرفعال شود؛ به \fB\-\-setautoactivation y\fP|\fBn\fP در vgchange، lvchange، vgcreate و lvcreate مراجعه کنید.
این ویژگی را با دستور vgs یا lvs همراه با "\-o autoactivation" نمایش دهید.
گزینه auto_activation_volume_list در \fBlvm.conf\fP(5) شامل نام‌های VGها یا LVهایی است که باید به طور خودکار فعال شوند و هر موردی که در این لیست نباشد به طور خودکار فعال نمی‌شود.
هنگامی که auto_activation_volume_list تعریف نشده باشد (حالت پیش‌فرض)، هیچ تاثیری ندارد.
اگر auto_activation_volume_list تعریف شده و خالی باشد، هیچ LVای به طور خودکار فعال نخواهد شد.
مواردی که در auto_activation_volume_list گنجانده شده‌اند، در صورتی که ویژگی خودفعال‌سازی آن‌ها غیرفعال شده باشد، به طور خودکار فعال نخواهند شد.
برای اطلاعات بیشتر درباره گزینه‌های فعال‌سازی \fBey\fP و \fBsy\fP برای VGهای اشتراکی، به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP
.br
تعیین می‌کند که آیا فعال‌سازی LV در هنگام مفقود شدن PVها (مثلاً به دلیل نقص دستگاه ذخیره‌سازی) مجاز است یا خیر.
حالت \fBcomplete\fP تنها به LVهایی که هیچ PV مفقودی ندارند اجازه فعال شدن می‌دهد و محدودکننده‌ترین حالت است.
حالت \fBdegraded\fP به LVهای RAID با PVهای مفقود اجازه فعال شدن می‌دهد. (این شامل نوع "mirror" نمی‌شود؛ به جای آن "raid1" را ببینید).
حالت \fBpartial\fP به هر LV با PVهای مفقود اجازه فعال شدن می‌دهد و باید فقط برای بازیابی یا تعمیر استفاده شود.
برای مقدار پیش‌فرض، به activation_mode در \fBlvm.conf\fP(5) مراجعه کنید.
برای اطلاعات بیشتر به \fBlvmraid\fP(7) مراجعه نمایید.
.
.HP
\fB\-\-addtag\fP \fITag\fP
.br
افزودن یک برچسب (تگ) به یک PV، VG یا LV. این گزینه را می‌توان برای افزودن چندین برچسب به طور همزمان تکرار کرد. برای اطلاعات بیشتر درباره برچسب‌ها به \fBlvm\fP(8) مراجعه فرمایید.
.
.HP
.ad
\fB\-\-alloc\fP \c
.nh
\%\fBcontiguous\fP|\:\fBcling\fP|\:\fBcling_by_tags\fP|\:\fBnormal\fP|\:\fBanywhere\fP|\:\fBinherit\fP
.hy
.ad
.br
تعیین سیاست تخصیص زمانی که دستور نیاز به تخصیص اکستنت‌های فیزیکی (PEs) از VG دارد. هر VG و LV دارای یک سیاست تخصیص است که می‌توان آن را با vgchange/lvchange تغییر داد یا در خط فرمان بازنویسی کرد.
سیاست \fBnormal\fP قوانین متداول منطقی را اعمال می‌کند، مانند قرار ندادن خطوط نواری موازی روی یک PV یکسان.
سیاست \fBinherit\fP سیاست VG را بر روی LV اعمال می‌کند.
سیاست \fBcontiguous\fP مستلزم آن است که PEهای جدید در مجاورت PEهای موجود قرار گیرند.
سیاست \fBcling\fP، اکستنت‌های جدید را روی همان PVای قرار می‌دهد که PEهای موجود در همان نوار LV قرار دارند.
اگر PEهای کافی برای یک تخصیص وجود داشته باشد اما حالت normal از آن‌ها استفاده نکند، سیاست \fBanywhere\fP از آن‌ها استفاده خواهد کرد حتی اگر عملکرد را کاهش دهد، برای مثال با قرار دادن دو نوار روی یک PV یکسان.
آرگومان‌های مکانی اختیاری PV در خط فرمان نیز می‌توانند برای محدود کردن اینکه دستور از کدام PVها برای تخصیص استفاده کند، به کار روند.
برای اطلاعات بیشتر درباره تخصیص به \fBlvm\fP(8) مراجعه نمایید.
.
.HP
\fB\-\-autoactivation\fP \fIString\fP
.br
مشخص می‌کند که آیا خودفعال‌سازی از طریق یک رویداد (event) استفاده می‌شود یا خیر.
این گزینه به دستور اجازه می‌دهد تا تنظیمات ویژه فعال‌سازی رویدادمحور را اعمال کند، مانند بهینه‌سازی‌های اسکن دستگاه با استفاده از فایل‌های pvs_online ایجاد شده توسط pvscanهای مبتنی بر رویداد.
.
.HP
\fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP
.br
مشخص می‌کند که آیا پس از اعمال تغییرات، باید به طور خودکار از متادیتا پشتیبان‌گیری شود یا خیر.
فعال بودن این گزینه اکیداً توصیه می‌شود!
برای اطلاعات بیشتر به \fBvgcfgbackup\fP(8) مراجعه کنید.
.
.HP
\fB\-c\fP|\fB\-\-clustered\fP \fBy\fP|\fBn\fP
.br
تغییر وضعیت کلاستر بودن گروه حجم (در نسخه‌های جدیدتر LVM با گزینه \fB\-\-locktype\fP جایگزین شده است).
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
نمایه دستوری مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره نمایه‌ها به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور. این تنظیمات بر مقادیر پیکربندی در \fBlvm.conf\fP(5) تقدم دارند. آرگومان رشته از همان قالب \fBlvm.conf\fP(5) بهره می‌برد یا می‌تواند از نحو بخش/فیلد استفاده کند. برای اطلاعات بیشتر درباره پیکربندی به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی (دیباگ). این گزینه را از ۱ تا ۶ بار تکرار کنید تا جزئیات پیام‌های ارسالی به فایل لاگ و/یا syslog (در صورت فعال بودن) افزایش یابد.
.
.HP
\fB\-\-deltag\fP \fITag\fP
.br
حذف یک برچسب (تگ) از یک PV، VG یا LV. این گزینه را می‌توان برای حذف چندین برچسب به طور همزمان تکرار کرد. برای اطلاعات بیشتر درباره برچسب‌ها به \fBlvm\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-detachprofile\fP
.br
جدا کردن نمایه متادیتا از یک VG یا LV.
برای اطلاعات بیشتر درباره نمایه‌ها به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
محدود کردن دستگاه‌هایی که برای دستور قابل مشاهده و دسترسی هستند. دستگاه‌هایی که در این لیست نباشند مفقود به نظر خواهند رسید. این گزینه می‌تواند تکرار شود، یا فهرستی جدا شده با ویرگول از دستگاه‌ها را بپذیرد. این گزینه بر فایل دستگاه‌ها اولویت دارد.
.
.HP
\fB\-\-devicesfile\fP \fIString\fP
.br
فایلی شامل فهرست دستگاه‌هایی که LVM باید استفاده کند. این فایل باید در مسیر \fI/etc/lvm/devices/\fP وجود داشته باشد و با دستور \fBlvmdevices\fP(8) مدیریت می‌شود. این گزینه تنظیمات \fBdevices/devicesfile\fP و \fBdevices/use_devicesfile\fP در \fBlvm.conf\fP(5) را بازنویسی می‌کند.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم بر روی no، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. این گزینه برای مقاصد آزمایش و اشکال‌زدایی کاربرد دارد.
.
.HP
\fB\-f\fP|\fB\-\-force\fP ...
.br
نادیده گرفتن بررسی‌های گوناگون، تاییدیه‌ها و محافظت‌ها. با نهایت احتیاط استفاده شود.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-K\fP|\fB\-\-ignoreactivationskip\fP
.br
نادیده گرفتن فلگ "activation skip" (رد کردن فعال‌سازی) یک LV در طول فرآیند فعال‌سازی، تا به LVهایی که این فلگ برایشان تنظیم شده اجازه فعال شدن داده شود.
.
.HP
\fB\-\-ignorelockingfailure\fP
.br
به دستور اجازه می‌دهد تا پس از شکست در قفل‌گذاری، با عملیات‌های فقط‌خواندنی متادیتا به کار خود ادامه دهد.
.
.HP
\fB\-\-ignoremonitoring\fP
.br
عدم تعامل با dmeventd مگر اینکه گزینه \fB\-\-monitor\fP مشخص شده باشد. اگر dmeventd در حال حاضر بر دستگاه نظارت می‌کند، از این گزینه استفاده نکنید.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعاتی است که توسط تنظیم log/journal در lvm.conf فعال می‌شود. مقادیر مجاز:
\fBcommand\fP: ثبت اطلاعات درباره دستور؛
\fBoutput\fP: ثبت خروجی پیش‌فرض دستور؛
\fBdebug\fP: ثبت اطلاعات کامل اشکال‌زدایی دستور.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌ها در شرایط خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-lockstart\fP
.br
راه‌اندازی فضای قفل (lockspace) یک VG اشتراکی در lvmlockd. قفل‌های lvmlockd برای این VG در دسترس قرار می‌گیرند و به LVM امکان استفاده از VG را می‌دهند.
برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-lockstop\fP
.br
متوقف ساختن فضای قفل (lockspace) یک VG اشتراکی در lvmlockd. قفل‌های lvmlockd برای این VG از دسترس خارج شده و مانع استفاده LVM از VG می‌شوند.
برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-locktype\fP \fBsanlock\fP|\fBdlm\fP|\fBnone\fP
.br
تغییر نوع قفل VG به یا از یک نوع قفل اشتراکی مورد استفاده با lvmlockd.
برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-l\fP|\fB\-\-logicalvolume\fP \fINumber\fP
.br
تنظیم حداکثر تعداد حجم‌های منطقی (LVs) مجاز در یک گروه حجم (VG).
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای بلند و جامع.
.
.HP
\fB\-\-majoritypvs\fP
.br
تغییر شناسه سیستم (system ID) گروه حجم در صورتی که اکثریت PVهای موجود در VG حاضر باشند (یکی بیشتر از نصف).
.
.HP
\fB\-p\fP|\fB\-\-maxphysicalvolumes\fP \fINumber\fP
.br
تنظیم حداکثر تعداد حجم‌های فیزیکی (PVs) که می‌توانند متعلق به VG باشند. مقدار 0 هرگونه محدودیتی را حذف می‌کند.
برای تعداد بالای PVها، همچنین به گزینه‌های \fB\-\-pvmetadatacopies\fP و \fB\-\-vgmetadatacopies\fP برای بهبود کارایی و عملکرد مراجعه کنید.
.
.HP
\fB\-\-metadataprofile\fP \fIString\fP
.br
نمایه متادیتا مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره نمایه‌ها به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-\-monitor\fP \fBy\fP|\fBn\fP
.br
آغاز (yes) یا توقف (no) نظارت بر یک LV توسط dmeventd.
دیمن dmeventd رویدادهای هسته را برای یک LV پایش می‌کند و در پاسخ به رویدادهای خاص، عملیات نگهداری خودکار را برای LV انجام می‌دهد.
برای اطلاعات بیشتر به \fBdmeventd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنماها (hints) برای یافتن دستگاه‌ها به عنوان PV. هنگامی که از راهنماها استفاده نشود، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها اسکن کند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در زمان مقتضی انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی به همراه داشته باشند.
.
.HP
\fB\-\-noudevsync\fP
.br
غیرفعال کردن همگام‌سازی udev. فرآیند منتظر دریافت اعلان از udev نخواهد ماند و بدون توجه به هرگونه پردازش احتمالی udev در پس‌زمینه ادامه می‌یابد. فقط زمانی از این گزینه استفاده کنید که udev در حال اجرا نیست یا قوانینی دارد که دستگاه‌های ایجاد شده توسط LVM را نادیده می‌گیرند.
.
.HP
\fB\-P\fP|\fB\-\-partial\fP
.br
دستورات تمام تلاش خود را برای فعال کردن LVهایی با اکستنت‌های PV مفقود به کار خواهند بست.
اکستنت‌های مفقود ممکن است با قطعات خطا (error) یا صفر بر اساس تنظیم missing_stripe_filler جایگزین شوند.
با این گزینه نمی‌توان متادیتا را تغییر داد.
.
.HP
\fB\-s\fP|\fB\-\-physicalextentsize\fP \fISize\fP[m|UNIT]
.br
تنظیم اندازه اکستنت فیزیکی (PE) مربوط به PVها در این VG.
این مقدار باید توانی از ۲ و حداقل ۱ سکتور باشد (که در آن اندازه سکتور بزرگ‌ترین اندازه سکتور PVهای فعلی مورد استفاده در VG است)، یا حداقل ۱۲۸\ KiB باشد.
پس از تنظیم این مقدار، تغییر آن بدون ایجاد مجدد VG دشوار خواهد بود، مگر اینکه نیازی به جابجایی هیچ اکستنتی نباشد.
پیش از افزایش اندازه اکستنت فیزیکی، ممکن است لازم باشد از lvresize، pvresize و/یا pvmove استفاده کنید تا همه چیز جا بگیرد. به عنوان مثال، هر محدوده پیوسته‌ای از اکستنت‌های مورد استفاده در یک LV باید در یک مرز اکستنت آغاز شود و پایان یابد.
.
.HP
\fB\-\-poll\fP \fBy\fP|\fBn\fP
.br
هنگام تنظیم بر روی yes، فرآیند تبدیل پس‌زمینه یک LV آغاز می‌شود. یک تبدیل ناقص (برای نمونه pvmove یا lvconvert که به دلیل راه‌اندازی مجدد سیستم یا کرش متوقف شده است) را می‌توان از آخرین نقطه بازرسی (checkpoint) با \fB\-\-poll y\fP مجدداً آغاز کرد.
هنگام تنظیم بر روی no، تبدیل پس‌زمینه یک LV رخ نخواهد داد و تبدیل تکمیل نمی‌شود. ممکن است بلافاصله پس از فعال‌سازی، نظرسنجی و پیشبرد تبدیل یک LV مناسب نباشد؛ در چنین حالتی می‌توان از \fB\-\-poll n\fP برای به تعویق انداختن آن تا اجرای دستور بعدی با \fB\-\-poll y\fP استفاده کرد.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار برای \fB\-\-commandprofile\fP یا \fB\-\-metadataprofile\fP بسته به نوع دستور.
.
.HP
\fB\-\-pvmetadatacopies\fP \fB0\fP|\fB1\fP|\fB2\fP
.br
تعداد نواحی متادیتا که باید روی یک PV برای ذخیره متادیتای VG کنار گذاشته شود.
در حالت ۲، یک نسخه از متادیتای VG در ابتدای PV و نسخه دوم در انتهای آن ذخیره می‌شود.
در حالت ۱، یک نسخه از متادیتای VG در ابتدای PV ذخیره می‌شود.
در حالت ۰، هیچ نسخه‌ای از متادیتای VG بر روی PV مربوطه ذخیره نمی‌شود.
این ویژگی ممکن است در VGهایی که شامل تعداد زیادی PV هستند مفید باشد (این امر در آینده محدودیت‌هایی بر توانایی استفاده از vgsplit ایجاد می‌کند).
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی و پیام‌های لاگ. بر گزینه‌های \fB\-\-debug\fP و \fB\-\-verbose\fP اولویت دارد. با یک بار تکرار بیشتر، همچنین از تمامی اعلان‌ها با پاسخ پیش‌فرض 'no' رد می‌شود.
.
.HP
\fB\-\-readonly\fP
.br
جلوگیری از اعمال هرگونه تغییر توسط دستور، از جمله فعال‌سازی و به‌روزرسانی متادیتا. (برای LVهای فقط‌خواندنی به \fB\-\-permission r\fP مراجعه نمایید).
.
.HP
\fB\-\-refresh\fP
.br
اگر حجم منطقی (LV) فعال باشد، متادیتای آن را بازخوانی و بارگذاری مجدد می‌کند.
در محیطی که از udev برای مدیریت محتویات /dev استفاده می‌شود، استفاده از این گزینه اکیداً توصیه می‌شود. دلیل این امر آن است که گزینه refresh همچنین رویدادهای udev را برای یک LV بر اساس قوانین فعلی udev دوباره ایجاد می‌کند تا محتوا و دسترسی‌های /dev تنظیم شوند.
همچنین این عملیات زمانی که مشکلی رخ داده باشد، یا نوعی اشتراک‌گذاری دستی LV در حال استفاده باشد، می‌تواند بسیار سودمند واقع شود.
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
قالب خروجی فعلی گزارش‌ها را که به صورت سراسری با تنظیم report/output_format در \fBlvm.conf\fP(5) تعریف شده است، بازنویسی می‌کند. مقدار \fBbasic\fP همان قالب اصلی با ستون‌ها و ردیف‌ها است. اگر بیش از یک گزارش به ازای هر دستور وجود داشته باشد، هر گزارش با نام گزارش برای شناسایی پیشوند می‌گیرد. مقدار \fBjson\fP خروجی گزارش را در قالب JSON تولید می‌کند. مقدار \fBjson_std\fP خروجی گزارش را در قالبی از JSON سازگارتر با استانداردهای رسمی JSON ارائه می‌دهد. برای اطلاعات بیشتر به \fBlvmreport\fP(7) مراجعه فرمایید.
.
.HP
\fB\-x\fP|\fB\-\-resizeable\fP \fBy\fP|\fBn\fP
.br
امکان افزودن یا حذف PVها به/از یک VG (از طریق vgextend/vgreduce) را فعال یا غیرفعال می‌کند.
.
.HP
\fB\-S\fP|\fB\-\-select\fP \fIString\fP
.br
انتخاب اشیاء برای پردازش و گزارش‌گیری بر اساس معیارهای مشخص‌شده. نحو معیارها در \fB\-\-select help\fP و \fBlvmreport\fP(7) شرح داده شده است.
برای دستورات گزارش‌گیری، به ازای هر شیء منطبق با معیارها یک سطر نمایش داده می‌شود. برای فیلدهای شیء قابل انتخاب، \fB\-\-options help\fP را ببینید. سطرها را می‌توان با یک فیلد اضافی "selected" (\-o selected) نمایش داد که در صورت تطابق سطر با انتخاب عدد ۱ و در غیر این صورت ۰ را نشان می‌دهد.
برای دستورات غیرگزارش‌گیری که موجودیت‌های LVM را پردازش می‌کنند، از انتخاب برای گزینش موارد جهت پردازش استفاده می‌شود.
.
.HP
\fB\-\-setautoactivation\fP \fBy\fP|\fBn\fP
.br
تنظیم ویژگی فعال‌سازی خودکار (autoactivation) بر روی یک VG یا LV.
نمایش این ویژگی با دستور vgs یا lvs همراه با "\-o autoactivation" انجام می‌شود.
هنگامی که ویژگی autoactivation غیرفعال باشد، VG یا LV توسط دستوری که خودفعال‌سازی انجام می‌دهد (مانند vgchange، lvchange یا pvscan با استفاده از \-aay) فعال نخواهد شد.
اگر خودفعال‌سازی بر روی یک VG غیرفعال باشد، هیچ LVای در آن VG به صورت خودکار فعال نخواهد شد و ویژگی autoactivation حجم منطقی تاثیری نخواهد داشت.
اگر خودفعال‌سازی بر روی یک VG فعال باشد، می‌توان خودفعال‌سازی را برای LVهای تکی غیرفعال کرد.
.
.HP
\fB\-\-sysinit\fP
.br
نشان می‌دهد که vgchange/lvchange از اسکریپت‌های اولیه راه‌اندازی سیستم (مانند rc.sysinit یا یک initrd)، قبل از اینکه سیستم‌فایل‌های قابل نوشتن در دسترس باشند، فراخوانی شده است. از این رو، برخی از قابلیت‌ها باید غیرفعال شوند و این گزینه به عنوان یک میانبر عمل می‌کند که مجموعه‌ای مناسب از گزینه‌ها را برمی‌گزیند. در حال حاضر، این گزینه معادل استفاده از \fB\-\-ignorelockingfailure\fP، \fB\-\-ignoremonitoring\fP، \fB\-\-poll n\fP و تنظیم متغیر محیطی LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES است.
دستورات vgchange/lvchange از فعال‌سازی خودکار صرف‌نظر می‌کنند و آن را به فعال‌سازی خودکار pvscan واگذار می‌نمایند.
.
.HP
\fB\-\-systemid\fP \fIString\fP
.br
شناسه سیستم (system ID) گروه حجم را تغییر می‌دهد. استفاده از این گزینه نیازمند احتیاط است، زیرا ممکن است VG برای میزبانی که دستور را اجرا می‌کند بیگانه (foreign) شود و دسترسی میزبان به آن ناممکن گردد.
برای اطلاعات بیشتر به \fBlvmsystemid\fP(7) مراجعه نمایید.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایش. دستورات اقدام به به‌روزرسانی متادیتا نخواهند کرد. این قابلیت با غیرفعال کردن تمامی عملیات‌های نوشتن متادیتا و همزمان بازگرداندن وضعیت موفقیت‌آمیز به تابع فراخواننده پیاده‌سازی شده است. این امر ممکن است در عملیات‌های چندمرحله‌ای منجر به پیام‌های خطای نامتعارف شود، اگر ابزاری وابسته به بازخوانی مجدد متادیتایی باشد که می‌پندارد تغییر یافته است اما در واقع تغییر نیافته است.
.
.HP
\fB\-u\fP|\fB\-\-uuid\fP
.br
تولید یک شناسه یکتای تصادفی (UUID) جدید برای VGهای مشخص‌شده.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی خروجی. این گزینه را از ۱ تا ۴ بار تکرار کنید تا جزئیات پیام‌های ارسالی به stdout و stderr افزایش یابد.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه نرم‌افزار.
.
.HP
\fB\-\-\fP[\fBvg\fP]\fBmetadatacopies\fP \fBall\fP|\fBunmanaged\fP|\fINumber\fP
.br
تعداد نسخه‌هایی از متادیتای VG که نگهداری می‌شوند.
متادیتای VG در نواحی متادیتای VG روی PVهای درون VG ذخیره می‌شود؛ یعنی فضای رزرو شده در ابتدا و/یا انتهای PVها.
نگهداری یک نسخه از متادیتای VG بر روی هر PV می‌تواند کارایی را در VGهایی که شامل تعداد زیادی PV هستند کاهش دهد.
هنگامی که این عدد روی مقداری غیر از صفر تنظیم شود، LVM به طور خودکار PVهایی را برای ذخیره متادیتا با استفاده از فلگ‌های metadataignore روی PVها برمی‌گزیند تا به عدد تعیین‌شده برسد.
این عدد همچنین می‌تواند با مقادیر رشته‌ای ویژه جایگزین شود:
مقدار \fBunmanaged\fP باعث می‌شود LVM فلگ‌های metadataignore مربوط به PV را به طور خودکار مدیریت نکند.
مقدار \fBall\fP باعث می‌شود LVM ابتدا فلگ‌های metadataignore را روی تمام PVها پاک کند و سپس به حالت مدیریت‌نشده درآید.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم پرسش تعاملی برای دریافت تاییدیه و در نظر گرفتن همیشگی پاسخ مثبت (yes). با نهایت احتیاط استفاده شود. (برای پاسخ منفی خودکار، به \-qq مراجعه نمایید).
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I VG
نام گروه حجم (Volume Group). برای نام‌های معتبر به \fBlvm\fP(8) مراجعه فرمایید.
.TP
.I Tag
نام برچسب (تگ). برای اطلاعات درباره نام‌های برچسب و استفاده از برچسب‌ها به جای VG، LV یا PV به \fBlvm\fP(8) مراجعه کنید.
.TP
.I Select
شناسه Select نشان می‌دهد که در صورت استفاده از گزینه \fB\-\-select\fP، پارامتر مکانی الزامی می‌تواند حذف شود. هیچ آرگومانی در این موقعیت ظاهر نمی‌شود.
.TP
.I String
برای اطلاعات در مورد محتوای رشته، به توضیحات همان گزینه رجوع کنید.
.TP
.IR Size [UNIT]
اندازه یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد.
واحدهای ورودی همواره صرف‌نظر از بزرگی یا کوچکی حروف به عنوان مقادیر بر مبنای دو تفسیر می‌شوند؛ برای نمونه '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).
(این مورد نباید با کنترل خروجی \fB\-\-units\fP اشتباه گرفته شود که در آن حروف بزرگ به معنای مضاربی از ۱۰۰۰ هستند).
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
برای اطلاعات بیشتر درباره متغیرهای محیطی مورد استفاده در lvm به \fBlvm\fP(8) مراجعه فرمایید.
به عنوان نمونه، LVM_VG_NAME معمولاً می‌تواند به جای یک پارامتر الزامی VG جایگزین شود.
.
.SH "نکات (NOTES)"
.
اگر vgchange متوجه حجم‌های منطقی تصویر لحظه‌ای (COW snapshot LVs) شود که به دلیل اتمام فضا متوقف و رها شده‌اند، پیامی را نمایش می‌دهد که به مدیر سیستم اطلاع می‌دهد این اسنپ‌شات‌ها باید حذف شوند.
.
.SH "مثال‌ها (EXAMPLES)"
.
فعال‌سازی تمام LVها در تمام VGها بر روی تمامی دستگاه‌های موجود:
.br
.B vgchange \-a y
.P
تغییر حداکثر تعداد LVها برای یک VG غیرفعال:
.br
.B vgchange \-l 128 vg00
.
.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)