نام (NAME)

lvs - گزارش و نمایش اطلاعات حجمهای منطقی (LV) در LVM

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

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

توضیحات (DESCRIPTION)

دستور lvs خروجی قالببندیشده، ستونی و سفارشیسازیپذیری از وضعیت، اندازه، صفتها و ویژگیهای حجمهای منطقی سیستم ارائه میدهد.

دستور lvs خروجی قالب‌بندی‌شده‌ای پیرامون ویژگی‌ها و وضعیت حجم‌های منطقی (LV) تولید می‌کند.

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

lvs

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

گزینه‌ها (OPTIONS)

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

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

--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
نمایش متن راهنما.

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

--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
استفاده از ستون‌های پیش‌فرضی که بر اطلاعات قطعه‌ها (segments) تأکید دارند.

-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)

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 استفاده شود.

نکات (NOTES)

بیت‌های ویژگی‌های حجم منطقی (lv_attr) عبارتند از:

1

نوع حجم: کَش (C)، آینه‌ای (m)، آینه‌ای بدون همگام‌سازی اولیه (M)، مبدا (o)، مبدا با اسنپ‌شات در حال ادغام (O)، یکپارچگی (g)، رید (r)، رید بدون همگام‌سازی اولیه (R)، اسنپ‌شات (s)، اسنپ‌شات در حال ادغام (S)، دستور pvmove (p)، مجازی (v)، تصویر آینه‌ای یا رید (i)، تصویر آینه‌ای یا رید ناهمگام (I)، دستگاه لاگ آینه‌ای (l)، در حال تبدیل (c)، حجم thin (V)، استخر thin (t)، داده‌های استخر thin (T)، استخر vdo (d)، داده‌های استخر vdo (D)، متادیتای raid یا استخر (e) یا متادیتای یدکی استخر.

2

مجوزهای دسترسی: قابل نوشتن (w)، فقط‌خواندنی (r)، فعال‌سازی فقط‌خواندنی حجم غیر فقط‌خواندنی (R).

3

سیاست تخصیص: هر جا (a)، پیوسته (c)، به ارث رسیده (i)، چسبنده (l)، عادی (n). اگر حجم در حال حاضر در برابر تغییرات تخصیص قفل شده باشد (مثلاً هنگام اجرای pvmove(8))، این نویسه با حرف بزرگ نمایش داده می‌شود.

4

شماره فرعی ثابت: شماره فرعی ثابت (m).

5

وضعیت: فعال (a)، تاریخی (h)، معلق (s)، اسنپ‌شات نامعتبر (I)، اسنپ‌شات معلق نامعتبر (S)، شکست در ادغام اسنپ‌شات (m)، شکست در ادغام اسنپ‌شات معلق (M)، دستگاه نگاشت‌شده بدون جدول موجود است (d)، دستگاه نگاشت‌شده با جدول غیرفعال موجود است (i)، نیاز به بررسی thin-pool (c)، نیاز به بررسی thin-pool معلق (C)، ناشناخته (X).

6

باز بودن دستگاه: دستگاه باز است (o)، ناشناخته (X).

7

نوع هدف کرنل: کَش (C)، آینه‌ای (m)، رید (r)، اسنپ‌شات (s)، حجم یا استخر thin (t)، ناشناخته (u)، مجازی (v). این فیلد حجم‌های منطقی مربوط به یک هدف کرنل یکسان را گروه‌بندی می‌کند. برای نمونه، تصاویر آینه‌ای، لاگ‌های آینه‌ای و همچنین خود آینه‌ها در صورتی که از درایور کرنل اصلی آینه‌ای device-mapper استفاده کنند با (m) ظاهر می‌شوند؛ در حالی که معادل‌های raid آن‌ها که از درایور کرنل md raid استفاده می‌کنند همگی با (r) نمایش می‌یابند. اسنپ‌شات‌هایی که از درایور اصلی device-mapper استفاده می‌کنند با (s) نمایش داده می‌شوند؛ در حالی که اسنپ‌شات‌های حجم‌های thin که از درایور جدید thin provisioning بهره می‌برند با (t) ظاهر می‌شوند.

8

بلوک‌های داده تازه تخصیص‌یافته پیش از استفاده با بلوک‌های صفر (z) رونویسی می‌شوند.

9

سلامت حجم، که در حال حاضر سه گروه از ویژگی‌ها برای آن تعریف شده است:

موارد مشترک برای تمام حجم‌های منطقی: ناقص (p)، ناشناخته (X).
شناسه (p) نشان می‌دهد که یک یا چند حجم فیزیکی (PV) مورد استفاده این حجم منطقی در سیستم موجود نیست. شناسه (X) نشان می‌دهد که وضعیت سلامت نامعلوم است.

مرتبط با حجم‌های منطقی RAID: نیاز به تازه‌سازی (r)، وجود عدم تطابق (m)، بیشتر‌نوشتنی (w).
شناسه (r) نشان می‌دهد که یک یا چند حجم فیزیکی مورد استفاده این حجم منطقی RAID دچار خطای نوشتن شده است. این خطا می‌تواند به دلیل یک اشکال موقت در آن حجم فیزیکی یا نشانه‌ای از در شرف خرابی بودن آن باشد. در این شرایط دستگاه باید تازه‌سازی یا تعویض شود. شناسه (m) بیانگر آن است که بخش‌هایی از آرایه حجم منطقی RAID با یکدیگر ناهمخوان هستند. این ناهمخوانی‌ها با اجرای عملیات "check" روی حجم منطقی RAID شناسایی می‌شوند (عملیات پاکسازی و نگهداری شامل "check" و "repair" را می‌توان از طریق دستور 'lvchange' روی حجم منطقی RAID انجام داد). شناسه (w) دستگاه‌هایی را در یک حجم منطقی RAID 1 مشخص می‌کند که به صورت write-mostly (بیشتر‌نوشتنی) نشانه‌گذاری شده‌اند. شناسه تغییر شکل (s) نشان می‌دهد که حجم منطقی RAID در حال اضافه/حذف استرایپ، تغییر اندازه استرایپ یا تغییر الگوریتم RAID است. شناسه حذف پس از تغییر شکل (R) نشان‌دهنده تصاویر رید آزادشده پس از تغییر شکل است که باید حذف شوند.

مرتبط با حجم‌های منطقی استخر Thin: شکست‌خورده (F)، اتمام فضای داده (D)، متادیتای فقط‌خواندنی (M).
شناسه (F) زمانی فعال می‌شود که استخر thin با خطاهای بحرانی روبرو شده و هیچ ورودی/خروجی (I/O) دیگری تحت هیچ شرایطی مجاز نباشد. شناسه اتمام فضای داده (D) هنگامی تنظیم می‌شود که حجم استخر thin با کمبود فضای ذخیره‌سازی داده مواجه شده باشد. شناسه متادیتای فقط‌خواندنی (M) نشان می‌دهد که استخر thin با نوع خاصی از خطا مواجه شده اما دست‌کم خواندن داده‌ها امکان‌پذیر است، هرچند هیچ تغییری در متادیتا مجاز نخواهد بود.

مرتبط با حجم‌های منطقی Thin: شکست‌خورده (F).
شناسه (F) زمانی تنظیم می‌شود که استخر thin مربوطه وارد وضعیت شکست‌خورده (Failed) شود و هیچ عملیات ورودی/خروجی اجازه انجام نداشته باشد.

مرتبط با حجم‌های منطقی writecache: خطا (E).
شناسه (E) زمانی تنظیم می‌شود که dm-writecache یک خطا گزارش دهد.

10

صرف‌نظر از فعال‌سازی (k): این حجم نشانه‌گذاری شده است تا در طول فرآیند فعال‌سازی نادیده گرفته شود.

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