نام (NAME)

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

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

vgs [گزینهها] [گروه_حجم...]

توضیحات (DESCRIPTION)

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

کاربرد (USAGE)

vgs

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

گزینه‌ها (OPTIONS)

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

-a|--all
فهرست کردن تمام VGها. معادل مشخص نکردن هیچ VG.

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

--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های خارجی (foreign) که در غیر این صورت نادیده گرفته می‌شدند. برای اطلاعات بیشتر درباره VGهای خارجی به lvmsystemid(7) مراجعه کنید.

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

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

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

--journal String
ثبت اطلاعات در جورنال systemd (systemd journal). این اطلاعات علاوه بر اطلاعات فعال‌شده توسط تنظیم 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 استفاده کنید. برای گزینه‌های پیکربندی بیشتر بخش گزارش 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
چاپ ستون‌ها به صورت سطر (ردیف).

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

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

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

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

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

متغیرها (VARIABLES)

VG

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

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)

بیت‌های vg_attr عبارتند از:

1

مجوزها (Permissions): قابل نوشتن (w)، فقط‌خواندنی (r)

2

قابلیت تغییر اندازه (Resizeable)

3

صادرشده (Exported)

4

ناقص (partial): یک یا چند حجم فیزیکی متعلق به گروه حجم در سیستم مفقود هستند

5

سیاست تخصیص (Allocation policy): پیوسته (contiguous)، چسبنده (cling)، عادی (normal)، هرجا (anywhere)

6

خوشه‌ای (clustered)، مشترک (shared)

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