نام (NAME)

pvs - گزارش و نمایش اطلاعات حجمهای فیزیکی (PV) در LVM

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

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

توضیحات (DESCRIPTION)

دستور pvs خروجی قالببندیشده، ستونی و گزارش جامع از وضعیت حجمهای فیزیکی، گروههای حجم مرتبط و میزان فضای آزاد و استفادهشده را تولید میکند.

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

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

pvs

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

گزینه‌ها (OPTIONS)

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

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

-A|--allpvs
نمایش اطلاعات درباره PVهایی که خارج از فایل دستگاه‌ها (devices file) هستند. برای گنجاندن دستگاه‌هایی که PV نیستند، با -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، و pvseg_all برای تمام ستون‌های قطعه PV استفاده کنید. برای گزینه‌های پیکربندی بیشتر، بخش report در lvm.conf(5) را ببینید. برای اطلاعات بیشتر درباره گزارش‌گیری، lvmreport(7) را مشاهده کنید.

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

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

--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 یک خط خروجی تولید می‌کند که نقطه شروع (pvseg_start) و طول (pvseg_size) را بر حسب واحدهای وسعت فیزیکی (physical extent) نشان می‌دهد.

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

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

--shared
گزارش و نمایش VGهای اشتراکی (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 ...
تنظیم سطح پرگویی (verbosity). برای افزایش جزئیات پیام‌های ارسالی به خروجی استاندارد و خطای استاندارد، ۱ تا ۴ بار قابل تکرار است.

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

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

متغیرها (VARIABLES)

PV

نام حجم فیزیکی (Physical Volume)، یک مسیر دستگاه در زیر /dev. برای دستوراتی که وسعت‌های فیزیکی (PE) را مدیریت می‌کنند، یک آرگومان مکانی PV معمولاً پسوندی را می‌پذیرد که نشان‌دهنده یک محدوده (یا چند محدوده) از وسعت‌های فیزیکی است. در صورت حذف اولین 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 استفاده شود.

نکات (NOTES)

بیت‌های ویژگی‌های حجم فیزیکی (pv_attr) عبارتند از:

1

تکراری [(d)uplicate]، قابل تخصیص [(a)llocatable]، استفاده‌شده [(u)sed]

2

صادرشده [e(x)ported]

3

مفقود [(m)issing]

همچنین ببینید (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)