.TH "PVCHANGE" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
pvchange \- تغییر ویژگیها و وضعیت حجمهای فیزیکی در LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBpvchange\fP [\fIگزینهها\fR] [\fIحجم_فیزیکی\fR...]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBpvchange\fR ویژگیهای یک یا چند حجم فیزیکی (PV) را تغییر میدهد؛ از جمله فعال یا غیرفعال کردن قابلیت تخصیص فضا (-x) یا ایجاد برچسب UUID جدید (-u).
.PP
برای گزینه‌هایی که درون پرانتز فهرست شده‌اند، انتخاب یکی از آن‌ها الزامی است و پس از آن سایر گزینه‌ها اختیاری خواهند بود.
.
.SH "نحوه استفاده (USAGE)"
.
تغییر ویژگی‌های تمام PVها:
.br
.P
\fBpvchange\fP \fB\-a\fP|\fB\-\-all\fP
.RS 4
( \fB\-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP
.br
  \fB\-u\fP|\fB\-\-uuid\fP
.br
     \fB\-\-addtag\fP \fITag\fP
.br
     \fB\-\-deltag\fP \fITag\fP
.br
     \fB\-\-metadataignore\fP \fBy\fP|\fBn\fP )
.RE
.br
.RS 4
.na
[ گزینه‌های عمومی ]
.ad
.RE
.P
تغییر ویژگی‌های PVهای مشخص‌شده:
.br
.P
\fBpvchange\fP
.RS 4
( \fB\-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP
.br
  \fB\-u\fP|\fB\-\-uuid\fP
.br
     \fB\-\-addtag\fP \fITag\fP
.br
     \fB\-\-deltag\fP \fITag\fP
.br
     \fB\-\-metadataignore\fP \fBy\fP|\fBn\fP )
.RE
.RS 4
 \fIPV\fP|\fISelect\fP ...
.RE
.br
.RS 4
.na
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ گزینه‌های عمومی ]
.ad
.RE
.P
گزینه‌های عمومی برای این دستور:
.
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[ \fB\-u\fP|\fB\-\-uuid\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.ad
.RE
.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\-\-addtag\fP \fITag\fP
.br
افزودن یک تگ (برچسب) به PV، VG یا LV. این گزینه می‌تواند برای افزودن چندین برچسب به طور همزمان تکرار شود. برای اطلاعات بیشتر درباره برچسب‌ها به \fBlvm\fP(8) مراجعه کنید.
.
.HP
\fB\-a\fP|\fB\-\-all\fP
.br
تغییر ویژگی‌های تمامی PVهای قابل مشاهده.
.
.HP
\fB\-x\fP|\fB\-\-allocatable\fP \fBy\fP|\fBn\fP
.br
فعال یا غیرفعال کردن قابلیت تخصیص اکستنت‌های فیزیکی روی این PV.
.
.HP
\fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP
.br
مشخص می‌کند که آیا پس از اعمال تغییر، نسخه پشتیبان از متادیتا به طور خودکار تهیه شود یا خیر. فعال‌سازی این گزینه اکیداً توصیه می‌شود! برای اطلاعات بیشتر به \fBvgcfgbackup\fP(8) مراجعه کنید.
.
.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) استفاده می‌کند یا می‌تواند از قواعد بخش/فیلد (section/field) بهره ببرد. برای اطلاعات بیشتر درباره پیکربندی به \fBlvm.conf\fP(5) مراجعه کنید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی (دیباگ). تکرار از ۱ تا ۶ بار برای افزایش جزئیات پیام‌های ارسالی به فایل گزارش وقایع (log) و/یا syslog (در صورت پیکربندی).
.
.HP
\fB\-\-deltag\fP \fITag\fP
.br
حذف یک برچسب (تگ) از PV، VG یا LV. این گزینه می‌تواند برای حذف همزمان چندین برچسب تکرار شود. برای اطلاعات بیشتر درباره برچسب‌ها به \fBlvm\fP(8) مراجعه کنید.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
محدود کردن دستگاه‌هایی که برای دستور قابل مشاهده و دسترسی هستند. دستگاه‌هایی که فهرست نشده‌اند، ناموجود به نظر خواهند رسید. این گزینه می‌تواند تکرار شود یا فهرستی از دستگاه‌ها را که با ویرگول انگلیسی از هم جدا شده‌اند بپذیرد. این گزینه بر فایل devices اولویت دارد.
.
.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\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعات فعال‌شده با تنظیم log/journal در lvm.conf است.
command: ثبت اطلاعات درباره دستور.
output: ثبت خروجی پیش‌فرض دستور.
debug: ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌های موارد خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه کنید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای بلند و جامع.
.
.HP
\fB\-\-metadataignore\fP \fBy\fP|\fBn\fP
.br
ویژگی metadataignore یک PV را مشخص می‌کند. اگر yes باشد، نواحی متادیتا روی PV نادیده گرفته می‌شوند و lvm متادیتا را در نواحی متادیتای PV ذخیره نخواهد کرد. اگر no باشد، lvm متادیتا را روی PV ذخیره می‌کند.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل نکات (hints) برای یافتن دستگاه‌های مرتبط با PVها. در صورت عدم استفاده از نکات، ممکن است یک دستور برای یافتن PVها دستگاه‌های بیشتری را بخواند. با این حال، دستور کماکان در صورت نیاز عملیات استاندارد باطل‌سازی فایل نکات را انجام می‌دهد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ اجرای همزمان دستورها ممکن است خروجی‌های نادرستی تولید کند.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار برای \-\-commandprofile یا \-\-metadataprofile بسته به دستور مورد نظر.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
سرکوب خروجی‌ها و پیام‌های وقایع. بر گزینه‌های \-\-debug و \-\-verbose اولویت دارد. با یک بار تکرار بیشتر، همچنین تمامی سوال‌های تایید تعاملی با پاسخ پیش‌فرض 'no' رد می‌شوند.
.
.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\-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\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی (تست). دستورها متادیتا را به‌روزرسانی نخواهند کرد. این قابلیت با غیرفعال کردن نوشتن متادیتا اما بازگرداندن وضعیت موفقیت به تابع فراخواننده پیاده‌سازی شده است. این امر ممکن است در عملیات چندمرحله‌ای منجر به بروز پیام‌های خطای غیرمعمول شود، به ویژه اگر ابزاری بر خواندن مجدد متادیتایی اتکا داشته باشد که تصور می‌کرده تغییر کرده اما تغییر نکرده است.
.
.HP
\fB\-u\fP|\fB\-\-uuid\fP
.br
تولید یک شناسه یکتای عمومی (UUID) تصادفی جدید برای PVهای مشخص‌شده.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی (جزئیات پیام‌ها). تکرار از ۱ تا ۴ بار برای افزایش جزئیات پیام‌های ارسالی به stdout و stderr.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه برنامه.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تایید به صورت تعاملی و در نظر گرفتن همیشگی پاسخ بله (yes). با احتیاط بسیار زیاد استفاده شود. (برای پاسخ خودکار خیر، گزینه \-qq را ببینید.)
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I PV
نام حجم فیزیکی (Physical Volume)، یک مسیر دستگاه زیر شاخه /dev.
برای دستوراتی که اکستنت‌های فیزیکی را مدیریت می‌کنند، آرگومان مکانی PV معمولاً پسوندی را می‌پذیرد که نشان‌دهنده یک محدوده (یا چندین محدوده) از اکستنت‌های فیزیکی (PEs) است. هنگامی که نخستین PE حذف شود، پیش‌فرض ابتدای دستگاه خواهد بود و هنگامی که آخرین PE حذف شود، پیش‌فرض انتهای دستگاه است.
محدوده آغاز و پایان (شامل هر دو):
\fIPV\fP[\fB:\fP\fIPE\fP\fB\-\fP\fIPE\fP]...
محدوده آغاز و طول (شمارش از ۰):
\fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\fP]...
.TP
.I 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).
(این مورد نباید با گزینه کنترل خروجی \-\-units اشتباه گرفته شود که در آن حروف بزرگ به مضارب ۱۰۰۰ اشاره دارند.)
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
برای اطلاعات در مورد متغیرهای محیطی مورد استفاده توسط lvm، به \fBlvm\fP(8) مراجعه کنید.
برای نمونه، \fBLVM_VG_NAME\fP معمولاً می‌تواند جایگزین پارامتر اجباری VG شود.
.
.SH "مثال‌ها (EXAMPLES)"
غیرفعال کردن تخصیص اکستنت‌های فیزیکی روی یک PV (برای نمونه به دلیل خطاهای دیسک، یا به دلیل اینکه پس از آزادسازی حذف خواهد شد):
.PP
.B pvchange \-x n /dev/sdk1
.PP
فعال کردن مجدد امکان تخصیص فضا روی حجم فیزیکی:
.PP
.B pvchange \-x y /dev/sdk1
.PP
ایجاد برچسب UUID تصادفی و جدید برای حجم فیزیکی:
.PP
.B pvchange \-u /dev/sdk1
.
.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)