نام (NAME)

lvdisplay - نمایش ویژگیها و اطلاعات حجم منطقی در LVM

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

lvdisplay [گزینهها] [حجم_منطقی...]

توضیحات (DESCRIPTION)

دستور lvdisplay ویژگیهای حجمهای منطقی (Logical Volumes) از جمله اندازه، وضعیت دسترسی، بخشهای فیزیکی اختصاصیافته و طرحبندی را در قالبی ساختاریافته نمایش میدهد.

دستور lvs(8) جایگزینی ارجح است که اطلاعات یکسان و حتی بیشتری را با استفاده از قالبی فشرده‌تر و با قابلیت سفارشی‌سازی بالاتر نمایش می‌دهد.

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

lvdisplay

—

نمایش خروجی در ستون‌ها مانند lvs:

lvdisplay -C|--columns

—

تولید خروجی جداشده با دو نقطه (colon):

lvdisplay -c|--colon

—

گزینه‌های عمومی دستور:

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

گزینه‌ها (OPTIONS)

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

-a|--all
نمایش اطلاعات مربوط به حجم‌های منطقی (LV) داخلی. این‌ها اجزای حجم‌های منطقی عادی (مانند آینه‌ها یا قطعات RAID) هستند که به صورت مستقل در دسترس نمی‌باشند (مانند حجم‌هایی که قابل سوار کردن یا mount نیستند).

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

-c|--colon
تولید خروجی تفکیک‌شده با علامت دو نقطه (:) جهت تسهیل پردازش و تجزیه در اسکریپت‌ها یا برنامه‌ها. همچنین به دستور lvs(8) مراجعه کنید که کنترل به مراتب بیشتری روی خروجی فراهم می‌کند. ترتیب مقادیر خروجی به شرح زیر است:
• نام حجم منطقی (logical volume name)
• نام گروه حجم (volume group name)
• دسترسی حجم منطقی (logical volume access)
• وضعیت حجم منطقی (logical volume status)
• شماره داخلی حجم منطقی (internal logical volume number)
• تعداد دفعات باز بودن حجم منطقی (open count of logical volume)
• اندازه حجم منطقی بر حسب سکتور (logical volume size in sectors)
• تعداد اکستنت‌های منطقی کنونی وابسته به حجم منطقی (current logical extents)
• تعداد اکستنت‌های منطقی تخصیص‌یافته به حجم منطقی (allocated logical extents)
• سیاست تخصیص حجم منطقی (allocation policy)
• سکتورهای پیش‌خوانی حجم منطقی (read ahead sectors)
• شماره دستگاه اصلی حجم منطقی (major device number)
• شماره دستگاه فرعی حجم منطقی (minor device number)

-C|--columns
نمایش خروجی در قالب ستونی. معادل دستور lvs(8). گزینه‌های فهرست‌شده همانند گزینه‌های موجود در lvs(8) هستند.

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

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

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

-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
اگر برابر با n تنظیم شود، دستور تلاشی برای استفاده از نگاشت‌کننده دستگاه (device-mapper) نخواهد کرد. کاربرد برای آزمایش و اشکال‌زدایی.

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

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

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

-H|--history
گنجاندن حجم‌های منطقی پیشین و حذف‌شده (historical LVs) در خروجی. (این گزینه تا زمانی که حجم‌ها هنگام فعال بودن گزینه metadata/record_lvs_history در lvm.conf(5) حذف نشده باشند، تأثیری ندارد).

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

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

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

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

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

-m|--maps
نمایش نگاشت اکستنت‌های منطقی به حجم‌های فیزیکی (PV) و اکستنت‌های فیزیکی. برای نگاشت اکستنت‌های فیزیکی به اکستنت‌های منطقی می‌توانید از دستور زیر استفاده کنید:

pvs --segments -o+lv_name,seg_start_pe,segtype

--nameprefixes
افزودن یک پیشوند "LVM2_" به همراه نام فیلد به خروجی. در صورت استفاده با --noheadings برای تولید فهرستی از جفت‌های کلید=مقدار (field=value) جهت تنظیم متغیرهای محیطی (به عنوان نمونه در قواعد udev) کاربردی است.

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

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

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

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

-o|--options رشته
فهرستی از فیلدهای مرتب‌شده و جداشده با کاما جهت نمایش در ستون‌ها. نحو آرگومان رشته‌ای:
[+|-|#]فیلد۱[,فیلد۲ ...]
پیشوند + فیلدهای مشخص‌شده را به فیلدهای پیش‌فرض اضافه می‌کند، - فیلدهای مشخص‌شده را از فیلدهای پیش‌فرض حذف می‌نماید و # فیلدهای تعیین‌شده را فشرده می‌کند (در صورتی که برای تمام سطرها خالی باشند، آن‌ها را حذف می‌کند). برای مشاهده فهرست تمامی فیلدهای در دسترس از دستور -o help استفاده کنید. جهت افزودن، حذف یا فشرده‌سازی می‌توانید با تکرار گزینه -o فهرست‌های مجزا مشخص نمایید:

-o+field1,field2 -o-field3,field4 -o#field5

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

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

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

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

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

--segments
نمایش اطلاعات بر پایه قطعات (segments) تشکیل‌دهنده حجم منطقی.

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

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

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

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

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

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

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

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

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

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

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

متغیرها (VARIABLES)

VG

نام گروه حجم (Volume Group). برای اسامی مجاز به lvm(8) مراجعه کنید.

LV

نام حجم منطقی (Logical Volume). برای اسامی مجاز به lvm(8) مراجعه کنید. یک آرگومان مکانی LV معمولاً شامل نام VG و LV است، مانند VG/LV.

Tag

نام برچسب (Tag). برای اطلاعات پیرامون اسامی برچسب‌ها و استفاده از آن‌ها به جای VG، LV یا PV به 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)