نام (NAME)

lvm-dumpconfig - استخراج و نمایش ساختار کامل تنظیمات پیکربندی LVM

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

lvm dumpconfig [گزینهها]

توضیحات (DESCRIPTION)

دستور سازگاری lvm dumpconfig (که مترادف lvmconfig است) برای استخراج تنظیمات پیکربندی LVM به کار میرود. دستورهای lvmconfig، lvm config و lvm dumpconfig (به دلایل سازگاری نگهداری شده و در آینده حذف خواهند شد) خروجی قالب‌بندی‌شده‌ای از درخت پیکربندی LVM تولید می‌کنند. منابع داده‌های پیکربندی شامل lvm.conf(5) و تنظیمات خط فرمان ارائه‌شده توسط --config هستند.

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

lvm dumpconfig

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

گزینه‌ها (OPTIONS)

--atversion رشته
مشخص کردن یک نسخه LVM در قالب x.y.z که در آن x نسخه اصلی، y نسخه فرعی و z سطح وصله (مانند 2.2.106) است. هنگام نمایش پیکربندی، تنها تنظیماتی در نظر گرفته می‌شوند که در این نسخه از LVM شناخته شده‌اند. این گزینه می‌تواند برای نمایش پیکربندی‌ای استفاده شود که نسخه مشخصی از LVM آن را درک می‌کند و فاقد تنظیمات جدیدتری است که LVM هنگام بررسی پیکربندی درباره آن‌ها هشدار صادر می‌کند.

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

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

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

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

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

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

-f|--file رشته
نوشتن خروجی در فایل مشخص‌شده.

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

--ignoreadvanced
حذف تنظیمات پیکربندی پیشرفته از خروجی.

--ignorelocal
صرف‌نظر کردن از بخش محلی (local). بخش local باید در فایل lvmlocal.conf تعریف شده باشد و حاوی تنظیمات پیکربندی مربوط به میزبان محلی است که نباید به سایر میزبان‌ها منتقل شوند.

--ignoreunsupported
حذف تنظیمات پیکربندی پشتیبانی‌نشده از خروجی. این تنظیمات یا صرفاً برای مقاصد اشکال‌زدایی و توسعه استفاده می‌شوند، یا پشتیبانی از آن‌ها کامل نشده و برای استفاده در محیط عملیاتی در نظر گرفته نشده‌اند. انواع پیکربندی current و diff به طور پیش‌فرض شامل این تنظیمات هستند، اما تمامی انواع دیگر آن‌ها را نادیده می‌گیرند.

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

-l|--list
فهرست کردن تنظیمات پیکربندی همراه با کامنت توضیحی خلاصه. این گزینه دقیقاً معادل استفاده همزمان از گزینه‌های --typeconfig list --withsummary است.

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

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

--mergedconfig
هنگامی که دستور همراه با --config و/یا --commandprofile (یا متغیر محیطی LVM_COMMAND_PROFILE)، --profile یا --metadataprofile اجرا شود، تمام محتویات زنجیره پیکربندی (config cascade) پیش از نمایش با یکدیگر ادغام می‌شوند. بدون ادغام، تنها پیکربندی ابتدای زنجیره نمایش داده می‌شود. برای اطلاعات بیشتر به lvm.conf(5) مراجعه کنید.

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

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

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

--profile رشته
یک نام مستعار برای --commandprofile یا --metadataprofile بسته به دستور فراخوانده‌شده.

-q|--quiet ...
سرکوب خروجی و پیام‌های ثبت وقایع. این گزینه بر --debug و --verbose اولویت دارد. تکرار مجدد آن موجب سرکوب هرگونه اعلان تأیید تعاملی با پاسخ خودکار «خیر» (no) می‌شود.

--showdeprecated
گنجاندن تنظیمات پیکربندی منسوخ‌شده در خروجی. این تنظیمات پس از نسخه خاصی منسوخ شده‌اند. اگر نسخه‌ای با --atversion تعیین شود، در صورتی که نسخه ارائه‌شده کمتر از نسخه‌ای باشد که تنظیم در آن منسوخ گردیده، تنظیمات منسوخ به صورت خودکار لحاظ می‌شوند. انواع current و diff به طور پیش‌فرض شامل این تنظیمات هستند، اما سایر انواع از آن‌ها صرف‌نظر می‌کنند.

--showunsupported
گنجاندن تنظیمات پیکربندی پشتیبانی‌نشده در خروجی. این تنظیمات یا فقط برای اهداف اشکال‌زدایی یا توسعه به کار می‌روند، یا پشتیبانی آن‌ها کامل نبوده و برای استفاده در محیط‌های عملیاتی مناسب نیستند. انواع current و diff به طور پیش‌فرض این تنظیمات را شامل می‌شوند و سایر انواع آن‌ها را نادیده می‌گیرند.

--sinceversion رشته
تعیین نسخه LVM در قالب x.y.z که در آن x نسخه اصلی، y نسخه فرعی و z شماره وصله است (مانند 2.2.106). این گزینه در حال حاضر تنها به همراه --typeconfig new برای نمایش تمامی تنظیمات پیکربندی اضافه‌شده از آن نسخه به بعد کاربرد دارد.

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

--typeconfig current|default|diff|full|list|missing|new|profilable|profilable-command|profilable-metadata
مقدار current تنظیمات پیکربندی‌ای را چاپ می‌کند که به یک دستور lvm اعمال خواهد شد (با فرض اینکه دستور آن‌ها را در خط فرمان بازنویسی نکند). این شامل موارد زیر است: تنظیماتی که در فایل‌های پیکربندی lvm ویرایش شده‌اند، تنظیماتی که مقادیر پیش‌فرض خود را از فایل‌های پیکربندی دریافت می‌کنند، و تنظیمات پیش‌فرضی که در فایل‌های پیکربندی از حالت کامنت خارج شده‌اند. مقدار default تمامی تنظیمات را با مقادیر پیش‌فرض آن‌ها چاپ می‌کند. تغییرات ایجادشده در فایل‌های پیکربندی lvm در خروجی منعکس نمی‌شوند. برخی تنظیمات مقادیر پیش‌فرض خود را به صورت داخلی دریافت می‌کنند و این موارد به عنوان کامنت چاپ می‌شوند. سایر تنظیمات مقادیر پیش‌فرض را از فایل‌های پیکربندی می‌گیرند و بدون کامنت چاپ می‌گردند. مقدار diff تنها تنظیمات پیکربندی‌ای را چاپ می‌کند که مقادیر آن‌ها نسبت به پیش‌فرض در فایل‌های پیکربندی تغییر کرده است (تفاوت میان حالت جاری و پیش‌فرض). مقدار full تمام تنظیمات را بدون کامنت و تنظیم‌شده روی مقدار جاری چاپ می‌کند؛ یعنی به همان شکلی که توسط دستور lvm به کار گرفته می‌شود. این شامل تنظیمات تغییریافته در فایل‌ها، تنظیماتی که معمولاً پیش‌فرض را داخلی می‌گیرند و تنظیماتی است که پیش‌فرض را از فایل‌های پیکربندی دریافت می‌نمایند. مقدار list تمام نام‌های پیکربندی را بدون مقادیر چاپ می‌کند. مقدار missing تنظیماتی را چاپ می‌کند که در فایل‌های پیکربندی lvm وجود ندارند. یک تنظیم ناموجود که پیش‌فرض خود را از فایل پیکربندی دریافت می‌دارد، به صورت بدون کامنت با مقدار پیش‌فرض داخلی چاپ می‌شود. تنظیماتی که پیش‌فرض خود را داخلی دریافت می‌کنند و در فایل پیکربندی تنظیم نشده‌اند، با کامنت و مقدار پیش‌فرض داخلی چاپ می‌شوند. مقدار new تنظیماتی را چاپ می‌کند که پس از نسخه LVM تعیین‌شده در --sinceversion اضافه شده‌اند. این تنظیمات با مقادیر پیش‌فرض چاپ می‌شوند. مقدار profilable تنظیماتی را با مقادیر پیش‌فرض چاپ می‌کند که می‌توان آن‌ها را از طریق یک پروفایل مشخص کرد. مقدار profilable-command تنظیماتی را با مقادیر پیش‌فرض چاپ می‌کند که می‌توان از طریق پروفایل دستور تعیین نمود. مقدار profilable-metadata تنظیماتی را با مقادیر پیش‌فرض چاپ می‌کند که می‌توان از طریق پروفایل متادیتا تعیین کرد. همچنین lvm.conf(5) را ببینید.

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

--validate
اعتبارسنجی پیکربندی جاری مورد استفاده و خروج با کد وضعیت مربوطه. اعتبارسنجی صرفاً برای پیکربندی ابتدای زنجیره (config cascade) انجام می‌پذیرد. جهت اعتبارسنجی کل درخت پیکربندی ادغام‌شده، از --mergedconfig نیز استفاده فرمایید. این اعتبارسنجی حتی در صورتی که config/checks در lvm.conf(5) غیرفعال باشد انجام می‌گردد.

--valuesonly
هنگام چاپ تنظیمات، تنها مقادیر بدون کلیدها چاپ شوند.

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

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

--withcomments
نمایش کامنت کامل برای هر گره پیکربندی. برای تنظیمات منسوخ‌شده، توضیحات مربوط به منسوخ شدن نیز نمایش داده می‌شود.

--withgeneralpreamble
گنجاندن دیباچه عمومی (general preamble) فایل پیکربندی.

--withlocalpreamble
گنجاندن دیباچه محلی (local preamble) فایل پیکربندی.

--withspaces
در صورت نیاز، افزودن فاصله‌های بیشتر در خروجی جهت خوانایی بهتر.

--withsummary
نمایش یک خط کامنت توضیحی برای هر گره پیکربندی.

--withversions
نمایش کامنتی حاوی نسخه معرفی‌شده برای هر گره پیکربندی. اگر تنظیم منسوخ شده باشد، نسخه‌ای که از آن زمان منسوخ گردیده نیز نمایش داده خواهد شد.

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

متغیرها (VARIABLES)

رشته

برای اطلاعات بیشتر درباره محتوای رشته به بخش توضیحات گزینه مراجعه فرمایید.

اندازه[واحد]

اندازه (Size) یک عدد ورودی است که یک پسوند واحد اختیاری را می‌پذیرد. واحدهای ورودی بدون توجه به بزرگی یا کوچکی حروف همواره در مبنای دو در نظر گرفته می‌شوند؛ برای نمونه، 'k' و 'K' هر دو نشان‌دهنده ۱۰۲۴ هستند. واحد ورودی پیش‌فرض با یک حرف و پس از آن |واحد مشخص می‌شود. واحد (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 گردد.

همچنین ببینید (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)