نام (NAME)

lvmconfig - نمایش و مدیریت تنظیمات پیکربندی LVM

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

lvmconfig [گزینه‌ها]

توضیحات (DESCRIPTION)

دستور lvmconfig یک خروجی ساختاریافته از تعاریف و مقادیر درخت پیکربندی LVM تولید می‌کند.

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

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

lvmconfig

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

گزینه‌ها (OPTIONS)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

--longhelp
نمایش متن کامل و طولانی راهنما.

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

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

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

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

--profile String
نام مستعار برای --commandprofile یا --metadataprofile بسته به نوع دستور.

-q|--quiet ...
سرکوب خروجی و پیام‌های لاگ. بر گزینه‌های --debug و --verbose اولویت دارد. برای سرکوب هرگونه پیام تعاملی تایید با پاسخ پیش‌فرض «no»، این گزینه را دوباره تکرار کنید.

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

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

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

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

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

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

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

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

-v|--verbose ...
تنظیم سطح پرگویی (verbose). برای افزایش جزئیات پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد، از ۱ تا ۴ بار تکرار کنید.

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

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

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

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

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

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

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

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

متغیرها (VARIABLES)

String

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

Size[UNIT]

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