.TH "PVRESIZE" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
pvresize \- تغییر و بهروزرسانی اندازه حجم فیزیکی در LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBpvresize\fP [\fIگزینهها\fR] \fIدستگاه\fR...
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBpvresize\fR اندازه یک حجم فیزیکی (PV) را پس از تغییر اندازه دیسک یا پارتیشن زیرین آن بهروزرسانی و همگام میکند. این حجم فیزیکی ممکن است از قبل درون یک VG قرار داشته باشد و حجم‌های منطقی (LV) فعال روی آن تخصیص یافته باشند.
.
.SH "کاربرد (USAGE)"
.
\fBpvresize\fP \fIPV\fP ...
.br
.RS 4
.na
[    \fB\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT] ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\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 \fIرشته\fP ]
.br
[    \fB\-\-config\fP \fIرشته\fP ]
.br
[    \fB\-\-devices\fP \fIPV\fP ]
.br
[    \fB\-\-devicesfile\fP \fIرشته\fP ]
.br
[    \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-journal\fP \fIرشته\fP ]
.br
[    \fB\-\-lockopt\fP \fIرشته\fP ]
.br
[    \fB\-\-longhelp\fP ]
.br
[    \fB\-\-nohints\fP ]
.br
[    \fB\-\-nolocking\fP ]
.br
[    \fB\-\-profile\fP \fIرشته\fP ]
.br
[    \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.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\-\-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\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.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\-\-longhelp\fP
.br
نمایش متن راهنمای تفصیلی و کامل.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنماها (hints) برای یافتن دستگاه‌های PV. هنگامی که از راهنماها استفاده نشود، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها اسکن کند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در زمان مناسب اجرا خواهد کرد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن سازوکار قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی ایجاد کنند.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار برای \fB\-\-commandprofile\fP یا \fB\-\-metadataprofile\fP بسته به دستور فراخوانده‌شده.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی و پیام‌های لاگ. بر گزینه‌های \fB\-\-debug\fP و \fB\-\-verbose\fP اولویت دارد. با یک بار تکرار بیشتر، همچنین تمامی پرسش‌ها را با پاسخ فرضی '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\-\-setphysicalvolumesize\fP \fISize\fP[m|UNIT]
.br
اندازه تشخیص داده شده خودکار دستگاه PV را بازنویسی می‌کند. با احتیاط کامل یا پیش از کاهش فیزیکی اندازه دستگاه استفاده شود.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایش. دستورات متادیتا را به‌روزرسانی نخواهند کرد. این حالت با غیرفعال ساختن نوشتن متادیتا اما با این وجود بازگرداندن وضعیت موفقیت‌آمیز به تابع فراخواننده پیاده‌سازی شده است. این رفتار ممکن است در عملیات‌های چندمرحله‌ای خطاهای غیرمعمولی نشان دهد اگر ابزاری وابسته به بازخوانی مجدد متادیتایی باشد که می‌پندارد تغییر یافته است اما در عمل تغییر نیافته است.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی (verbose). این گزینه را بین ۱ تا ۴ بار تکرار کنید تا جزئیات پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد بیشتر شود.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه و نگارش نرم‌افزار.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم پرسش برای تایید تعاملی و در نظر گرفتن همیشگی پاسخ مثبت (yes). با نهایت احتیاط استفاده شود. (برای پاسخ منفی خودکار، به \-qq مراجعه نمایید).
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I PV
نام حجم فیزیکی، یک مسیر دستگاه زیر /dev.
برای دستوراتی که اکستنت‌های فیزیکی را مدیریت می‌کنند، آرگومان مکانی PV عموماً یک پسوند مشخص‌کننده یک محدوده (یا چند محدوده) از اکستنت‌های فیزیکی (PE) را می‌پذیرد. هنگامی که نخستین PE حذف شود، پیش‌فرض آن آغاز دستگاه خواهد بود و هنگامی که آخرین PE حذف شود، پیش‌فرض آن پایان دستگاه است.
محدوده ابتدا و انتها (شامل دو طرف):
\fIPV\fP[\fB:\fP\fIPE\fP\fB\-\fP\fIPE\fP]...
محدوده ابتدا و طول (شمارش از ۰):
\fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\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)"
.
دستور pvresize در صورتی که اکستنت‌های تخصیص‌یافته‌ای فراتر از انتهای اندازه جدید وجود داشته باشند، از کوچک کردن (shrink) حجم فیزیکی (PV) خودداری خواهد کرد.
.
.SH "مثال‌ها (EXAMPLES)"
.
گسترش دادن یک PV پس از بزرگ‌تر کردن پارتیشن زیرین:
.br
.B pvresize /dev/sda1
.P
کوچک کردن یک PV پیش از کوچک کردن پارتیشن زیرین (اطمینان حاصل کنید که اندازه PV متناسب با اندازه جدید در نظر گرفته شده برای پارتیشن باشد):
.br
.B pvresize \-\-setphysicalvolumesize 40G /dev/sda1
.
.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)