نام (NAME)

pvchange - تغییر ویژگیها و وضعیت حجمهای فیزیکی در LVM

خلاصه دستور (SYNOPSIS)

pvchange [گزینهها] [حجم_فیزیکی...]

توضیحات (DESCRIPTION)

دستور pvchange ویژگیهای یک یا چند حجم فیزیکی (PV) را تغییر میدهد؛ از جمله فعال یا غیرفعال کردن قابلیت تخصیص فضا (-x) یا ایجاد برچسب UUID جدید (-u).

برای گزینه‌هایی که درون پرانتز فهرست شده‌اند، انتخاب یکی از آن‌ها الزامی است و پس از آن سایر گزینه‌ها اختیاری خواهند بود.

نحوه استفاده (USAGE)

تغییر ویژگی‌های تمام PVها:

pvchange -a|--all

تغییر ویژگی‌های PVهای مشخص‌شده:

pvchange

گزینه‌های عمومی برای این دستور:

گزینه‌های عمومی برای lvm:

گزینه‌ها (OPTIONS)

--addtag Tag
افزودن یک تگ (برچسب) به PV، VG یا LV. این گزینه می‌تواند برای افزودن چندین برچسب به طور همزمان تکرار شود. برای اطلاعات بیشتر درباره برچسب‌ها به lvm(8) مراجعه کنید.

-a|--all
تغییر ویژگی‌های تمامی PVهای قابل مشاهده.

-x|--allocatable y|n
فعال یا غیرفعال کردن قابلیت تخصیص اکستنت‌های فیزیکی روی این PV.

-A|--autobackup y|n
مشخص می‌کند که آیا پس از اعمال تغییر، نسخه پشتیبان از متادیتا به طور خودکار تهیه شود یا خیر. فعال‌سازی این گزینه اکیداً توصیه می‌شود! برای اطلاعات بیشتر به vgcfgbackup(8) مراجعه کنید.

--commandprofile String
پروفایل دستوری مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره پروفایل‌ها به lvm.conf(5) مراجعه کنید.

--config String
تنظیمات پیکربندی برای دستور که جایگزین تنظیمات lvm.conf(5) می‌شوند. آرگومان رشته از همان فرمت lvm.conf(5) استفاده می‌کند یا می‌تواند از قواعد بخش/فیلد (section/field) بهره ببرد. برای اطلاعات بیشتر درباره پیکربندی به lvm.conf(5) مراجعه کنید.

-d|--debug ...
تنظیم سطح اشکال‌زدایی (دیباگ). تکرار از ۱ تا ۶ بار برای افزایش جزئیات پیام‌های ارسالی به فایل گزارش وقایع (log) و/یا syslog (در صورت پیکربندی).

--deltag Tag
حذف یک برچسب (تگ) از PV، VG یا LV. این گزینه می‌تواند برای حذف همزمان چندین برچسب تکرار شود. برای اطلاعات بیشتر درباره برچسب‌ها به lvm(8) مراجعه کنید.

--devices PV
محدود کردن دستگاه‌هایی که برای دستور قابل مشاهده و دسترسی هستند. دستگاه‌هایی که فهرست نشده‌اند، ناموجود به نظر خواهند رسید. این گزینه می‌تواند تکرار شود یا فهرستی از دستگاه‌ها را که با ویرگول انگلیسی از هم جدا شده‌اند بپذیرد. این گزینه بر فایل devices اولویت دارد.

--devicesfile String
فایلی شامل فهرست دستگاه‌هایی که LVM باید استفاده کند. این فایل باید در مسیر /etc/lvm/devices/ وجود داشته باشد و با دستور lvmdevices(8) مدیریت می‌شود. این گزینه تنظیمات devices/devicesfile و devices/use_devicesfile در lvm.conf(5) را بازنویسی می‌کند.

--driverloaded y|n
اگر روی no تنظیم شود، دستور تلاشی برای استفاده از دیسک‌نگار (device-mapper) نخواهد کرد. برای آزمایش و اشکال‌زدایی کاربرد دارد.

-f|--force ...
نادیده گرفتن بررسی‌های مختلف، تاییدها و محافظت‌ها. با احتیاط بسیار زیاد استفاده شود.

-h|--help
نمایش متن راهنمای خلاصه.

--journal String
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعات فعال‌شده با تنظیم log/journal در lvm.conf است. command: ثبت اطلاعات درباره دستور. output: ثبت خروجی پیش‌فرض دستور. debug: ثبت اشکال‌زدایی کامل دستور.

--lockopt String
برای ارسال گزینه‌های موارد خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به lvmlockd(8) مراجعه کنید.

--longhelp
نمایش متن راهنمای بلند و جامع.

--metadataignore y|n
ویژگی metadataignore یک PV را مشخص می‌کند. اگر yes باشد، نواحی متادیتا روی PV نادیده گرفته می‌شوند و lvm متادیتا را در نواحی متادیتای PV ذخیره نخواهد کرد. اگر no باشد، lvm متادیتا را روی PV ذخیره می‌کند.

--nohints
عدم استفاده از فایل نکات (hints) برای یافتن دستگاه‌های مرتبط با PVها. در صورت عدم استفاده از نکات، ممکن است یک دستور برای یافتن PVها دستگاه‌های بیشتری را بخواند. با این حال، دستور کماکان در صورت نیاز عملیات استاندارد باطل‌سازی فایل نکات را انجام می‌دهد.

--nolocking
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ اجرای همزمان دستورها ممکن است خروجی‌های نادرستی تولید کند.

--profile String
نام مستعار برای --commandprofile یا --metadataprofile بسته به دستور مورد نظر.

-q|--quiet ...
سرکوب خروجی‌ها و پیام‌های وقایع. بر گزینه‌های --debug و --verbose اولویت دارد. با یک بار تکرار بیشتر، همچنین تمامی سوال‌های تایید تعاملی با پاسخ پیش‌فرض 'no' رد می‌شوند.

--reportformat basic|json|json_std
تغییر فرمت فعلی خروجی گزارش‌ها که به صورت سراسری در تنظیم report/output_format در lvm.conf(5) تعریف شده است. مقدار basic فرمت اصلی شامل ستون‌ها و سطرها است. در صورتی که در هر دستور بیش از یک گزارش وجود داشته باشد، هر گزارش برای شناسایی با نام گزارش پیشوندگذاری می‌شود. مقدار json خروجی گزارش را با فرمت JSON تولید می‌کند. مقدار json_std خروجی گزارش را با فرمت JSON منطبق‌تر بر استانداردهای JSON ارائه می‌دهد. برای اطلاعات بیشتر به lvmreport(7) مراجعه کنید.

-S|--select String
انتخاب اشیاء برای پردازش و گزارش‌گیری بر اساس معیارهای مشخص‌شده. قواعد نگارش معیارها در --select help و lvmreport(7) شرح داده شده است. برای دستورهای گزارش‌گیری، به ازای هر شیء منطبق بر معیارها یک سطر نمایش داده می‌شود. فیلدهای قابل انتخاب برای اشیاء را در --options help ببینید. سطرها می‌توانند با فیلد اضافی "selected" (-o selected) نمایش داده شوند که در صورت انطباق مقدار ۱ و در غیر این صورت مقدار ۰ را نشان می‌دهد. برای دستورهای غیرگزارش‌گیری که موجودیت‌های LVM را پردازش می‌کنند، این انتخاب برای تعیین مواردی که باید پردازش شوند به کار می‌رود.

-t|--test
اجرا در حالت آزمایشی (تست). دستورها متادیتا را به‌روزرسانی نخواهند کرد. این قابلیت با غیرفعال کردن نوشتن متادیتا اما بازگرداندن وضعیت موفقیت به تابع فراخواننده پیاده‌سازی شده است. این امر ممکن است در عملیات چندمرحله‌ای منجر به بروز پیام‌های خطای غیرمعمول شود، به ویژه اگر ابزاری بر خواندن مجدد متادیتایی اتکا داشته باشد که تصور می‌کرده تغییر کرده اما تغییر نکرده است.

-u|--uuid
تولید یک شناسه یکتای عمومی (UUID) تصادفی جدید برای PVهای مشخص‌شده.

-v|--verbose ...
تنظیم سطح پرگویی (جزئیات پیام‌ها). تکرار از ۱ تا ۴ بار برای افزایش جزئیات پیام‌های ارسالی به stdout و stderr.

--version
نمایش اطلاعات نسخه برنامه.

-y|--yes
عدم درخواست تایید به صورت تعاملی و در نظر گرفتن همیشگی پاسخ بله (yes). با احتیاط بسیار زیاد استفاده شود. (برای پاسخ خودکار خیر، گزینه -qq را ببینید.)

متغیرها (VARIABLES)

PV

نام حجم فیزیکی (Physical Volume)، یک مسیر دستگاه زیر شاخه /dev. برای دستوراتی که اکستنت‌های فیزیکی را مدیریت می‌کنند، آرگومان مکانی PV معمولاً پسوندی را می‌پذیرد که نشان‌دهنده یک محدوده (یا چندین محدوده) از اکستنت‌های فیزیکی (PEs) است. هنگامی که نخستین PE حذف شود، پیش‌فرض ابتدای دستگاه خواهد بود و هنگامی که آخرین PE حذف شود، پیش‌فرض انتهای دستگاه است. محدوده آغاز و پایان (شامل هر دو): PV[:PE-PE]... محدوده آغاز و طول (شمارش از ۰): PV[:PE+PE]...

Select

نشان می‌دهد در صورت استفاده از گزینه --select می‌توان از یک پارامتر مکانی اجباری صرف‌نظر کرد. هیچ آرگومانی در این جایگاه قرار نمی‌گیرد.

String

برای اطلاعات بیشتر درباره محتوای رشته، توضیحات گزینه مربوطه را مشاهده کنید.

Size[UNIT]

اندازه یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد. واحدهای ورودی بدون توجه به بزرگی یا کوچکی حروف، همواره مقادیر بر مبنای ۲ در نظر گرفته می‌شوند؛ به عنوان مثال هر دوی 'k' و 'K' به ۱۰۲۴ اشاره دارند. واحد ورودی پیش‌فرض با حرف و به دنبال آن |UNIT مشخص می‌شود. UNIT سایر واحدهای ورودی ممکن را نشان می‌دهد: b|B بایت، s|S سکتورهای ۵۱۲ بایتی، k|K کیبی‌بایت (KiB)، m|M مبی‌بایت (MiB)، g|G گیبی‌بایت (GiB)، t|T تبی‌بایت (TiB)، p|P پبی‌بایت (PiB)، e|E اگزی‌بایت (EiB). (این مورد نباید با گزینه کنترل خروجی --units اشتباه گرفته شود که در آن حروف بزرگ به مضارب ۱۰۰۰ اشاره دارند.)

متغیرهای محیطی (ENVIRONMENT VARIABLES)

برای اطلاعات در مورد متغیرهای محیطی مورد استفاده توسط lvm، به lvm(8) مراجعه کنید. برای نمونه، LVM_VG_NAME معمولاً می‌تواند جایگزین پارامتر اجباری VG شود.

مثال‌ها (EXAMPLES)

غیرفعال کردن تخصیص اکستنت‌های فیزیکی روی یک PV (برای نمونه به دلیل خطاهای دیسک، یا به دلیل اینکه پس از آزادسازی حذف خواهد شد):

pvchange -x n /dev/sdk1

فعال کردن مجدد امکان تخصیص فضا روی حجم فیزیکی:

pvchange -x y /dev/sdk1

ایجاد برچسب UUID تصادفی و جدید برای حجم فیزیکی:

pvchange -u /dev/sdk1

همچنین ببینید (SEE ALSO)

lvm(8), lvm.conf(5), lvmconfig(8), lvmdevices(8),

pvchange(8), pvck(8), pvcreate(8), pvdisplay(8), pvmove(8), pvremove(8), pvresize(8), pvs(8), pvscan(8),

vgcfgbackup(8), vgcfgrestore(8), vgchange(8), vgck(8), vgcreate(8), vgconvert(8), vgdisplay(8), vgexport(8), vgextend(8), vgimport(8), vgimportclone(8), vgimportdevices(8), vgmerge(8), vgmknodes(8), vgreduce(8), vgremove(8), vgrename(8), vgs(8), vgscan(8), vgsplit(8),

lvcreate(8), lvchange(8), lvconvert(8), lvdisplay(8), lvextend(8), lvreduce(8), lvremove(8), lvrename(8), lvresize(8), lvs(8), lvscan(8),

lvm-fullreport(8), lvm-lvpoll(8), blkdeactivate(8), lvmdump(8),

dmeventd(8), lvmpolld(8), lvmlockd(8), lvmlockctl(8), cmirrord(8), lvmdbusd(8), fsadm(8),

lvmsystemid(7), lvmreport(7), lvmcache(7), lvmraid(7), lvmthin(7), lvmvdo(7), lvmautoactivation(7)