نام (NAME)

lvm-config - نمایش و دستکاری اطلاعات پیکربندی LVM

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

lvm config [گزینه‌ها]

توضیحات (DESCRIPTION)

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

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

lvm config

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

گزینه‌ها (OPTIONS)

--atversion رشته
تعیین نسخه LVM در قالب x.y.z که در آن x نسخه اصلی (major)، y نسخه فرعی (minor) و z سطح وصله (patchlevel) است (برای نمونه 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
محدود کردن دستگاه‌هایی که برای دستور قابل مشاهده و دسترسی هستند. دستگاه‌هایی که در لیست نباشند به عنوان دستگاه ناموجود در نظر گرفته می‌شوند. این گزینه می‌تواند تکرار شود، یا لیستی از دستگاه‌ها را به صورت جداشده با کاما بپذیرد. این گزینه بر فایل دستگاه‌ها (devices file) اولویت دارد.

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

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

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

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

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

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

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

--journal رشته
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعات فعال‌شده توسط تنظیم 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ها. وقتی از راهنماها استفاده نشود، دستور ممکن است دستگاه‌های بیشتری را برای یافتن 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 تنها تنظیمات پیکربندی را چاپ می‌کند که نسبت به مقادیر پیش‌فرض خود در فایل‌های پیکربندی تغییر یافته‌اند (تفاوت میان 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). این گزینه را از ۱ تا ۴ بار تکرار کنید تا جزئیات پیام‌های ارسالی به stdout و stderr افزایش یابد.

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

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

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

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

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

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

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

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

متغیرها (VARIABLES)

رشته

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

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

اندازه یک مقدار ورودی عددی است که واحد اختیاری می‌پذیرد. واحدهای ورودی صرف‌نظر از کوچک یا بزرگ بودن حروف همواره بر مبنای توان‌های ۲ در نظر گرفته می‌شوند؛ به عنوان نمونه هم '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)