.TH "LVMCONFIG" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
lvmconfig \- نمایش و مدیریت تنظیمات پیکربندی LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBlvmconfig\fP [\fIگزینه‌ها\fR]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBlvmconfig\fR یک خروجی ساختاریافته از تعاریف و مقادیر درخت پیکربندی LVM تولید می‌کند.
.PP
دستورهای
.BR lvmconfig ،
.B lvm config
و
.B lvm dumpconfig
(به دلایل سازگاری قبلی موجود است و در آینده حذف خواهد شد) خروجی قالب‌بندی‌شده‌ای از درخت پیکربندی LVM ایجاد می‌کنند. منابع داده‌های پیکربندی شامل
.BR lvm.conf (5)
و تنظیمات خط فرمان ارائه‌شده با
.B \-\-config
هستند.
.
.SH "نحوه استفاده (USAGE)"
.
\fBlvmconfig\fP
.br
.RS 4
.na
[ \fB\-f\fP|\fB\-\-file\fP \fIString\fP ]
.br
[ \fB\-l\fP|\fB\-\-list\fP ]
.br
[    \fB\-\-atversion\fP \fIString\fP ]
.br
[    \fB\-\-typeconfig\fP \c
.nh
\%\fBcurrent\fP|\:\fBdefault\fP|\:\fBdiff\fP|\:\fBfull\fP|\:\fBlist\fP|\:\fBmissing\fP|\:\fBnew\fP|\:\fBprofilable\fP|\:\fBprofilable\-command\fP|\:\fBprofilable\-metadata\fP
.hy
]
.br
[    \fB\-\-ignoreadvanced\fP ]
.br
[    \fB\-\-ignoreunsupported\fP ]
.br
[    \fB\-\-ignorelocal\fP ]
.br
[    \fB\-\-mergedconfig\fP ]
.br
[    \fB\-\-metadataprofile\fP \fIString\fP ]
.br
[    \fB\-\-sinceversion\fP \fIString\fP ]
.br
[    \fB\-\-showdeprecated\fP ]
.br
[    \fB\-\-showunsupported\fP ]
.br
[    \fB\-\-validate\fP ]
.br
[    \fB\-\-valuesonly\fP ]
.br
[    \fB\-\-withsummary\fP ]
.br
[    \fB\-\-withcomments\fP ]
.br
[    \fB\-\-withgeneralpreamble\fP ]
.br
[    \fB\-\-withlocalpreamble\fP ]
.br
[    \fB\-\-withspaces\fP ]
.br
[    \fB\-\-unconfigured\fP ]
.br
[    \fB\-\-withversions\fP ]
.br
[ COMMON_OPTIONS ]
.ad
.RE
.RS 4
[ \fIString\fP ... ]
.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\-\-atversion\fP \fIString\fP
.br
تعیین نسخه LVM در قالب x.y.z که در آن x نسخه اصلی، y نسخه فرعی و z سطح وصله است (برای نمونه 2.2.106). هنگام نمایش پیکربندی، تنها تنظیمات پیکربندی شناخته‌شده در این نسخه از LVM در نظر گرفته خواهند شد. این گزینه می‌تواند برای نمایش پیکربندی‌ای استفاده شود که نسخه مشخصی از LVM آن را درک می‌کند و فاقد هرگونه تنظیمات جدیدتری است که LVM هنگام بررسی پیکربندی درباره آن‌ها پیام هشدار صادر کند.
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
پروفایل دستور مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره پروفایل‌ها به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور. این مقادیر تنظیمات
.BR lvm.conf (5)
را بازنویسی می‌کنند. آرگومان رشته‌ای از همان قالب
.BR lvm.conf (5)
استفاده می‌کند، یا می‌تواند ساختار بخش/فیلد (section/field) داشته باشد. برای اطلاعات بیشتر درباره پیکربندی به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی. برای افزایش جزئیات پیام‌های ارسالی به فایل لاگ و/یا syslog (در صورت پیکربندی)، از ۱ تا ۶ بار تکرار کنید.
.
.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\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
اگر روی no تنظیم شود، دستور تلاش نخواهد کرد از دیسک‌نگار (device-mapper) استفاده کند. برای مقاصد آزمایشی و اشکال‌زدایی کاربرد دارد.
.
.HP
\fB\-f\fP|\fB\-\-file\fP \fIString\fP
.br
نوشتن خروجی در فایل مشخص‌شده.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-ignoreadvanced\fP
.br
حذف تنظیمات پیکربندی پیشرفته از خروجی.
.
.HP
\fB\-\-ignorelocal\fP
.br
نادیده گرفتن بخش local. بخش local باید در فایل lvmlocal.conf تعریف شود و حاوی تنظیمات پیکربندی مختص میزبان محلی باشد که نباید به سایر میزبان‌ها کپی شوند.
.
.HP
\fB\-\-ignoreunsupported\fP
.br
حذف تنظیمات پیکربندی پشتیبانی‌نشده از خروجی. این تنظیمات یا صرفاً برای مقاصد اشکال‌زدایی و توسعه به کار می‌روند یا پشتیبانی از آن‌ها هنوز کامل نبوده و برای محیط‌های عملیاتی در نظر گرفته نشده‌اند. انواع
.B current
و
.B diff
تنظیمات پشتیبانی‌نشده را به طور پیش‌فرض در خروجی می‌گنجانند، اما سایر انواع، آن‌ها را نادیده می‌گیرند.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعات فعال‌شده با تنظیم log/journal در lvm.conf است.
.br
.B command :
ثبت اطلاعات مربوط به دستور.
.br
.B output :
ثبت خروجی پیش‌فرض دستور.
.br
.B debug :
ثبت اطلاعات کامل اشکال‌زدایی دستور.
.
.HP
\fB\-l\fP|\fB\-\-list\fP
.br
فهرست کردن تنظیمات پیکربندی همراه با یادداشت توضیحی خلاصه. این کار معادل استفاده از گزینه‌های
.B \-\-typeconfig list \-\-withsummary
است.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌های موارد خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به
.BR lvmlockd (8)
مراجعه کنید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن کامل و طولانی راهنما.
.
.HP
\fB\-\-mergedconfig\fP
.br
هنگامی که دستور با
.B \-\-config
و/یا
.B \-\-commandprofile
(یا با استفاده از متغیر محیطی LVM_COMMAND_PROFILE)،
.B \-\-profile
یا
.B \-\-metadataprofile
اجرا می‌شود، تمام محتویات «آبشار پیکربندی» را پیش از نمایش با یکدیگر ادغام می‌کند. بدون ادغام، تنها پیکربندی ابتدای آبشار نمایش داده می‌شود. برای اطلاعات بیشتر درباره پیکربندی به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-\-metadataprofile\fP \fIString\fP
.br
پروفایل فراداده مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره پروفایل‌ها به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنماها (hints) برای یافتن دستگاه‌های مربوط به PVها. در صورت عدم استفاده از نکات، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها بررسی کند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در زمان‌های مناسب انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات هم‌روند ممکن است نتایج نادرستی ایجاد کنند.
.
.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\-\-showdeprecated\fP
.br
گنجاندن تنظیمات پیکربندی منسوخ‌شده در خروجی. این تنظیمات پس از نسخه خاصی منسوخ شده‌اند. اگر یک نسخه مشخص با
.B \-\-atversion
تعیین شده باشد، در صورتی که نسخه تعیین‌شده پایین‌تر از نسخه‌ای باشد که تنظیمات در آن منسوخ شده‌اند، تنظیمات منسوخ به طور خودکار اضافه می‌شوند. انواع current و diff تنظیمات منسوخ را به طور پیش‌فرض در خروجی قرار می‌دهند، اما همه انواع دیگر، تنظیمات منسوخ را نادیده می‌گیرند.
.
.HP
\fB\-\-showunsupported\fP
.br
گنجاندن تنظیمات پیکربندی پشتیبانی‌نشده در خروجی. این تنظیمات یا صرفاً برای مقاصد اشکال‌زدایی یا توسعه به کار می‌روند یا پشتیبانی آن‌ها هنوز کامل نشده و مناسب محیط عملیاتی نیستند. انواع current و diff تنظیمات پشتیبانی‌نشده را به طور پیش‌فرض در خروجی می‌آورند، در حالی که همه انواع دیگر این تنظیمات را نادیده می‌گیرند.
.
.HP
\fB\-\-sinceversion\fP \fIString\fP
.br
تعیین نسخه LVM در قالب x.y.z که در آن x نسخه اصلی، y نسخه فرعی و z سطح وصله است (مانند 2.2.106). این گزینه در حال حاضر تنها با
.B \-\-typeconfig new
برای نمایش تمام تنظیمات پیکربندی معرفی‌شده از نسخه مشخص‌شده کاربرد دارد.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی (تست). دستورات فراداده‌ها را به‌روزرسانی نخواهند کرد. این ویژگی با غیرفعال کردن تمامی عملیات نوشتن فراداده و با این حال بازگرداندن وضعیت موفقیت‌آمیز به تابع فراخواننده پیاده‌سازی شده است. این امر در عملیات چندمرحله‌ای ممکن است منجر به پیام‌های خطای غیرمعمول شود، چنانچه ابزاری متکی به خواندن مجدد فراداده‌ای باشد که تصور می‌کند تغییر کرده اما در واقع تغییری نکرده است.
.
.HP
.ad
\fB\-\-typeconfig\fP \c
.nh
\%\fBcurrent\fP|\:\fBdefault\fP|\:\fBdiff\fP|\:\fBfull\fP|\:\fBlist\fP|\:\fBmissing\fP|\:\fBnew\fP|\:\fBprofilable\fP|\:\fBprofilable\-command\fP|\:\fBprofilable\-metadata\fP
.hy
.ad
.br
\fBcurrent\fP تنظیمات پیکربندی‌ای را چاپ می‌کند که روی یک دستور lvm اعمال خواهند شد (با فرض اینکه دستور آن‌ها را در خط فرمان لغو نکند). این شامل موارد زیر است:
تنظیماتی که در فایل‌های پیکربندی lvm تغییر یافته‌اند،
تنظیماتی که مقادیر پیش‌فرض خود را از فایل‌های پیکربندی دریافت می‌کنند،
و تنظیمات پیش‌فرضی که در فایل‌های پیکربندی از حالت توضیح (کامنت) خارج شده‌اند.
.br
\fBdefault\fP تمام تنظیمات را با مقادیر پیش‌فرض آن‌ها چاپ می‌کند.
تغییرات ایجادشده در فایل‌های پیکربندی lvm در خروجی اعمال نمی‌شوند.
برخی تنظیمات مقادیر پیش‌فرض خود را به صورت داخلی دریافت می‌کنند،
و این تنظیمات به صورت کامنت چاپ می‌شوند.
سایر تنظیمات مقادیر پیش‌فرض خود را از فایل‌های پیکربندی می‌گیرند،
و این تنظیمات به عنوان کامنت چاپ نمی‌شوند.
.br
\fBdiff\fP تنها تنظیمات پیکربندی‌ای را چاپ می‌کند که نسبت به مقادیر پیش‌فرض خود در فایل‌های پیکربندی تغییر کرده‌اند (تفاوت میان current و default).
.br
\fBfull\fP تمام تنظیمات را بدون کامنت و با مقدار فعلی چاپ می‌کند، یعنی همان‌گونه که توسط یک دستور lvm مورد استفاده قرار می‌گیرد.
این شامل تنظیمات تغییریافته در فایل‌های پیکربندی، تنظیماتی که معمولاً پیش‌فرض‌ها را به صورت داخلی دریافت می‌کنند، و تنظیماتی است که پیش‌فرض‌ها را از فایل‌های پیکربندی می‌گیرند.
.br
\fBlist\fP تمام نام‌های پیکربندی را بدون مقادیر چاپ می‌کند.
.br
\fBmissing\fP تنظیماتی را که در فایل‌های پیکربندی lvm وجود ندارند چاپ می‌کند.
تنظیمی که معمولاً پیش‌فرض خود را از فایل‌های پیکربندی دریافت می‌کند، به صورت غیرکامنت و با مقدار پیش‌فرض داخلی چاپ می‌شود.
تنظیماتی که پیش‌فرض خود را به صورت داخلی می‌گیرند و در فایل‌های پیکربندی تعیین نشده‌اند، با پیش‌فرض داخلی و به صورت کامنت چاپ می‌شوند.
.br
\fBnew\fP تنظیمات پیکربندی اضافه شده پس از نسخه LVM تعیین‌شده با
.B \-\-sinceversion
را چاپ می‌کند. این تنظیمات با مقادیر پیش‌فرض خود چاپ می‌شوند.
.br
\fBprofilable\fP تنظیمات را با مقادیر پیش‌فرض آن‌ها که قابل تنظیم از طریق پروفایل هستند چاپ می‌کند.
.br
\fBprofilable\-command\fP تنظیمات را با مقادیر پیش‌فرض آن‌ها که قابل تنظیم از طریق پروفایل دستور هستند چاپ می‌کند.
.br
\fBprofilable\-metadata\fP تنظیمات را با مقادیر پیش‌فرض آن‌ها که قابل تنظیم از طریق پروفایل فراداده هستند چاپ می‌کند.
.br
همچنین به
.BR lvm.conf (5)
مراجعه کنید.
.
.HP
\fB\-\-unconfigured\fP
.br
گزینه داخلی مورد استفاده برای تولید فایل پیکربندی هنگام ساخت.
.
.HP
\fB\-\-validate\fP
.br
اعتبارسنجی پیکربندی فعلی مورد استفاده و خروج با کد وضعیت مناسب. اعتبارسنجی تنها برای پیکربندی در ابتدای «آبشار پیکربندی» انجام می‌شود. برای اعتبارسنجی کل درخت پیکربندی ادغام‌شده، از
.B \-\-mergedconfig
نیز استفاده کنید. اعتبارسنجی حتی در صورت غیرفعال بودن
.B config/checks
در
.BR lvm.conf (5)
انجام می‌پذیرد.
.
.HP
\fB\-\-valuesonly\fP
.br
هنگام چاپ تنظیمات پیکربندی، تنها مقادیر بدون کلیدها چاپ می‌شوند.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی (verbose). برای افزایش جزئیات پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد، از ۱ تا ۴ بار تکرار کنید.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه برنامه.
.
.HP
\fB\-\-withcomments\fP
.br
نمایش یک یادداشت توضیحی کامل برای هر گره پیکربندی. برای تنظیمات منسوخ‌شده، توضیحات مربوط به منسوخ شدن را نیز نمایش می‌دهد.
.
.HP
\fB\-\-withgeneralpreamble\fP
.br
گنجاندن دیباچه عمومی فایل پیکربندی.
.
.HP
\fB\-\-withlocalpreamble\fP
.br
گنجاندن دیباچه محلی فایل پیکربندی.
.
.HP
\fB\-\-withspaces\fP
.br
در صورت لزوم، افزودن فاصله‌های بیشتر در خروجی برای خوانایی بهتر.
.
.HP
\fB\-\-withsummary\fP
.br
نمایش یک خط یادداشت توضیحی خلاصه برای هر گره پیکربندی.
.
.HP
\fB\-\-withversions\fP
.br
همچنین نمایش یک یادداشت حاوی نسخه معرفی برای هر گره پیکربندی. در صورت منسوخ بودن تنظیم، نسخه‌ای که از آن زمان منسوخ شده نیز نمایش داده می‌شود.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تایید به صورت تعاملی و در نظر گرفتن همیشگی پاسخ «بله». با احتیاط بسیار بالا استفاده شود. (برای «خیر» خودکار، به
.B \-qq
مراجعه کنید).
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I String
برای کسب اطلاعات درباره محتوای رشته به توضیحات گزینه مورد نظر مراجعه کنید.
.TP
.IR Size [UNIT]
اندازه (Size) یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد. واحدهای ورودی بدون توجه به بزرگی یا کوچکی حروف، همواره مقادیر در مبنای دو در نظر گرفته می‌شوند؛ به عنوان نمونه، هر دو '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 "همچنین ببینید (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)