.TH "LVCHANGE" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
lvchange \- تغییر ویژگیها و وضعیت حجم منطقی در LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBlvchange\fP \fIموقعیت_گزینهها\fR [\fIگزینهها\fR] [\fIحجم_منطقی\fR...]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBlvchange\fR ویژگیهای یک یا چند حجم منطقی (Logical Volume) را تغییر میدهد؛ از جمله فعال/غیرفعال کردن (-a)، تغییر وضعیت دسترسی خواندن/نوشتن (-p)، تنظیم بازخوانی و مجوزها.
.
.SH "نحوه استفاده (USAGE)"
تغییر یک ویژگی عمومی در حجم منطقی (LV).
.br
برای گزینه‌های فهرست‌شده در پرانتز، انتخاب هر یک از آن‌ها الزامی است و پس از آن بقیه اختیاری خواهند بود:
.P
\fBlvchange\fP
.RS 4
( \fB\-C\fP|\fB\-\-contiguous\fP \fBy\fP|\fBn\fP
.br
  \fB\-p\fP|\fB\-\-permission\fP \fBrw\fP|\fBr\fP
.br
  \fB\-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP
.br
  \fB\-k\fP|\fB\-\-setactivationskip\fP \fBy\fP|\fBn\fP
.br
  \fB\-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP
.br
  \fB\-M\fP|\fB\-\-persistent\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\-\-compression\fP \fBy\fP|\fBn\fP
.br
     \fB\-\-deduplication\fP \fBy\fP|\fBn\fP
.br
     \fB\-\-detachprofile\fP
.br
     \fB\-\-metadataprofile\fP \fIString\fP
.br
     \fB\-\-profile\fP \fIString\fP
.br
     \fB\-\-setautoactivation\fP \fBy\fP|\fBn\fP
.br
     \fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP
.br
     \fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP
.br
     \fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP
.br
     \fB\-\-cachepolicy\fP \fIString\fP
.br
     \fB\-\-cachesettings\fP \fIString\fP
.br
     \fB\-\-\fP[\fBraid\fP]\fBminrecoveryrate\fP \fISize\fP[k|UNIT]
.br
     \fB\-\-\fP[\fBraid\fP]\fBmaxrecoveryrate\fP \fISize\fP[k|UNIT]
.br
     \fB\-\-vdosettings\fP \fIString\fP
.br
     \fB\-\-integritysettings\fP \fIString\fP
.br
     \fB\-\-\fP[\fBraid\fP]\fBwritebehind\fP \fINumber\fP
.br
     \fB\-\-\fP[\fBraid\fP]\fBwritemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP] )
.RE
.RS 4
 \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ...
.RE
.br
.RS 4
.na
[ \fB\-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP ]
.br
[    \fB\-\-poll\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-monitor\fP \fBy\fP|\fBn\fP ]
.br
[ COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
همگام‌سازی مجدد یک حجم منطقی آینه‌ای (mirror) یا RAID.
.br
برای بازنشانی ویژگی 'R' در یک LV که در ابتدا همگام‌سازی نشده است، استفاده می‌شود:
.br
.P
\fBlvchange\fP \fB\-\-resync\fP \fIVG\fP|\fILV1\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[ \fB\-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP ]
.br
[ COMMON_OPTIONS ]
.ad
.RE
.P
.RS 4
انواع مجاز برای LV1: mirror raid
.RE
.P
\(em
.P
همگام‌سازی مجدد یا بررسی یک حجم منطقی RAID:
.br
.P
\fBlvchange\fP \fB\-\-\fP[\fBraid\fP]\fBsyncaction\fP \fBcheck\fP|\fBrepair\fP \fIVG\fP|\fILV1\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[ COMMON_OPTIONS ]
.ad
.RE
.P
.RS 4
انواع مجاز برای LV1: raid
.RE
.P
\(em
.P
بازسازی داده‌ها روی حجم‌های فیزیکی (PV) مشخص از یک حجم منطقی RAID:
.br
.P
\fBlvchange\fP \fB\-\-rebuild\fP \fIPV\fP \fIVG\fP|\fILV1\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[ COMMON_OPTIONS ]
.ad
.RE
.P
.RS 4
انواع مجاز برای LV1: raid
.RE
.P
\(em
.P
فعال یا غیرفعال کردن یک حجم منطقی (LV):
.br
.P
\fBlvchange\fP \fB\-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[ \fB\-P\fP|\fB\-\-partial\fP ]
.br
[ \fB\-K\fP|\fB\-\-ignoreactivationskip\fP ]
.br
[    \fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ]
.br
[    \fB\-\-poll\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-monitor\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-sysinit\fP ]
.br
[    \fB\-\-readonly\fP ]
.br
[ COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
فعال‌سازی مجدد یک حجم منطقی با استفاده از آخرین متاداده‌ها:
.br
.P
\fBlvchange\fP \fB\-\-refresh\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[ \fB\-P\fP|\fB\-\-partial\fP ]
.br
[    \fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP ]
.br
[    \fB\-\-poll\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-monitor\fP \fBy\fP|\fBn\fP ]
.br
[ COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
آغاز یا توقف نظارت بر یک حجم منطقی توسط dmeventd:
.br
.P
\fBlvchange\fP \fB\-\-monitor\fP \fBy\fP|\fBn\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[ COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
آغاز یا توقف پردازش تبدیل یک حجم منطقی:
.br
.P
\fBlvchange\fP \fB\-\-poll\fP \fBy\fP|\fBn\fP \fIVG\fP|\fILV\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[    \fB\-\-monitor\fP \fBy\fP|\fBn\fP ]
.br
[ COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
ثابت و دائمی کردن شماره فرعی دستگاه (minor number) برای یک حجم منطقی:
.br
.P
\fBlvchange\fP \fB\-M\fP|\fB\-\-persistent\fP \fBy\fP \fB\-\-minor\fP \fINumber\fP \fILV\fP
.br
.RS 4
.na
[ \fB\-j\fP|\fB\-\-major\fP \fINumber\fP ]
.br
[ \fB\-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP ]
.br
[    \fB\-\-poll\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-monitor\fP \fBy\fP|\fBn\fP ]
.br
[ COMMON_OPTIONS ]
.ad
.RE
.P
\(em
.P
گزینه‌های مشترک دستور:
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[    \fB\-\-ignoremonitoring\fP ]
.br
[    \fB\-\-noudevsync\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\-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP
.br
تغییر وضعیت فعال بودن حجم‌های منطقی (LVها).
یک حجم منطقی فعال می‌تواند از طریق یک دستگاه بلوکی مورد استفاده قرار گیرد و دسترسی به داده‌های موجود در آن امکان‌پذیر شود.
مقدار
.B y
حجم‌های منطقی را فعال یا در دسترس قرار می‌دهد.
مقدار
.B n
آن‌ها را غیرفعال یا غیرقابل دسترس می‌کند.
دستگاه بلوکی مربوط به LV از طریق device-mapper در هسته لینوکس به سیستم اضافه یا از آن حذف می‌شود.
همچنین پیوند نمادین
.I /dev/VGName/LVName
که به گره دستگاه اشاره دارد اضافه یا حذف می‌گردد.
تمام نرم‌افزارها و اسکریپت‌ها باید از طریق این پیوند نمادین به دستگاه دسترسی داشته باشند و آن را به عنوان نام دستگاه معرفی کنند.
مکان و نام گره دستگاه اصلی ممکن است به توزیع لینوکس، پیکربندی (مانند udev) یا نسخه انتشار سیستم‌عامل بستگی داشته باشد.
مقدار
.B ay
فعال‌سازی خودکار (autoactivation) را مشخص می‌کند که توسط دستورات سیستمی فعال‌سازی استفاده می‌شود. به طور پیش‌فرض، LVها به صورت خودکار فعال می‌شوند.
ویژگی فعال‌سازی خودکار را می‌توان روی یک VG یا LV تنظیم کرد تا فعال‌سازی خودکار غیرفعال شود؛ به
.B \-\-setautoactivation y|n
در
.BR vgchange ،
.BR lvchange ،
.B vgcreate
و
.B lvcreate
مراجعه کنید.
این ویژگی را می‌توانید با
.B vgs
یا
.B lvs
همراه با
.B "\-o autoactivation"
مشاهده کنید.
تنظیم
.B auto_activation_volume_list
در
.BR lvm.conf (5)
شامل نام‌های VGها یا LVهایی است که باید به طور خودکار فعال شوند و هر موردی که فهرست نشده باشد به طور خودکار فعال نخواهد شد.
هنگامی که این متغیر تعریف نشده باشد (حالت پیش‌فرض)، هیچ تاثیری ندارد.
اگر این متغیر تعریف شده و خالی باشد، هیچ حجم منطقی‌ای به صورت خودکار فعال نخواهد شد.
مواردی که در این فهرست گنجانده شده‌اند در صورتی که ویژگی فعال‌سازی خودکار آن‌ها غیرفعال شده باشد، فعال نخواهند شد.
برای اطلاعات بیشتر درباره گزینه‌های فعال‌سازی
.B ey
و
.B sy
برای VGهای اشتراکی به
.BR lvmlockd (8)
مراجعه کنید.
.
.HP
\fB\-\-activationmode\fP \fBpartial\fP|\fBdegraded\fP|\fBcomplete\fP
.br
مشخص می‌کند که آیا در صورت مفقود بودن حجم‌های فیزیکی (PVها)، مثلاً به دلیل خرابی دستگاه، فعال‌سازی حجم منطقی مجاز است یا خیر.
حالت
.B complete
سخت‌گیرانه‌ترین حالت است و تنها به LVهایی اجازه فعال‌سازی می‌دهد که هیچ PV مفقودی نداشته باشند.
حالت
.B degraded
اجازه می‌دهد حجم‌های منطقی RAID با وجود PVهای مفقود فعال شوند (این شامل نوع "mirror" نمی‌شود؛ به جای آن "raid1" را ببینید).
حالت
.B partial
اجازه می‌دهد هر LV با PVهای مفقود فعال شود و فقط باید برای بازیابی یا تعمیرات استفاده شود.
برای رفتار پیش‌فرض، به
.B activation_mode
در
.BR lvm.conf (5)
مراجعه کنید. برای اطلاعات بیشتر به
.BR lvmraid (7)
مراجعه نمایید.
.
.HP
\fB\-\-addtag\fP \fITag\fP
.br
افزودن یک برچسب (تگ) به PV، VG یا LV. این گزینه می‌تواند تکرار شود تا چندین تگ به صورت هم‌زمان اضافه شوند. برای اطلاعات درباره تگ‌ها به
.BR lvm (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 تغییر داد یا در خط فرمان لغو کرد.
حالت
.B normal
قوانین استاندارد منطقی مانند قرار ندادن خطوط موازی (stripes) روی یک PV را اعمال می‌کند.
حالت
.B inherit
سیاست VG را روی LV اعمال می‌کند.
حالت
.B contiguous
نیازمند آن است که PEهای جدید در مجاورت PEهای موجود قرار گیرند.
حالت
.B cling
امتدادهای فیزیکی جدید را روی همان PV که PEهای موجود در همان خط (stripe) از LV قرار دارند جای می‌دهد.
اگر PEهای کافی برای یک تخصیص وجود داشته باشد اما حالت normal از آن‌ها استفاده نکند، حالت
.B anywhere
حتی در صورت کاهش کارایی (مانند قرار دادن دو استرایپ روی یک PV) از آن‌ها استفاده خواهد کرد.
آرگومان‌های مکانی اختیاری PV در خط فرمان نیز می‌توانند برای محدود کردن PVهای مورد استفاده دستور برای تخصیص به کار روند.
برای اطلاعات بیشتر درباره سیاست‌های تخصیص به
.BR lvm (8)
مراجعه کنید.
.
.HP
\fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP
.br
مشخص می‌کند که آیا متاداده‌ها پس از تغییر باید به طور خودکار پشتیبان‌گیری شوند یا خیر. فعال کردن این گزینه شدیداً توصیه می‌شود! برای اطلاعات بیشتر به
.BR vgcfgbackup (8)
مراجعه کنید.
.
.HP
\fB\-\-cachemode\fP \fBwritethrough\fP|\fBwriteback\fP|\fBpassthrough\fP
.br
مشخص می‌کند چه زمانی نوشتن در یک LV کش باید کامل در نظر گرفته شود.
حالت
.B writeback
به محض ذخیره شدن داده در استخر کش (cache pool)، عملیات نوشتن را کامل تلقی می‌کند.
حالت
.B writethrough
تنها زمانی عملیات نوشتن را کامل می‌داند که داده هم در استخر کش و هم روی LV اصلی ذخیره شده باشد. هرچند writethrough ممکن است برای نوشتن کندتر باشد، اما در صورت بروز مشکل سخت‌افزاری برای دستگاه مرتبط با استخر کش، امن‌تر و مقاوم‌تر است.
در حالت
.B passthrough
تمام خواندن‌ها از LV اصلی انجام می‌شود (تمام خواندن‌ها کش را دور می‌زنند) و تمام نوشتن‌ها به LV اصلی ارسال می‌گردند؛ علاوه بر این، اصابت‌های نوشتن (write hits) باعث نامعتبر شدن بلوک‌های کش می‌شود. برای اطلاعات بیشتر به
.BR lvmcache (7)
مراجعه کنید.
.
.HP
\fB\-\-cachepolicy\fP \fIString\fP
.br
سیاست کش را برای یک LV کش مشخص می‌کند. برای اطلاعات بیشتر به
.BR lvmcache (7)
مراجعه کنید.
.
.HP
\fB\-\-cachesettings\fP \fIString\fP
.br
تنظیمات قابل تنظیم هسته را برای LVهای dm-cache یا dm-writecache تعیین می‌کند.
از قالب 'option=value' یا 'option1=value option2=value' استفاده کنید، یا گزینه
.B \-\-cachesettings
را برای هر گزینه تنظیمی تکرار نمایید. این تنظیمات رفتارهای پیش‌فرض هسته را لغو می‌کنند. برای حذف تنظیمات کش و بازگشت به رفتارهای پیش‌فرض هسته، از
.B "\-\-cachesettings 'default'"
برای dm-cache یا رشته خالی
.B "\-\-cachesettings ''"
برای dm-writecache استفاده کنید. برای اطلاعات بیشتر به
.BR lvmcache (7)
مراجعه کنید.
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
پروفایل فرمانی که برای پیکربندی دستور استفاده می‌شود. برای اطلاعات بیشتر درباره پروفایل‌ها به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-\-compression\fP \fBy\fP|\fBn\fP
.br
کنترل فعال یا غیرفعال بودن فشرده‌سازی برای یک حجم VDO. برای اطلاعات بیشتر درباره کاربرد VDO به
.BR lvmvdo (7)
مراجعه نمایید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور که تنظیمات
.BR lvm.conf (5)
را لغو می‌کنند. آرگومان رشته‌ای از همان قالب
.BR lvm.conf (5)
استفاده می‌کند یا می‌تواند از ساختار بخش/فیلد بهره ببرد. برای اطلاعات بیشتر درباره تنظیمات به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-C\fP|\fB\-\-contiguous\fP \fBy\fP|\fBn\fP
.br
سیاست تخصیص پیوسته (contiguous) را برای LVها فعال یا غیرفعال می‌کند. حالت پیش‌فرض، عدم تخصیص پیوسته بر اساس اصل اولین فضای آزاد است. تغییر سیاست تخصیص غیرپیوسته به پیوسته تنها در صورتی ممکن است که تمام امتدادهای فیزیکی تخصیص‌یافته در LV از قبل پیوسته باشند.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی. برای افزایش جزئیات پیام‌های ارسالی به فایل لاگ و/یا syslog این گزینه را از ۱ تا ۶ بار تکرار کنید.
.
.HP
\fB\-\-deduplication\fP \fBy\fP|\fBn\fP
.br
کنترل فعال یا غیرفعال بودن حذف داده‌های تکراری (deduplication) برای حجم VDO. برای اطلاعات بیشتر به
.BR lvmvdo (7)
مراجعه کنید.
.
.HP
\fB\-\-deltag\fP \fITag\fP
.br
حذف یک برچسب (تگ) از PV، VG یا LV. می‌توان این گزینه را برای حذف هم‌زمان چندین تگ تکرار کرد. برای اطلاعات درباره تگ‌ها به
.BR lvm (8)
مراجعه کنید.
.
.HP
\fB\-\-detachprofile\fP
.br
جدا کردن یک پروفایل متاداده از یک VG یا LV. برای اطلاعات بیشتر درباره پروفایل‌ها به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
دستگاه‌هایی را که برای دستور قابل مشاهده و دسترسی هستند محدود می‌کند. دستگاه‌هایی که فهرست نشده باشند به عنوان مفقود در نظر گرفته می‌شوند. این گزینه می‌تواند تکرار شود یا فهرستی از دستگاه‌های جدا شده با کاما را بپذیرد. این گزینه فایل devices را لغو می‌کند.
.
.HP
\fB\-\-devicesfile\fP \fIString\fP
.br
فایلی که دستگاه‌های مجاز برای استفاده توسط LVM را فهرست می‌کند. این فایل باید در مسیر
.I /etc/lvm/devices/
موجود باشد و با دستور
.BR lvmdevices (8)
مدیریت شود. این گزینه تنظیمات
.B devices/devicesfile
و
.B devices/use_devicesfile
در
.BR lvm.conf (5)
را لغو می‌کند.
.
.HP
\fB\-\-discards\fP \fBpassdown\fP|\fBnopassdown\fP|\fBignore\fP
.br
نحوه مدیریت درخواست‌های discard توسط لایه استخر نازک (thin pool) دیسک‌مپِر در هسته را تعیین می‌کند.
مقدار
.B ignore
باعث نادیده گرفتن درخواست‌های discard می‌شود.
مقدار
.B nopassdown
باعث می‌شود استخر نازک خودش discardها را پردازش کند تا امکان استفاده مجدد از امتدادهای غیرضروری در استخر فراهم شود.
مقدار
.B passdown
علاوه بر پردازش داخلی، discardها را به دستگاه لایه زیرین نیز ارسال می‌کند. برای اطلاعات بیشتر به
.BR lvmthin (7)
مراجعه کنید.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم روی no، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. این گزینه برای اهداف آزمایش و اشکال‌زدایی کاربرد دارد.
.
.HP
\fB\-\-errorwhenfull\fP \fBy\fP|\fBn\fP
.br
رفتار استخر نازک را هنگام اتمام فضای داده مشخص می‌کند.
اگر yes باشد، دیسک‌مپِر به محض پر شدن استخر نازک و نیاز یک درخواست I/O به فضا، فوراً خطا بازمی‌گرداند.
اگر no باشد، دیسک‌مپِر این درخواست‌های I/O را برای مدتی در صف نگه می‌دارد تا امکان افزایش اندازه استخر نازک فراهم شود. در صورت عدم تامین فضا پس از مهلت زمانی، خطا برگردانده می‌شود. به
.BR lvmthin (7)
مراجعه کنید.
.
.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هایی که این پرچم روی آن‌ها فعال است.
.
.HP
\fB\-\-ignorelockingfailure\fP
.br
امکان ادامه اجرای دستور با عملیات متاداده فقط‌خواندنی پس از شکست در قفل‌گذاری.
.
.HP
\fB\-\-ignoremonitoring\fP
.br
عدم تعامل با dmeventd مگر اینکه گزینه
.B \-\-monitor
مشخص شده باشد. اگر dmeventd در حال حاضر بر دستگاهی نظارت دارد، از این گزینه استفاده نکنید.
.
.HP
\fB\-\-integritysettings\fP \fIString\fP
.br
تعیین گزینه‌های تنظیمی هسته برای dm-integrity. برای اطلاعات بیشتر به
.BR lvmraid (7)
مراجعه کنید.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات افزون بر مواردی است که با تنظیم log/journal در lvm.conf فعال شده‌اند.
مقدار command: ثبت اطلاعات دستور.
مقدار output: ثبت خروجی پیش‌فرض دستور.
مقدار debug: ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
ارسال گزینه‌های خاص به lvmlockd. برای اطلاعات بیشتر به
.BR lvmlockd (8)
مراجعه فرمایید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای بلند و جامع.
.
.HP
\fB\-j\fP|\fB\-\-major\fP \fINumber\fP
.br
تنظیم شماره دستگاه اصلی (major number) برای دستگاه بلوکی LV.
.
.HP
\fB\-\-\fP[\fBraid\fP]\fBmaxrecoveryrate\fP \fISize\fP[k|UNIT]
.br
تنظیم حداکثر سرعت بازیابی برای یک RAID LV. مقدار نرخ، حجم داده در ثانیه برای هر دستگاه در آرایه است. تنظیم نرخ روی 0 به معنای نامحدود بودن آن است. برای اطلاعات بیشتر به
.BR lvmraid (7)
مراجعه کنید.
.
.HP
\fB\-\-metadataprofile\fP \fIString\fP
.br
پروفایل متاداده مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-\-minor\fP \fINumber\fP
.br
تنظیم شماره فرعی دستگاه (minor number) برای دستگاه بلوکی LV.
.
.HP
\fB\-\-\fP[\fBraid\fP]\fBminrecoveryrate\fP \fISize\fP[k|UNIT]
.br
تنظیم حداقل سرعت بازیابی برای یک RAID LV. مقدار نرخ، حجم داده در ثانیه برای هر دستگاه در آرایه است. تنظیم نرخ روی 0 به معنای نامحدود بودن آن است. برای اطلاعات بیشتر به
.BR lvmraid (7)
مراجعه کنید.
.
.HP
\fB\-\-monitor\fP \fBy\fP|\fBn\fP
.br
آغاز (yes) یا توقف (no) نظارت بر یک LV توسط dmeventd. دیمن dmeventd رویدادهای هسته را برای LV پایش کرده و نگهداری خودکار را در پاسخ به رویدادهای خاص به انجام می‌رساند. برای اطلاعات بیشتر به
.BR dmeventd (8)
مراجعه کنید.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل hints برای یافتن دستگاه‌های مربوط به PVها. در صورت عدم استفاده از این فایل، دستور ممکن است دستگاه‌های بیشتری را برای یافتن PVها اسکن کند.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات هم‌روند ممکن است نتایج نادرست یا خرابی داده تولید کنند.
.
.HP
\fB\-\-noudevsync\fP
.br
غیرفعال کردن همگام‌سازی با udev. پردازش منتظر اعلان از سوی udev نخواهد ماند و فارغ از هرگونه پردازش در پس‌زمینه ادامه خواهد یافت. تنها در صورتی از این گزینه استفاده کنید که udev در حال اجرا نباشد یا دارای قواعدی باشد که دستگاه‌های ساخته‌شده توسط LVM را نادیده می‌گیرند.
.
.HP
\fB\-P\fP|\fB\-\-partial\fP
.br
دستورات تمام تلاش خود را برای فعال‌سازی LVهایی که دارای امتدادهای فیزیکی (PE) مفقود هستند به کار می‌بندند. امتدادهای مفقود ممکن است بر اساس تنظیم missing_stripe_filler با بخش‌های خطا یا صفر جایگزین شوند. متاداده با این گزینه قابل تغییر نیست.
.
.HP
\fB\-p\fP|\fB\-\-permission\fP \fBrw\fP|\fBr\fP
.br
تنظیم مجوز دسترسی به حالت فقط‌خواندنی
.B r
یا خواندن و نوشتن
.BR rw .
.
.HP
\fB\-M\fP|\fB\-\-persistent\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم روی yes، شماره فرعی مشخص‌شده (minor number) را ثابت و دائمی می‌کند.
.
.HP
\fB\-\-poll\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم روی yes، عملیات تغییر و تبدیل پس‌زمینه‌ای یک LV آغاز می‌شود. تبدیل‌های ناقص (مانند pvmove یا lvconvert که با راه‌اندازی مجدد یا کرش سیستم متوقف شده‌اند) می‌توانند از آخرین نقطه بازرسی با
.B "\-\-poll y"
مجدداً آغاز شوند. در صورت تنظیم روی no، تبدیل پس‌زمینه انجام نخواهد شد و ناقص باقی می‌ماند. به تعویق انداختن polling پس از فعال‌سازی با
.B "\-\-poll n"
امکان‌پذیر است.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
یک نام مستعار برای
.B \-\-commandprofile
یا
.B \-\-metadataprofile
بسته به دستور مورد استفاده.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
خاموش کردن خروجی‌ها و پیام‌های گزارش‌گیری. این گزینه بر
.B \-\-debug
و
.B \-\-verbose
ارجحیت دارد. تکرار یک‌باره آن باعث می‌شود به تمام اعلان‌ها پاسخ خودکار 'no' داده شود.
.
.HP
\fB\-r\fP|\fB\-\-readahead\fP \fBauto\fP|\fBnone\fP|\fINumber\fP
.br
تنظیم تعداد سکتورهای پیش‌خوانی (read ahead) برای یک LV.
مقدار پیش‌فرض
.B auto
است که به هسته اجازه می‌دهد مقداری مناسب را به طور خودکار انتخاب کند.
مقدار
.B none
معادل صفر است.
.
.HP
\fB\-\-readonly\fP
.br
جلوگیری از اعمال تغییرات توسط دستور، شامل فعال‌سازی و به‌روزرسانی‌های متاداده (برای LVهای فقط‌خواندنی به
.B "\-\-permission r"
مراجعه فرمایید).
.
.HP
\fB\-\-rebuild\fP \fIPV\fP
.br
انتخاب یک PV برای بازسازی در یک RAID LV. با تکرار این گزینه می‌توان چندین PV را بازسازی کرد. زمانی که PVهای حاوی داده‌های آسیب‌دیده مشخص باشند، این گزینه به جای
.B \-\-resync
یا
.B "\-\-syncaction repair"
استفاده می‌شود تا داده‌های صحیح بازسازی شوند. به
.BR lvmraid (7)
مراجعه کنید.
.
.HP
\fB\-\-refresh\fP
.br
در صورت فعال بودن LV، متاداده‌های آن مجدداً بارگذاری می‌شوند. در محیطی که udev برای مدیریت محتوای
.I /dev
استفاده می‌شود، استفاده از این گزینه شدیداً توصیه می‌گردد؛ زیرا refresh رویدادهای udev را برای یک LV بازتولید می‌کند تا قواعد udev موجود برای تنظیم محتوا و مجوزهای
.I /dev
اعمال شوند. همچنین در صورت بروز اشکال یا استفاده از اشتراک‌گذاری دستی LV این عملیات بسیار کارآمد است.
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
قالب خروجی جاری را برای گزارش‌ها لغو می‌کند؛ قالبی که به صورت سراسری توسط تنظیم report/output_format در
.BR lvm.conf (5)
تعریف شده است.
مقدار
.B basic
قالب اصلی شامل سطرها و ستون‌هاست. مقدار
.B json
خروجی گزارش را در قالب JSON ارائه می‌دهد. مقدار
.B json_std
خروجی گزارش را در قالبی سازگارتر با استانداردهای رسمی JSON تولید می‌کند. به
.BR lvmreport (7)
مراجعه کنید.
.
.HP
\fB\-\-resync\fP
.br
آغاز همگام‌سازی مجدد mirror. همگام‌سازی معمولاً به صورت خودکار انجام می‌شود، اما این گزینه اجرای آن را اجباری می‌کند. همچنین برای همگام‌سازی یک PV مشخص به
.B \-\-rebuild
مراجعه کنید. در طول همگام‌سازی، داده‌ها از دستگاه آینه‌ای اصلی خوانده شده و روی سایر دستگاه‌ها کپی می‌شوند. این فرایند ممکن است زمان قابل توجهی ببرد و در این مدت LV فاقد نسخه پشتیبان کامل خواهد بود. به
.BR lvmraid (7)
مراجعه کنید.
.
.HP
\fB\-S\fP|\fB\-\-select\fP \fIString\fP
.br
انتخاب اشیاء برای پردازش و گزارش‌گیری بر اساس معیارهای مشخص‌شده. ساختار این معیارها در
.B "\-\-select help"
و
.BR lvmreport (7)
شرح داده شده است. برای دستورهای غیرگزارشی، این انتخاب برای تعیین موارد پردازش به کار می‌رود.
.
.HP
\fB\-k\fP|\fB\-\-setactivationskip\fP \fBy\fP|\fBn\fP
.br
تنظیم (yes) یا پاک کردن (no) دائمی پرچم "activation skip" روی یک LV. یک LV با این پرچم فعال نخواهد شد مگر آنکه از گزینه
.B \-\-ignoreactivationskip
در دستور فعال‌سازی استفاده شود. این پرچم به طور پیش‌فرض روی اسنپ‌شات‌های نازک جدید تنظیم می‌گردد و بر غیرفعال‌سازی تاثیری ندارد. مقدار جاری این پرچم در بیت‌های lv_attr دستور lvs مشخص است.
.
.HP
\fB\-\-setautoactivation\fP \fBy\fP|\fBn\fP
.br
تنظیم ویژگی فعال‌سازی خودکار (autoactivation) روی یک VG یا LV.
نمایش این ویژگی با
.B "vgs -o autoactivation"
یا
.B "lvs -o autoactivation"
امکان‌پذیر است.
هنگامی که این ویژگی غیرفعال باشد، VG یا LV توسط دستوری که فعال‌سازی خودکار را انجام می‌دهد (مانند vgchange، lvchange یا pvscan با سوییچ \-aay) فعال نخواهد شد.
اگر فعال‌سازی خودکار روی یک VG غیرفعال شود، هیچ LV درون آن فعال خودکار نخواهد شد و ویژگی فعال‌سازی خودکار LV تاثیری ندارد. در صورت فعال بودن آن روی VG، می‌توان آن را برای تک‌تک LVها غیرفعال کرد.
.
.HP
\fB\-\-\fP[\fBraid\fP]\fBsyncaction\fP \fBcheck\fP|\fBrepair\fP
.br
آغاز انواع مختلف همگام‌سازی RAID. این کار باعث می‌شود RAID LV تمام بلوک‌های داده و توازن (parity) را در آرایه خوانده و عدم تطابق‌ها را بررسی کند.
مقدار
.B check
اختلافات را شمارش می‌کند اما اصلاحی انجام نمی‌دهد.
مقدار
.B repair
عدم تطابق‌ها و خطاها را اصلاح می‌کند.
توجه داشته باشید که این اقدامات همگام‌سازی گذرا هستند و پس از خرابی/راه‌اندازی مجدد سیستم یا تغییر پیکربندی RaidLV باید مجدداً راه‌اندازی شوند. برای مشاهده گزارش اختلافات به
.BR lvs (8)
مراجعه کنید.
.
.HP
\fB\-\-sysinit\fP
.br
نشان‌دهنده آن است که vgchange/lvchange از اسکریپت‌های اولیه راه‌اندازی سیستم (مانند rc.sysinit یا یک initrd) و پیش از در دسترس بودن سیستم‌های فایل قابل نوشتن اجرا می‌شود. از این رو برخی عملکردها باید غیرفعال شوند و این گزینه به عنوان یک میانبر برای انتخاب مجموعه‌ای از گزینه‌های مناسب عمل می‌کند (معادل
.BR \-\-ignorelockingfailure ،
.BR \-\-ignoremonitoring ،
.B "\-\-poll n"
و تنظیم متغیر محیطی LVM_SUPPRESS_LOCKING_FAILURE_MESSAGES).
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی. در این حالت هیچ تغییری در متاداده ثبت نمی‌شود. این کار با غیرفعال کردن تمامی عملیات نوشتن متاداده اما بازگرداندن وضعیت موفقیت به تابع فراخواننده صورت می‌پذیرد.
.
.HP
\fB\-\-vdosettings\fP \fIString\fP
.br
تعیین گزینه‌های تنظیمی VDO برای LVهای VDO. از فرمت 'option=value' یا تکرار
.B \-\-vdosettings
استفاده کنید. این تنظیمات رفتارهای پیش‌فرض VDO را لغو می‌کنند. برای بازگشت به تنظیمات پیش‌فرض از مقدار 'default' استفاده نمایید. برای اطلاعات بیشتر به
.BR lvmvdo (7)
مراجعه کنید.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی (verbose). تکرار از ۱ تا ۴ بار برای افزایش جزئیات پیام‌های ارسالی به stdout و stderr.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه LVM.
.
.HP
\fB\-\-\fP[\fBraid\fP]\fBwritebehind\fP \fINumber\fP
.br
حداکثر تعداد عملیات نوشتن معلق مجاز به دستگاه‌ها در یک RAID1 LV که به عنوان write-mostly نشانه‌گذاری شده‌اند. پس از تجاوز از این مقدار، نوشتن‌ها همگام خواهند شد. مقدار صفر ترجیح را پاک کرده و به سیستم اجازه انتخاب دلخواه را می‌دهد.
.
.HP
\fB\-\-\fP[\fBraid\fP]\fBwritemostly\fP \fIPV\fP[\fB:t\fP|\fBn\fP|\fBy\fP]
.br
نشانه‌گذاری یک دستگاه در RAID1 LV به عنوان write-mostly. از تمامی خواندن‌ها از این درایوها به جز در موارد بسیار ضروری خودداری می‌شود تا تعداد I/O درایو به حداقل برسد. رفتار پیش‌فرض اعمال ویژگی write-mostly برای PV مشخص‌شده است. همچنین با افزودن پسوند
.B :n
به انتهای نام PV می‌توان این ویژگی را حذف کرد یا با پسوند
.B :t
وضعیت آن را معکوس نمود. تکرار این گزینه روی چندین PV مجاز است.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تایید تعاملی و در نظر گرفتن همیشگی پاسخ بله (yes). با احتیاط بسیار شدید استفاده شود (برای پاسخ منفی خودکار،
.B \-qq
را ببینید).
.
.HP
\fB\-Z\fP|\fB\-\-zero\fP \fBy\fP|\fBn\fP
.br
تنظیم حالت صفر کردن برای استخر نازک (thin pool). نکته: بلوک‌های از پیش تخصیص‌یافته استخر در حالت غیرصفر، هنگام تنظیم
.B "\-\-zero y"
در بخش‌های نوشته‌نشده پاک نمی‌شوند.
.
.SH "متغیرها (VARIABLES)"
.TP
.I VG
نام گروه حجم (Volume Group). برای نام‌های معتبر به
.BR lvm (8)
مراجعه کنید.
.TP
.I LV
نام حجم منطقی (Logical Volume). برای نام‌های معتبر به
.BR lvm (8)
مراجعه کنید. یک آرگومان مکانی LV معمولاً شامل نام VG و نام LV است، مانند VG/LV. مقدار LV1 نشان می‌دهد که LV باید نوع خاصی داشته باشد (مانند raid یا mirror).
.TP
.I Tag
نام برچسب (تگ). برای اطلاعات در مورد نام برچسب‌ها و استفاده از آن‌ها به جای VG، LV یا PV به
.BR lvm (8)
مراجعه کنید.
.TP
.I Select
نشان می‌دهد که در صورت استفاده از گزینه
.B \-\-select
می‌توان پارامتر مکانی اجباری را حذف کرد. هیچ آرگومانی در این موقعیت قرار نمی‌گیرد.
.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).
(این مورد نباید با کنترل خروجی
.B \-\-units
اشتباه گرفته شود که در آن حروف بزرگ نشان‌دهنده مضارب ۱۰۰۰ هستند.)
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
برای اطلاعات درباره متغیرهای محیطی مورد استفاده توسط lvm به
.BR lvm (8)
مراجعه کنید. برای نمونه، معمولاً می‌توان از متغیر محیطی LVM_VG_NAME به جای پارامتر اجباری VG استفاده کرد.
.
.SH "مثال‌ها (EXAMPLES)"
تغییر دسترسی حجم منطقی به فقط‌خواندنی:
.PP
.nf
# lvchange \-pr vg00/lvol1
.fi
.
.SH "همچنین ببینید (SEE ALSO)"
.nh
.na
.BR lvm (8),
.BR lvm.conf (5),
.BR lvmconfig (8),
.BR lvmdevices (8),
.PP
.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),
.PP
.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),
.PP
.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),
.PP
.BR lvm\-fullreport (8),
.BR lvm\-lvpoll (8),
.BR blkdeactivate (8),
.BR lvmdump (8),
.PP
.BR dmeventd (8),
.BR lvmpolld (8),
.BR lvmlockd (8),
.BR lvmlockctl (8),
.BR cmirrord (8),
.BR lvmdbusd (8),
.BR fsadm (8),
.PP
.BR lvmsystemid (7),
.BR lvmreport (7),
.BR lvmcache (7),
.BR lvmraid (7),
.BR lvmthin (7),
.BR lvmvdo (7),
.BR lvmautoactivation (7)