نام (NAME)

pvdisplay - نمایش ویژگیها و اطلاعات حجمهای فیزیکی در LVM

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

pvdisplay [گزینهها] [حجم_فیزیکی...]

توضیحات (DESCRIPTION)

دستور pvdisplay ویژگیها و جزئیات حجمهای فیزیکی (Physical Volumes) از جمله اندازه، گروه حجم، بخشهای فیزیکی آزاد و اختصاصیافته و وضعیت برچسب را نمایش میدهد.

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

کاربرد (USAGE)

pvdisplay

—

نمایش خروجی به صورت ستونی مانند pvs:

pvdisplay -C|--columns

—

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

pvdisplay -c|--colon

—

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

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

گزینه‌ها (OPTIONS)

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

-a|--all
نمایش اطلاعات درباره دستگاه‌هایی که توسط LVM مقداردهی اولیه نشده‌اند، یعنی PV نیستند.

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

-c|--colon
تولید خروجی جداشده با دونقطه (:) برای تجزیه و پردازش آسان‌تر در اسکریپت‌ها یا برنامه‌ها. همچنین به pvs(8) مراجعه کنید که کنترل بسیار بیشتری بر خروجی فراهم می‌سازد. مقادیر عبارتند از:
• نام دستگاه حجم فیزیکی (PV)
• نام گروه حجم (VG)
• اندازه حجم فیزیکی بر حسب سکتور
• شماره داخلی حجم فیزیکی (منسوخ‌شده)
• وضعیت حجم فیزیکی
• قابلیت تخصیص (یا عدم تخصیص) حجم فیزیکی
• تعداد فعلی حجم‌های منطقی (LV) بر روی این حجم فیزیکی
• اندازه اکستنت فیزیکی (PE) بر حسب کیلوبایت
• تعداد کل اکستنت‌های فیزیکی
• تعداد اکستنت‌های فیزیکی آزاد
• تعداد اکستنت‌های فیزیکی تخصیص‌یافته

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

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

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

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

-d|--debug ...
تنظیم سطح اشکال‌زدایی (debug). از ۱ تا ۶ بار تکرار می‌شود تا جزئیات پیام‌های ارسالی به فایل ثبت وقایع (log) و/یا 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) نخواهد کرد. برای آزمایش و اشکال‌زدایی کاربرد دارد.

--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
سرکوب گزارش دستور و نمایش تنها گزارش لاگ.

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

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

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

--noheadings
سرکوب سطر عناوین/سرستون‌ها که به طور معمول اولین سطر خروجی است. در صورت فیلتر کردن خروجی با grep مفید است.

--nohints
عدم استفاده از فایل نکات (hints) برای یافتن دستگاه‌های مرتبط با 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، و pvseg_all تمام ستون‌های سگمنت PV استفاده کنید. برای گزینه‌های پیکربندی بیشتر، بخش report در 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 سازگارتر با استاندارد JSON تولید می‌نماید. برای اطلاعات بیشتر به lvmreport(7) مراجعه کنید.

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

--segments
نمایش سگمنت‌های PV به همراه اطلاعات مربوط به آنها.

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

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

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

-s|--short
فقط اندازه PVهای داده‌شده را نمایش می‌دهد.

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

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

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

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

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

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

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

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

متغیرها (VARIABLES)

PV

نام حجم فیزیکی، یک مسیر دستگاه زیر شاخه /dev. برای دستورهایی که اکستنت‌های فیزیکی را مدیریت می‌کنند، یک آرگومان مکانی PV عموماً پسوندی را می‌پذیرد که نشان‌دهنده یک محدوده (یا چند محدوده) از اکستنت‌های فیزیکی (PEها) است. در صورتی که نخستین PE حذف شود، پیش‌فرض ابتدای دستگاه در نظر گرفته می‌شود و در صورت حذف آخرین PE، پیش‌فرض انتهای دستگاه خواهد بود. محدوده آغاز و پایان (شامل هر دو): PV[:PE-PE]... محدوده آغاز و طول (شمارش از ۰): PV[:PE+PE]...

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)