.TH "LVM-DUMPCONFIG" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
lvm-dumpconfig \- استخراج و نمایش ساختار کامل تنظیمات پیکربندی LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBlvm dumpconfig\fP [\fIگزینهها\fR]
.
.SH "توضیحات (DESCRIPTION)"
دستور سازگاری \fBlvm dumpconfig\fR (که مترادف lvmconfig است) برای استخراج تنظیمات پیکربندی LVM به کار میرود.
دستورهای lvmconfig، lvm config و lvm dumpconfig (به دلایل سازگاری نگهداری شده و در آینده حذف خواهند شد) خروجی قالب‌بندی‌شده‌ای از درخت پیکربندی LVM تولید می‌کنند. منابع داده‌های پیکربندی شامل \fBlvm.conf\fP(5) و تنظیمات خط فرمان ارائه‌شده توسط \fB\-\-config\fP هستند.
.
.SH "نحوه استفاده (USAGE)"
.
\fBlvm dumpconfig\fP
.br
.RS 4
.na
[ \fB\-f\fP|\fB\-\-file\fP \fIرشته\fP ]
.br
[ \fB\-l\fP|\fB\-\-list\fP ]
.br
[    \fB\-\-atversion\fP \fIرشته\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 \fIرشته\fP ]
.br
[    \fB\-\-sinceversion\fP \fIرشته\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
[ گزینه‌های_عمومی ]
.ad
.RE
.RS 4
[ \fIرشته\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 \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\-\-atversion\fP \fIرشته\fP
.br
مشخص کردن یک نسخه LVM در قالب x.y.z که در آن x نسخه اصلی، y نسخه فرعی و z سطح وصله (مانند 2.2.106) است. هنگام نمایش پیکربندی، تنها تنظیماتی در نظر گرفته می‌شوند که در این نسخه از LVM شناخته شده‌اند. این گزینه می‌تواند برای نمایش پیکربندی‌ای استفاده شود که نسخه مشخصی از LVM آن را درک می‌کند و فاقد تنظیمات جدیدتری است که LVM هنگام بررسی پیکربندی درباره آن‌ها هشدار صادر می‌کند.
.
.HP
\fB\-\-commandprofile\fP \fIرشته\fP
.br
پروفایل فرمانی که برای پیکربندی دستور استفاده می‌شود. برای کسب اطلاعات بیشتر درباره پروفایل‌ها به \fBlvm.conf\fP(5) مراجعه کنید.
.
.HP
\fB\-\-config\fP \fIرشته\fP
.br
تنظیمات پیکربندی برای دستور. این مقادیر بر تنظیمات \fBlvm.conf\fP(5) اولویت دارند. آرگومان رشته از همان قالب \fBlvm.conf\fP(5) یا از نحو section/field استفاده می‌کند. برای اطلاعات بیشتر درباره پیکربندی به \fBlvm.conf\fP(5) مراجعه فرمایید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تعیین سطح اشکال‌زدایی. تکرار از ۱ تا ۶ بار جهت افزایش جزئیات پیام‌های ارسالی به فایل لاگ و/یا syslog (در صورت پیکربندی شدن).
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
محدود کردن دستگاه‌هایی که برای دستور قابل مشاهده و دسترسی هستند. دستگاه‌هایی که در فهرست نباشند ناموجود در نظر گرفته می‌شوند. این گزینه می‌تواند تکرار شود یا فهرستی از دستگاه‌ها با کاما جدا شده دریافت کند. این گزینه بر فایل دستگاه‌ها ارجحیت دارد.
.
.HP
\fB\-\-devicesfile\fP \fIرشته\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
اگر برابر با n تنظیم شود، دستور تلاش نخواهد کرد از درایور device-mapper استفاده کند. برای اهداف آزمایش و اشکال‌زدایی.
.
.HP
\fB\-f\fP|\fB\-\-file\fP \fIرشته\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
حذف تنظیمات پیکربندی پشتیبانی‌نشده از خروجی. این تنظیمات یا صرفاً برای مقاصد اشکال‌زدایی و توسعه استفاده می‌شوند، یا پشتیبانی از آن‌ها کامل نشده و برای استفاده در محیط عملیاتی در نظر گرفته نشده‌اند. انواع پیکربندی \fBcurrent\fP و \fBdiff\fP به طور پیش‌فرض شامل این تنظیمات هستند، اما تمامی انواع دیگر آن‌ها را نادیده می‌گیرند.
.
.HP
\fB\-\-journal\fP \fIرشته\fP
.br
ثبت اطلاعات در ژورنال سیستم (systemd journal). این اطلاعات علاوه بر اطلاعاتی است که توسط تنظیم log/journal در lvm.conf فعال می‌شود.
مقادیر مجاز عبارتند از:
command برای ثبت اطلاعات درباره دستور،
output برای ثبت خروجی پیش‌فرض دستور،
debug برای ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-l\fP|\fB\-\-list\fP
.br
فهرست کردن تنظیمات پیکربندی همراه با کامنت توضیحی خلاصه. این گزینه دقیقاً معادل استفاده همزمان از گزینه‌های \fB\-\-typeconfig list \-\-withsummary\fP است.
.
.HP
\fB\-\-lockopt\fP \fIرشته\fP
.br
جهت ارسال گزینه‌ها برای موارد ویژه به lvmlockd به کار می‌رود. برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن بلند و جامع راهنما.
.
.HP
\fB\-\-mergedconfig\fP
.br
هنگامی که دستور همراه با \fB\-\-config\fP و/یا \fB\-\-commandprofile\fP (یا متغیر محیطی LVM_COMMAND_PROFILE)، \fB\-\-profile\fP یا \fB\-\-metadataprofile\fP اجرا شود، تمام محتویات زنجیره پیکربندی (config cascade) پیش از نمایش با یکدیگر ادغام می‌شوند. بدون ادغام، تنها پیکربندی ابتدای زنجیره نمایش داده می‌شود. برای اطلاعات بیشتر به \fBlvm.conf\fP(5) مراجعه کنید.
.
.HP
\fB\-\-metadataprofile\fP \fIرشته\fP
.br
پروفایل متادیتا جهت استفاده در پیکربندی دستور. برای توضیحات بیشتر درباره پروفایل‌ها به \fBlvm.conf\fP(5) رجوع نمایید.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل سرنخ‌ها (hints file) جهت مکان‌یابی دستگاه‌ها برای یافتن PVها. در صورت عدم استفاده از سرنخ‌ها، دستور ممکن است دستگاه‌های بیشتری را جستجو کند. دستور همچنان ابطال استاندارد فایل سرنخ را در شرایط لازم اجرا خواهد کرد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال‌سازی قفل‌گذاری. با احتیاط استفاده شود؛ اجرای همزمان دستورات ممکن است نتایج نادرستی ایجاد نماید.
.
.HP
\fB\-\-profile\fP \fIرشته\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\-\-showdeprecated\fP
.br
گنجاندن تنظیمات پیکربندی منسوخ‌شده در خروجی. این تنظیمات پس از نسخه خاصی منسوخ شده‌اند. اگر نسخه‌ای با \fB\-\-atversion\fP تعیین شود، در صورتی که نسخه ارائه‌شده کمتر از نسخه‌ای باشد که تنظیم در آن منسوخ گردیده، تنظیمات منسوخ به صورت خودکار لحاظ می‌شوند. انواع current و diff به طور پیش‌فرض شامل این تنظیمات هستند، اما سایر انواع از آن‌ها صرف‌نظر می‌کنند.
.
.HP
\fB\-\-showunsupported\fP
.br
گنجاندن تنظیمات پیکربندی پشتیبانی‌نشده در خروجی. این تنظیمات یا فقط برای اهداف اشکال‌زدایی یا توسعه به کار می‌روند، یا پشتیبانی آن‌ها کامل نبوده و برای استفاده در محیط‌های عملیاتی مناسب نیستند. انواع current و diff به طور پیش‌فرض این تنظیمات را شامل می‌شوند و سایر انواع آن‌ها را نادیده می‌گیرند.
.
.HP
\fB\-\-sinceversion\fP \fIرشته\fP
.br
تعیین نسخه LVM در قالب x.y.z که در آن x نسخه اصلی، y نسخه فرعی و z شماره وصله است (مانند 2.2.106). این گزینه در حال حاضر تنها به همراه \fB\-\-typeconfig new\fP برای نمایش تمامی تنظیمات پیکربندی اضافه‌شده از آن نسخه به بعد کاربرد دارد.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی (Test mode). دستورات متادیتا را تغییر نخواهند داد. این کار با غیرفعال کردن تمام عملیات نوشتن متادیتا اما بازگرداندن وضعیت موفقیت‌آمیز به برنامه پیاده‌سازی شده است. در عملیات‌های چندمرحله‌ای چنانچه ابزاری به بازخوانی متادیتایی اتکا کند که فرض شده تغییر کرده اما تغییر نیافته، ممکن است پیام‌های خطای نامعمولی تولید شود.
.
.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 ویرایش شده‌اند، تنظیماتی که مقادیر پیش‌فرض خود را از فایل‌های پیکربندی دریافت می‌کنند، و تنظیمات پیش‌فرضی که در فایل‌های پیکربندی از حالت کامنت خارج شده‌اند.
مقدار \fBdefault\fP تمامی تنظیمات را با مقادیر پیش‌فرض آن‌ها چاپ می‌کند. تغییرات ایجادشده در فایل‌های پیکربندی lvm در خروجی منعکس نمی‌شوند. برخی تنظیمات مقادیر پیش‌فرض خود را به صورت داخلی دریافت می‌کنند و این موارد به عنوان کامنت چاپ می‌شوند. سایر تنظیمات مقادیر پیش‌فرض را از فایل‌های پیکربندی می‌گیرند و بدون کامنت چاپ می‌گردند.
مقدار \fBdiff\fP تنها تنظیمات پیکربندی‌ای را چاپ می‌کند که مقادیر آن‌ها نسبت به پیش‌فرض در فایل‌های پیکربندی تغییر کرده است (تفاوت میان حالت جاری و پیش‌فرض).
مقدار \fBfull\fP تمام تنظیمات را بدون کامنت و تنظیم‌شده روی مقدار جاری چاپ می‌کند؛ یعنی به همان شکلی که توسط دستور lvm به کار گرفته می‌شود. این شامل تنظیمات تغییریافته در فایل‌ها، تنظیماتی که معمولاً پیش‌فرض را داخلی می‌گیرند و تنظیماتی است که پیش‌فرض را از فایل‌های پیکربندی دریافت می‌نمایند.
مقدار \fBlist\fP تمام نام‌های پیکربندی را بدون مقادیر چاپ می‌کند.
مقدار \fBmissing\fP تنظیماتی را چاپ می‌کند که در فایل‌های پیکربندی lvm وجود ندارند. یک تنظیم ناموجود که پیش‌فرض خود را از فایل پیکربندی دریافت می‌دارد، به صورت بدون کامنت با مقدار پیش‌فرض داخلی چاپ می‌شود. تنظیماتی که پیش‌فرض خود را داخلی دریافت می‌کنند و در فایل پیکربندی تنظیم نشده‌اند، با کامنت و مقدار پیش‌فرض داخلی چاپ می‌شوند.
مقدار \fBnew\fP تنظیماتی را چاپ می‌کند که پس از نسخه LVM تعیین‌شده در \fB\-\-sinceversion\fP اضافه شده‌اند. این تنظیمات با مقادیر پیش‌فرض چاپ می‌شوند.
مقدار \fBprofilable\fP تنظیماتی را با مقادیر پیش‌فرض چاپ می‌کند که می‌توان آن‌ها را از طریق یک پروفایل مشخص کرد.
مقدار \fBprofilable\-command\fP تنظیماتی را با مقادیر پیش‌فرض چاپ می‌کند که می‌توان از طریق پروفایل دستور تعیین نمود.
مقدار \fBprofilable\-metadata\fP تنظیماتی را با مقادیر پیش‌فرض چاپ می‌کند که می‌توان از طریق پروفایل متادیتا تعیین کرد.
همچنین \fBlvm.conf\fP(5) را ببینید.
.
.HP
\fB\-\-unconfigured\fP
.br
گزینه‌ای داخلی که برای تولید فایل پیکربندی هنگام ساخت نرم‌افزار استفاده می‌شود.
.
.HP
\fB\-\-validate\fP
.br
اعتبارسنجی پیکربندی جاری مورد استفاده و خروج با کد وضعیت مربوطه. اعتبارسنجی صرفاً برای پیکربندی ابتدای زنجیره (config cascade) انجام می‌پذیرد. جهت اعتبارسنجی کل درخت پیکربندی ادغام‌شده، از \fB\-\-mergedconfig\fP نیز استفاده فرمایید. این اعتبارسنجی حتی در صورتی که \fBconfig/checks\fP در \fBlvm.conf\fP(5) غیرفعال باشد انجام می‌گردد.
.
.HP
\fB\-\-valuesonly\fP
.br
هنگام چاپ تنظیمات، تنها مقادیر بدون کلیدها چاپ شوند.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تعیین سطح پرگویی گزارش‌ها. تکرار از ۱ تا ۴ بار جهت افزایش جزئیات پیام‌های ارسالی به stdout و stderr.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه نرم‌افزار.
.
.HP
\fB\-\-withcomments\fP
.br
نمایش کامنت کامل برای هر گره پیکربندی. برای تنظیمات منسوخ‌شده، توضیحات مربوط به منسوخ شدن نیز نمایش داده می‌شود.
.
.HP
\fB\-\-withgeneralpreamble\fP
.br
گنجاندن دیباچه عمومی (general preamble) فایل پیکربندی.
.
.HP
\fB\-\-withlocalpreamble\fP
.br
گنجاندن دیباچه محلی (local preamble) فایل پیکربندی.
.
.HP
\fB\-\-withspaces\fP
.br
در صورت نیاز، افزودن فاصله‌های بیشتر در خروجی جهت خوانایی بهتر.
.
.HP
\fB\-\-withsummary\fP
.br
نمایش یک خط کامنت توضیحی برای هر گره پیکربندی.
.
.HP
\fB\-\-withversions\fP
.br
نمایش کامنتی حاوی نسخه معرفی‌شده برای هر گره پیکربندی. اگر تنظیم منسوخ شده باشد، نسخه‌ای که از آن زمان منسوخ گردیده نیز نمایش داده خواهد شد.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم پرسش تعاملی برای تأیید عملیات و فرض همیشگی پاسخ مثبت «بله». با احتیاط بسیار شدید استفاده شود. (برای پاسخ منفی خودکار، گزینه \fB\-qq\fP را ببینید).
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I رشته
برای اطلاعات بیشتر درباره محتوای رشته به بخش توضیحات گزینه مراجعه فرمایید.
.TP
.IR اندازه [واحد]
اندازه (Size) یک عدد ورودی است که یک پسوند واحد اختیاری را می‌پذیرد. واحدهای ورودی بدون توجه به بزرگی یا کوچکی حروف همواره در مبنای دو در نظر گرفته می‌شوند؛ برای نمونه، 'k' و 'K' هر دو نشان‌دهنده ۱۰۲۴ هستند. واحد ورودی پیش‌فرض با یک حرف و پس از آن |واحد مشخص می‌شود.
واحد (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 به
.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)