نام (NAME)

lvm-fullreport - نمایش گزارش جامع و یکپارچه از تمام اجزای LVM

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

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

توضیحات (DESCRIPTION)

دستور lvm fullreport اطلاعات یکپارچه و همزمان از حجم‌های فیزیکی (PV)، گروه‌های حجم (VG) و حجم‌های منطقی (LV) را تحت یک قفل مشترک جمع‌آوری و چاپ می‌کند.

دستور lvm fullreport خروجی قالب‌بندی‌شده‌ای درباره حجم‌های فیزیکی (PV)، بخش‌های PV، گروه‌های حجم (VG)، حجم‌های منطقی (LV) و بخش‌های LV تولید می‌کند. تمام این اطلاعات برای هر VG تحت یک قفل مستقل به ازای هر VG گردآوری می‌شود تا کاملاً سازگار و هماهنگ باشند. اطلاعات جمع‌آوری‌شده از فراخوانی‌های جداگانه دستورات vgs، pvs و lvs در صورتی که تغییراتی بین اجرای دستورات رخ دهد ممکن است ناهمخوان و متناقض باشند.

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

lvm fullreport

گزینه‌های مشترک برای lvm:

گزینه‌ها (OPTIONS)

--aligned
همراه با --separator برای تراز کردن ستون‌های خروجی استفاده می‌شود.

-a|--all
نمایش تمام داده‌ها و موارد موجود در گزارش.

--binary
استفاده از مقادیر دودویی «0» یا «1» به‌جای مقادیر توصیفی متنی برای ستون‌هایی که دقیقاً دو مقدار معتبر برای گزارش دارند (بدون احتساب مقدار «unknown» که نشان‌دهنده عدم امکان تعیین مقدار است).

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

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

--configreport log|vg|lv|pv|pvseg|seg
به lvmreport(7) مراجعه کنید.

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

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

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

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

--foreign
گزارش و نمایش گروه‌های حجم خارجی (foreign VG) که در حالت عادی نادیده گرفته می‌شوند. برای اطلاعات بیشتر درباره VGهای خارجی، lvmsystemid(7) را ببینید.

--headings none|abbrev|full|0|1|2
نوع سرستون‌های مورد استفاده در خروجی گزارش:
none یا 0: بدون سرستون.
abbrev یا 1: نام‌های اختصاری ستون‌ها.
full یا 2: نام‌های کامل ستون‌ها.

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

--ignorelockingfailure
به دستور اجازه می‌دهد تا پس از شکست در قفل‌گذاری، با عملیات فقط‌خواندنی متادیتا به کار خود ادامه دهد.

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

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

--logonly
صرف‌نظر از نمایش گزارش دستور و نمایش صرفاً گزارش وقایع (log report).

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

--nameprefixes
افزودن پیشوند «LVM2_» همراه با نام فیلد به خروجی. همراه با --noheadings برای تولید فهرستی از جفت‌های field=value جهت مقداردهی متغیرهای محیطی (مثلاً در قوانین udev) مفید است.

--noheadings
حذف سطر سرستون‌ها که معمولاً در اولین سطر خروجی قرار دارد. هنگام فیلتر کردن خروجی با grep بسیار کاربردی است.

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

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

--nosuffix
حذف پسوند واحد در اندازه‌های خروجی. در صورت پردازش خودکار خروجی، همراه با --units (به‌جز گزینه‌های h و H) استفاده می‌شود.

-o|--options String
فهرست مرتب‌شده و جداشده با کاما از فیلدهایی که باید در ستون‌ها نمایش داده شوند. نحو آرگومان رشته‌ای به این صورت است:
[+|-|#]Field1[,Field2 ...]
پیشوند + فیلدهای مشخص‌شده را به فیلدهای پیش‌فرض اضافه می‌کند، - فیلدهای مشخص‌شده را از فیلدهای پیش‌فرض حذف می‌کند، و # فیلدهای مشخص‌شده را فشرده می‌کند (در صورتی که برای تمام سطرها خالی باشند، ستون مربوطه را حذف می‌کند).
از دستور -o help برای مشاهده فهرست تمام فیلدهای در دسترس استفاده کنید. همچنین می‌توان با تکرار گزینه -o، فهرست‌های جداگانه‌ای برای افزودن، حذف یا فشرده‌سازی فیلدها مشخص کرد:
-o+field1,field2 -o-field3,field4 -o#field5
این فهرست‌ها از چپ به راست ارزیابی می‌شوند. از نام فیلد lv_all برای مشاهده تمام فیلدهای LV، vg_all برای تمام فیلدهای VG، pv_all برای تمام فیلدهای PV، pvseg_all برای تمام فیلدهای بخش‌های PV، seg_all برای تمام فیلدهای بخش‌های LV استفاده کنید. برای تنظیمات پیکربندی بیشتر، بخش گزارش را در lvm.conf(5) ببینید. برای اطلاعات بیشتر درباره سازوکار گزارش‌گیری، lvmreport(7) را مطالعه کنید.

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

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

--readonly
جلوگیری از اعمال تغییرات توسط دستور، از جمله فعال‌سازی و به‌روزرسانی متادیتا. (برای LVهای فقط‌خواندنی، گزینه --permission r را ببینید.)

--reportformat basic|json|json_std
قالب فعلی خروجی گزارش‌ها را که به‌طور سراسری توسط تنظیم report/output_format در lvm.conf(5) تعیین شده بازنویسی می‌کند. قالب basic قالب سنتی بر پایه ستون‌ها و سطرها است. اگر بیش از یک گزارش در دستور وجود داشته باشد، هر گزارش برای شناسایی با نام گزارش پیشوندگذاری می‌شود. گزینه json خروجی گزارش را در قالب JSON تولید می‌کند. گزینه json_std خروجی را با سازگاری دقیق‌تر با استانداردهای استاندارد JSON تولید می‌کند. برای اطلاعات بیشتر lvmreport(7) را ببینید.

--rows
نمایش ستون‌ها در قالب سطر.

-S|--select String
انتخاب موجودیت‌ها برای پردازش و گزارش‌گیری بر اساس معیارهای مشخص‌شده. نحو معیارها در راهنمای --select help و lvmreport(7) شرح داده شده است. برای دستورات گزارش‌گیری، به ازای هر شیء منطبق با معیار یک سطر نمایش داده می‌شود. فیلدهای قابل انتخاب اشیاء در --options help فهرست شده‌اند. سطرها را می‌توان با یک فیلد اضافی تحت عنوان «selected» نمایش داد (-o selected) که در صورت تطابق سطر با شرط انتخاب مقدار 1 و در غیر این صورت 0 را نشان می‌دهد. برای دستوراتی که موجودیت‌های LVM را پردازش می‌کنند، این گزینه برای تعیین مواردی که باید پردازش شوند به کار می‌رود.

--separator String
رشته جداکننده ستون‌ها در خروجی. هنگام پردازش خروجی با ابزارهایی مانند grep بسیار مفید است.

--shared
گزارش و نمایش VGهای اشتراکی که در صورت عدم استفاده از lvmlockd روی میزبان نادیده گرفته می‌شوند. برای اطلاعات بیشتر درباره VGهای اشتراکی، lvmlockd(8) را ببینید.

-O|--sort String
فهرست مرتب‌شده با کاما از ستون‌ها برای مرتب‌سازی خروجی. جایگزین انتخاب پیش‌فرض می‌شود. برای مرتب‌سازی معکوس روی هر ستون، پیش از نام آن علامت - قرار دهید.

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

--unbuffered
تولید آنی خروجی بدون مرتب‌سازی یا تراز کردن ستون‌ها.

--units [Number]r|R|h|H|b|B|s|S|k|K|m|M|g|G|t|T|p|P|e|E
تمام اندازه‌ها با این واحدها در خروجی نمایش داده می‌شوند: خوانا برای انسان (r) با نشانگر گرد کردن '>'، خوانا برای انسان (h)، بایت (b)، سکتور (s)، کیلوبایت (k)، مگابایت (m)، گیگابایت (g)، ترابایت (t)، پتابایت (p)، اگزابایت (e). حروف بزرگ برای استفاده از مضارب ۱۰۰۰ (استاندارد SI) به‌جای ۱۰۲۴ به کار می‌روند. واحدهای سفارشی نیز قابل تعیین هستند، مانند --units 3M.

--unquoted
هنگام استفاده همراه با --nameprefixes، مقادیر خروجی در جفت‌های field=value داخل گیومه قرار نمی‌گیرند.

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

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

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

متغیرها (VARIABLES)

VG

نام گروه حجم (Volume Group). برای مشاهده نام‌های مجاز، lvm(8) را ببینید.

String

برای جزئیات بیشتر درباره محتوای این رشته، توضیحات مربوط به هر گزینه را ببینید.

Size[UNIT]

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