.TH "LVM-FULLREPORT" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
lvm-fullreport \- نمایش گزارش جامع و یکپارچه از تمام اجزای LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBlvm fullreport\fP [\fIگزینه‌ها\fR]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBlvm fullreport\fR اطلاعات یکپارچه و همزمان از حجم‌های فیزیکی (PV)، گروه‌های حجم (VG) و حجم‌های منطقی (LV) را تحت یک قفل مشترک جمع‌آوری و چاپ می‌کند.
.PP
دستور \fBlvm fullreport\fP خروجی قالب‌بندی‌شده‌ای درباره حجم‌های فیزیکی (PV)، بخش‌های PV، گروه‌های حجم (VG)، حجم‌های منطقی (LV) و بخش‌های LV تولید می‌کند. تمام این اطلاعات برای هر VG تحت یک قفل مستقل به ازای هر VG گردآوری می‌شود تا کاملاً سازگار و هماهنگ باشند. اطلاعات جمع‌آوری‌شده از فراخوانی‌های جداگانه دستورات \fBvgs\fP، \fBpvs\fP و \fBlvs\fP در صورتی که تغییراتی بین اجرای دستورات رخ دهد ممکن است ناهمخوان و متناقض باشند.
.
.SH "نحوه استفاده (USAGE)"
.
\fBlvm fullreport\fP
.br
.RS 4
.na
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fB\-a\fP|\fB\-\-all\fP ]
.br
[ \fB\-o\fP|\fB\-\-options\fP \fIString\fP ]
.br
[ \fB\-O\fP|\fB\-\-sort\fP \fIString\fP ]
.br
[    \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.br
[    \fB\-\-foreign\fP ]
.br
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-logonly\fP ]
.br
[    \fB\-\-readonly\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[    \fB\-\-shared\fP ]
.br
[    \fB\-\-units\fP \c
.nh
\%[\fINumber\fP]\fBr\fP|\:\fBR\fP|\:\fBh\fP|\:\fBH\fP|\:\fBb\fP|\:\fBB\fP|\:\fBs\fP|\:\fBS\fP|\:\fBk\fP|\:\fBK\fP|\:\fBm\fP|\:\fBM\fP|\:\fBg\fP|\:\fBG\fP|\:\fBt\fP|\:\fBT\fP|\:\fBp\fP|\:\fBP\fP|\:\fBe\fP|\:\fBE\fP
.hy
]
.br
[    \fB\-\-aligned\fP ]
.br
[    \fB\-\-binary\fP ]
.br
[    \fB\-\-headings\fP \fBnone\fP|\fBabbrev\fP|\fBfull\fP|\fB0\fP|\fB1\fP|\fB2\fP ]
.br
[    \fB\-\-nameprefixes\fP ]
.br
[    \fB\-\-noheadings\fP ]
.br
[    \fB\-\-nosuffix\fP ]
.br
[    \fB\-\-rows\fP ]
.br
[    \fB\-\-separator\fP \fIString\fP ]
.br
[    \fB\-\-unbuffered\fP ]
.br
[    \fB\-\-unquoted\fP ]
.br
[ COMMON_OPTIONS ]
.ad
.RE
.RS 4
[ \fIVG\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 \fIString\fP ]
.br
[    \fB\-\-config\fP \fIString\fP ]
.br
[    \fB\-\-devices\fP \fIPV\fP ]
.br
[    \fB\-\-devicesfile\fP \fIString\fP ]
.br
[    \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-journal\fP \fIString\fP ]
.br
[    \fB\-\-lockopt\fP \fIString\fP ]
.br
[    \fB\-\-longhelp\fP ]
.br
[    \fB\-\-nohints\fP ]
.br
[    \fB\-\-nolocking\fP ]
.br
[    \fB\-\-profile\fP \fIString\fP ]
.br
[    \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.HP
\fB\-\-aligned\fP
.br
همراه با \fB\-\-separator\fP برای تراز کردن ستون‌های خروجی استفاده می‌شود.
.
.HP
\fB\-a\fP|\fB\-\-all\fP
.br
نمایش تمام داده‌ها و موارد موجود در گزارش.
.
.HP
\fB\-\-binary\fP
.br
استفاده از مقادیر دودویی «0» یا «1» به‌جای مقادیر توصیفی متنی برای ستون‌هایی که دقیقاً دو مقدار معتبر برای گزارش دارند (بدون احتساب مقدار «unknown» که نشان‌دهنده عدم امکان تعیین مقدار است).
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
پروفایل دستوری مورد استفاده برای پیکربندی دستور. برای اطلاعات بیشتر درباره پروفایل‌ها، \fBlvm.conf\fP(5) را ببینید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور. این تنظیمات بر مقادیر \fBlvm.conf\fP(5) تقدم دارند. آرگومان رشته‌ای از همان فرمت \fBlvm.conf\fP(5) یا ساختار بخش/فیلد (section/field) استفاده می‌کند. برای اطلاعات بیشتر درباره پیکربندی، \fBlvm.conf\fP(5) را ببینید.
.
.HP
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br
به \fBlvmreport\fP(7) مراجعه کنید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی. برای افزایش جزئیات پیام‌های ارسالی به فایل لاگ و/یا syslog (در صورت پیکربندی)، بین ۱ تا ۶ بار تکرار کنید.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
دستگاه‌های قابل مشاهده و در دسترس برای دستور را محدود می‌کند. دستگاه‌هایی که در فهرست نباشند، مفقود به‌نظر خواهند رسید. این گزینه می‌تواند تکرار شود یا فهرستی از دستگاه‌ها با کاما جدا شده را بپذیرد. این گزینه بر فایل دستگاه‌ها تقدم دارد.
.
.HP
\fB\-\-devicesfile\fP \fIString\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
در صورت تنظیم بر روی no، دستور تلاشی برای استفاده از نگاشت‌کننده دستگاه (device-mapper) نخواهد کرد. برای اهداف آزمایش و اشکال‌زدایی کاربرد دارد.
.
.HP
\fB\-\-foreign\fP
.br
گزارش و نمایش گروه‌های حجم خارجی (foreign VG) که در حالت عادی نادیده گرفته می‌شوند. برای اطلاعات بیشتر درباره VGهای خارجی، \fBlvmsystemid\fP(7) را ببینید.
.
.HP
\fB\-\-headings\fP \fBnone\fP|\fBabbrev\fP|\fBfull\fP|\fB0\fP|\fB1\fP|\fB2\fP
.br
نوع سرستون‌های مورد استفاده در خروجی گزارش:
.br
\fBnone\fP یا \fB0\fP: بدون سرستون.
.br
\fBabbrev\fP یا \fB1\fP: نام‌های اختصاری ستون‌ها.
.br
\fBfull\fP یا \fB2\fP: نام‌های کامل ستون‌ها.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-ignorelockingfailure\fP
.br
به دستور اجازه می‌دهد تا پس از شکست در قفل‌گذاری، با عملیات فقط‌خواندنی متادیتا به کار خود ادامه دهد.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر مواردی است که با تنظیم log/journal در lvm.conf فعال شده‌اند:
.br
command: ثبت اطلاعات درباره دستور.
.br
output: ثبت خروجی پیش‌فرض دستور.
.br
debug: ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای انتقال گزینه‌ها در موارد خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر \fBlvmlockd\fP(8) را ببینید.
.
.HP
\fB\-\-logonly\fP
.br
صرف‌نظر از نمایش گزارش دستور و نمایش صرفاً گزارش وقایع (log report).
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای بلند و جامع.
.
.HP
\fB\-\-nameprefixes\fP
.br
افزودن پیشوند «LVM2_» همراه با نام فیلد به خروجی. همراه با \fB\-\-noheadings\fP برای تولید فهرستی از جفت‌های field=value جهت مقداردهی متغیرهای محیطی (مثلاً در قوانین udev) مفید است.
.
.HP
\fB\-\-noheadings\fP
.br
حذف سطر سرستون‌ها که معمولاً در اولین سطر خروجی قرار دارد. هنگام فیلتر کردن خروجی با grep بسیار کاربردی است.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل نکات (hints file) برای تعیین موقعیت دستگاه‌ها برای PVها. در صورت عدم استفاده از نکات، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها بخواند. دستور همچنان باطل‌سازی استاندارد فایل نکات را در صورت لزوم انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی ایجاد کنند.
.
.HP
\fB\-\-nosuffix\fP
.br
حذف پسوند واحد در اندازه‌های خروجی. در صورت پردازش خودکار خروجی، همراه با \fB\-\-units\fP (به‌جز گزینه‌های h و H) استفاده می‌شود.
.
.HP
\fB\-o\fP|\fB\-\-options\fP \fIString\fP
.br
فهرست مرتب‌شده و جداشده با کاما از فیلدهایی که باید در ستون‌ها نمایش داده شوند.
نحو آرگومان رشته‌ای به این صورت است:
.br
[\fB+\fP|\fB\-\fP|\fB#\fP]\fIField1\fP[\fB,\fP\fIField2\fP ...]
.br
پیشوند \fB+\fP فیلدهای مشخص‌شده را به فیلدهای پیش‌فرض اضافه می‌کند،
\fB\-\fP فیلدهای مشخص‌شده را از فیلدهای پیش‌فرض حذف می‌کند، و
\fB#\fP فیلدهای مشخص‌شده را فشرده می‌کند (در صورتی که برای تمام سطرها خالی باشند، ستون مربوطه را حذف می‌کند).
.br
از دستور \fB\-o help\fP برای مشاهده فهرست تمام فیلدهای در دسترس استفاده کنید.
همچنین می‌توان با تکرار گزینه \fB\-o\fP، فهرست‌های جداگانه‌ای برای افزودن، حذف یا فشرده‌سازی فیلدها مشخص کرد:
.br
\fB\-o+field1,field2 \-o\-field3,field4 \-o#field5\fP
.br
این فهرست‌ها از چپ به راست ارزیابی می‌شوند.
از نام فیلد \fBlv_all\fP برای مشاهده تمام فیلدهای LV،
\fBvg_all\fP برای تمام فیلدهای VG،
\fBpv_all\fP برای تمام فیلدهای PV،
\fBpvseg_all\fP برای تمام فیلدهای بخش‌های PV،
\fBseg_all\fP برای تمام فیلدهای بخش‌های LV استفاده کنید.
برای تنظیمات پیکربندی بیشتر، بخش گزارش را در \fBlvm.conf\fP(5) ببینید.
برای اطلاعات بیشتر درباره سازوکار گزارش‌گیری، \fBlvmreport\fP(7) را مطالعه کنید.
.
.HP
\fB\-\-profile\fP \fIString\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\-\-readonly\fP
.br
جلوگیری از اعمال تغییرات توسط دستور، از جمله فعال‌سازی و به‌روزرسانی متادیتا. (برای LVهای فقط‌خواندنی، گزینه \fB\-\-permission r\fP را ببینید.)
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
قالب فعلی خروجی گزارش‌ها را که به‌طور سراسری توسط تنظیم report/output_format در \fBlvm.conf\fP(5) تعیین شده بازنویسی می‌کند.
قالب \fBbasic\fP قالب سنتی بر پایه ستون‌ها و سطرها است.
اگر بیش از یک گزارش در دستور وجود داشته باشد، هر گزارش برای شناسایی با نام گزارش پیشوندگذاری می‌شود.
گزینه \fBjson\fP خروجی گزارش را در قالب JSON تولید می‌کند.
گزینه \fBjson_std\fP خروجی را با سازگاری دقیق‌تر با استانداردهای استاندارد JSON تولید می‌کند.
برای اطلاعات بیشتر \fBlvmreport\fP(7) را ببینید.
.
.HP
\fB\-\-rows\fP
.br
نمایش ستون‌ها در قالب سطر.
.
.HP
\fB\-S\fP|\fB\-\-select\fP \fIString\fP
.br
انتخاب موجودیت‌ها برای پردازش و گزارش‌گیری بر اساس معیارهای مشخص‌شده.
نحو معیارها در راهنمای \fB\-\-select help\fP و \fBlvmreport\fP(7) شرح داده شده است.
برای دستورات گزارش‌گیری، به ازای هر شیء منطبق با معیار یک سطر نمایش داده می‌شود.
فیلدهای قابل انتخاب اشیاء در \fB\-\-options help\fP فهرست شده‌اند.
سطرها را می‌توان با یک فیلد اضافی تحت عنوان «selected» نمایش داد (\fB\-o selected\fP) که در صورت تطابق سطر با شرط انتخاب مقدار 1 و در غیر این صورت 0 را نشان می‌دهد.
برای دستوراتی که موجودیت‌های LVM را پردازش می‌کنند، این گزینه برای تعیین مواردی که باید پردازش شوند به کار می‌رود.
.
.HP
\fB\-\-separator\fP \fIString\fP
.br
رشته جداکننده ستون‌ها در خروجی. هنگام پردازش خروجی با ابزارهایی مانند grep بسیار مفید است.
.
.HP
\fB\-\-shared\fP
.br
گزارش و نمایش VGهای اشتراکی که در صورت عدم استفاده از lvmlockd روی میزبان نادیده گرفته می‌شوند.
برای اطلاعات بیشتر درباره VGهای اشتراکی، \fBlvmlockd\fP(8) را ببینید.
.
.HP
\fB\-O\fP|\fB\-\-sort\fP \fIString\fP
.br
فهرست مرتب‌شده با کاما از ستون‌ها برای مرتب‌سازی خروجی. جایگزین انتخاب پیش‌فرض می‌شود. برای مرتب‌سازی معکوس روی هر ستون، پیش از نام آن علامت \fB\-\fP قرار دهید.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی (تست). دستورات متادیتا را در این حالت تغییر نمی‌دهند.
این سازوکار با غیرفعال کردن نوشتن متادیتا اما بازگرداندن وضعیت موفقیت به تابع فراخواننده پیاده‌سازی شده است. این امر در عملیات‌های چندمرحله‌ای ممکن است در صورت وابستگی ابزار به خواندن مجدد متادیتایی که تصور می‌کند تغییر یافته پیام‌های خطای غیرمعمولی تولید کند.
.
.HP
\fB\-\-unbuffered\fP
.br
تولید آنی خروجی بدون مرتب‌سازی یا تراز کردن ستون‌ها.
.
.HP
.ad
\fB\-\-units\fP \c
.nh
\%[\fINumber\fP]\fBr\fP|\:\fBR\fP|\:\fBh\fP|\:\fBH\fP|\:\fBb\fP|\:\fBB\fP|\:\fBs\fP|\:\fBS\fP|\:\fBk\fP|\:\fBK\fP|\:\fBm\fP|\:\fBM\fP|\:\fBg\fP|\:\fBG\fP|\:\fBt\fP|\:\fBT\fP|\:\fBp\fP|\:\fBP\fP|\:\fBe\fP|\:\fBE\fP
.hy
.ad
.br
تمام اندازه‌ها با این واحدها در خروجی نمایش داده می‌شوند:
خوانا برای انسان (\fBr\fP) با نشانگر گرد کردن '>'،
خوانا برای انسان (\fBh\fP)، بایت (\fBb\fP)، سکتور (\fBs\fP)، کیلوبایت (\fBk\fP)، مگابایت (\fBm\fP)، گیگابایت (\fBg\fP)، ترابایت (\fBt\fP)، پتابایت (\fBp\fP)، اگزابایت (\fBe\fP).
حروف بزرگ برای استفاده از مضارب ۱۰۰۰ (استاندارد SI) به‌جای ۱۰۲۴ به کار می‌روند.
واحدهای سفارشی نیز قابل تعیین هستند، مانند \fB\-\-units 3M\fP.
.
.HP
\fB\-\-unquoted\fP
.br
هنگام استفاده همراه با \fB\-\-nameprefixes\fP، مقادیر خروجی در جفت‌های field=value داخل گیومه قرار نمی‌گیرند.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح گزارش جزئیات (پرگویی). برای افزایش جزئیات پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد، ۱ تا ۴ بار قابل تکرار است.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه برنامه.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تأیید تعاملی و فرض همیشگی پاسخ بله (yes). با احتیاط شدید استفاده شود (برای پاسخ منفی خودکار، \fB\-qq\fP را ببینید).
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I VG
نام گروه حجم (Volume Group). برای مشاهده نام‌های مجاز، \fBlvm\fP(8) را ببینید.
.TP
.I String
برای جزئیات بیشتر درباره محتوای این رشته، توضیحات مربوط به هر گزینه را ببینید.
.TP
.IR Size [UNIT]
مقدار عددی اندازه به همراه یک واحد اختیاری است.
واحدهای ورودی صرف‌نظر از بزرگ یا کوچک بودن حروف، همواره بر مبنای توان‌های ۲ در نظر گرفته می‌شوند؛ مثلاً هر دو حرف 'k' و 'K' به مقدار ۱۰۲۴ اشاره دارند.
واحد ورودی پیش‌فرض با یک حرف و به‌دنبال آن |UNIT مشخص می‌شود.
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، به \fBlvm\fP(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)