.TH "VGS" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgs \- گزارش و نمایش اطلاعات گروههای حجم (VG) در LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgs\fP [\fIگزینهها\fR] [\fIگروه_حجم\fR...]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgs\fR خروجی قالببندیشده، ستونی و گزارش جامعی از وضعیت گروههای حجم، تعداد حجمهای فیزیکی و منطقی، و میزان فضای آزاد و تخصیصیافته ارائه میدهد.
.
.SH "کاربرد (USAGE)"
.
\fBvgs\fP
.br
.RS 4
.na
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[ \fB\-a\fP|\fB\-\-all\fP ]
.br
[ \fB\-o\fP|\fB\-\-options\fP \fIString\fP ]
.br
[ \fB\-O\fP|\fB\-\-sort\fP \fIString\fP ]
.br
[    \fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP ]
.br
[    \fB\-\-foreign\fP ]
.br
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-logonly\fP ]
.br
[    \fB\-\-readonly\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[    \fB\-\-shared\fP ]
.br
[    \fB\-\-units\fP \c
.nh
\%[\fINumber\fP]\fBr\fP|\:\fBR\fP|\:\fBh\fP|\:\fBH\fP|\:\fBb\fP|\:\fBB\fP|\:\fBs\fP|\:\fBS\fP|\:\fBk\fP|\:\fBK\fP|\:\fBm\fP|\:\fBM\fP|\:\fBg\fP|\:\fBG\fP|\:\fBt\fP|\:\fBT\fP|\:\fBp\fP|\:\fBP\fP|\:\fBe\fP|\:\fBE\fP
.hy
]
.br
[    \fB\-\-aligned\fP ]
.br
[    \fB\-\-binary\fP ]
.br
[    \fB\-\-headings\fP \fBnone\fP|\fBabbrev\fP|\fBfull\fP|\fB0\fP|\fB1\fP|\fB2\fP ]
.br
[    \fB\-\-nameprefixes\fP ]
.br
[    \fB\-\-noheadings\fP ]
.br
[    \fB\-\-nosuffix\fP ]
.br
[    \fB\-\-rows\fP ]
.br
[    \fB\-\-separator\fP \fIString\fP ]
.br
[    \fB\-\-unbuffered\fP ]
.br
[    \fB\-\-unquoted\fP ]
.br
[ گزینه‌های عمومی ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP ... ]
.RE
.P
گزینه‌های عمومی برای lvm:
.
.RS 4
.na
[ \fB\-d\fP|\fB\-\-debug\fP ]
.br
[ \fB\-h\fP|\fB\-\-help\fP ]
.br
[ \fB\-q\fP|\fB\-\-quiet\fP ]
.br
[ \fB\-t\fP|\fB\-\-test\fP ]
.br
[ \fB\-v\fP|\fB\-\-verbose\fP ]
.br
[ \fB\-y\fP|\fB\-\-yes\fP ]
.br
[    \fB\-\-commandprofile\fP \fIString\fP ]
.br
[    \fB\-\-config\fP \fIString\fP ]
.br
[    \fB\-\-devices\fP \fIPV\fP ]
.br
[    \fB\-\-devicesfile\fP \fIString\fP ]
.br
[    \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-journal\fP \fIString\fP ]
.br
[    \fB\-\-lockopt\fP \fIString\fP ]
.br
[    \fB\-\-longhelp\fP ]
.br
[    \fB\-\-nohints\fP ]
.br
[    \fB\-\-nolocking\fP ]
.br
[    \fB\-\-profile\fP \fIString\fP ]
.br
[    \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.HP
\fB\-\-aligned\fP
.br
همراه با \-\-separator برای تراز کردن ستون‌های خروجی استفاده می‌شود.
.
.HP
\fB\-a\fP|\fB\-\-all\fP
.br
فهرست کردن تمام VGها. معادل مشخص نکردن هیچ VG.
.
.HP
\fB\-\-binary\fP
.br
استفاده از مقادیر دودویی "0" یا "1" به جای مقادیر لفظی توصیفی برای ستون‌هایی که دقیقاً دو مقدار معتبر برای گزارش دارند (بدون احتساب مقدار "unknown" که نشان می‌دهد مقدار قابل تعیین نبوده است).
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
پروفایل دستوری مورد استفاده برای پیکربندی دستور.
برای اطلاعات بیشتر درباره پروفایل‌ها به \fBlvm.conf\fP(5) مراجعه کنید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور. این تنظیمات پیکربندی‌های موجود در \fBlvm.conf\fP(5) را بازنویسی می‌کنند.
آرگومان رشته (String) از همان فرمت \fBlvm.conf\fP(5) استفاده می‌کند، یا می‌تواند قواعد نگارشی بخش/فیلد (section/field) را به کار گیرد.
برای اطلاعات بیشتر درباره پیکربندی به \fBlvm.conf\fP(5) مراجعه کنید.
.
.HP
\fB\-\-configreport\fP \fBlog\fP|\fBvg\fP|\fBlv\fP|\fBpv\fP|\fBpvseg\fP|\fBseg\fP
.br
به \fBlvmreport\fP(7) مراجعه کنید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی (debug). از ۱ تا ۶ بار تکرار می‌شود تا جزئیات پیام‌های ارسالی به فایل ثبت وقایع (log) و/یا syslog (در صورت پیکربندی) افزایش یابد.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
دستگاه‌هایی را که برای دستور قابل مشاهده و در دسترس هستند محدود می‌کند. دستگاه‌هایی که فهرست نشده‌اند، مفقود به نظر می‌رسند. این گزینه می‌تواند تکرار شود، یا فهرستی جداشده با ویرگول از دستگاه‌ها را بپذیرد. این گزینه بر فایل devices اولویت دارد.
.
.HP
\fB\-\-devicesfile\fP \fIString\fP
.br
فایلی شامل فهرست دستگاه‌هایی که LVM باید از آنها استفاده کند.
این فایل باید در \fI/etc/lvm/devices/\fP وجود داشته باشد و با دستور \fBlvmdevices\fP(8) مدیریت می‌شود.
این گزینه تنظیمات \fBdevices/devicesfile\fP و \fBdevices/use_devicesfile\fP در \fBlvm.conf\fP(5) را بازنویسی می‌کند.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم روی no (خیر)، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. برای مقاصد آزمایش و اشکال‌زدایی.
.
.HP
\fB\-\-foreign\fP
.br
گزارش/نمایش VGهای خارجی (foreign) که در غیر این صورت نادیده گرفته می‌شدند.
برای اطلاعات بیشتر درباره VGهای خارجی به \fBlvmsystemid\fP(7) مراجعه کنید.
.
.HP
\fB\-\-headings\fP \fBnone\fP|\fBabbrev\fP|\fBfull\fP|\fB0\fP|\fB1\fP|\fB2\fP
.br
نوع سرستون‌های مورد استفاده در خروجی گزارش.
\fBnone\fP یا \fB0\fP: بدون سرستون.
\fBabbrev\fP یا \fB1\fP: اختصارات نام ستون‌ها.
\fBfull\fP یا \fB2\fP: نام‌های کامل ستون‌ها.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-ignorelockingfailure\fP
.br
به دستور اجازه می‌دهد پس از شکست‌های قفل‌گذاری، با عملیات متادیتای فقط‌خواندنی ادامه دهد.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در جورنال systemd (systemd journal).
این اطلاعات علاوه بر اطلاعات فعال‌شده توسط تنظیم log/journal در lvm.conf است.
command: ثبت اطلاعات درباره دستور.
output: ثبت خروجی پیش‌فرض دستور.
debug: ثبت کامل پیام‌های اشکال‌زدایی دستور.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌های موارد خاص به lvmlockd استفاده می‌شود.
برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه فرمایید.
.
.HP
\fB\-\-logonly\fP
.br
صرف‌نظر کردن از گزارش دستور و تنها نمایش گزارش وقایع (log report).
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن کامل و تفصیلی راهنما.
.
.HP
\fB\-\-nameprefixes\fP
.br
افزودن پیشوند "LVM2_" به علاوه نام فیلد به خروجی. در ترکیب با \-\-noheadings برای تولید فهرستی از جفت‌های field=value جهت تنظیم متغیرهای محیطی (مثلاً در قوانین udev) مفید است.
.
.HP
\fB\-\-noheadings\fP
.br
حذف خط سرستون‌ها که به طور معمول اولین خط خروجی است. هنگام grep کردن خروجی مفید است.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنما (hints file) برای مکان‌یابی دستگاه‌های PV. هنگامی که از راهنماها استفاده نشود، دستور ممکن است دستگاه‌های بیشتری را برای یافتن PVها بخواند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در مواقع مناسب انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ اجرای هم‌زمان دستورها ممکن است نتایج نادرستی به بار آورد.
.
.HP
\fB\-\-nosuffix\fP
.br
حذف پسوند از اندازه‌ها در خروجی. در صورت پردازش خروجی، همراه با \-\-units (به جز h و H) استفاده شود.
.
.HP
\fB\-o\fP|\fB\-\-options\fP \fIString\fP
.br
فهرستی مرتب و جداشده با ویرگول از فیلدها برای نمایش در ستون‌ها.
قواعد نگارشی آرگومان رشته به صورت زیر است:
[\fB+\fP|\fB\-\fP|\fB#\fP]\fIField1\fP[\fB,\fP\fIField2\fP ...]
پیشوند \fB+\fP فیلدهای مشخص‌شده را به فیلدهای پیش‌فرض اضافه می‌کند،
\fB\-\fP فیلدهای مشخص‌شده را از فیلدهای پیش‌فرض حذف می‌کند، و
\fB#\fP فیلدهای مشخص‌شده را فشرده می‌کند (حذف آنها در صورتی که برای تمام ردیف‌ها خالی باشند).
از \fB\-o help\fP برای مشاهده فهرست تمام فیلدهای موجود استفاده کنید.
با تکرار گزینه \-o از فهرست‌های جداگانه فیلدها برای افزودن، حذف یا فشرده‌سازی استفاده کنید: \-o+field1,field2 \-o\-field3,field4 \-o#field5.
این فهرست‌ها از چپ به راست ارزیابی می‌شوند.
از نام فیلد \fBlv_all\fP برای مشاهده تمام فیلدهای LV،
\fBvg_all\fP برای تمام فیلدهای VG،
\fBpv_all\fP برای تمام فیلدهای PV،
\fBpvseg_all\fP برای تمام فیلدهای سگمنت PV،
\fBseg_all\fP برای تمام فیلدهای سگمنت LV، و
\fBpvseg_all\fP برای تمام ستون‌های سگمنت PV استفاده کنید.
برای گزینه‌های پیکربندی بیشتر بخش گزارش \fBlvm.conf\fP(5) را ببینید.
برای اطلاعات بیشتر درباره گزارش‌گیری به \fBlvmreport\fP(7) مراجعه فرمایید.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار برای \-\-commandprofile یا \-\-metadataprofile بسته به دستور.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی و پیام‌های ثبت وقایع. بر \-\-debug و \-\-verbose تقدم دارد. با یک بار تکرار بیشتر، اعلان‌هایی که پاسخ 'no' دارند نیز خاموش می‌شوند.
.
.HP
\fB\-\-readonly\fP
.br
جلوگیری از اعمال تغییرات توسط دستور، از جمله فعال‌سازی و به‌روزرسانی‌های متاداده. (برای LVهای فقط‌خواندنی به \-\-permission r مراجعه فرمایید.)
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
بازنویسی قالب خروجی کنونی برای گزارش‌ها که به صورت سراسری توسط تنظیم report/output_format در \fBlvm.conf\fP(5) تعیین می‌شود.
\fBbasic\fP قالب اصلی با ستون‌ها و ردیف‌ها است.
اگر در هر دستور بیش از یک گزارش وجود داشته باشد، هر گزارش با نام گزارش جهت شناسایی پیشوند می‌گیرد. \fBjson\fP خروجی گزارش را در قالب JSON تولید می‌کند. \fBjson_std\fP خروجی گزارش را در قالب JSON سازگارتر با استاندارد JSON تولید می‌کند.
برای اطلاعات بیشتر به \fBlvmreport\fP(7) مراجعه فرمایید.
.
.HP
\fB\-\-rows\fP
.br
چاپ ستون‌ها به صورت سطر (ردیف).
.
.HP
\fB\-S\fP|\fB\-\-select\fP \fIString\fP
.br
انتخاب اشیاء برای پردازش و گزارش بر اساس معیارهای مشخص‌شده.
قواعد نگارشی معیارها توسط \fB\-\-select help\fP و \fBlvmreport\fP(7) شرح داده شده است.
برای دستورهای گزارش‌گیری، به ازای هر شیء منطبق با معیارها یک ردیف نمایش داده می‌شود.
برای فیلدهای قابل‌انتخاب اشیاء به \fB\-\-options help\fP مراجعه فرمایید.
ردیف‌ها را می‌توان با یک فیلد اضافی "selected" نمایش داد (\-o selected) که اگر ردیف با معیار مطابقت داشته باشد ۱ و در غیر این صورت ۰ را نشان می‌دهد.
برای دستورهای غیر گزارش‌گیری که موجودیت‌های LVM را پردازش می‌کنند، انتخاب برای تعیین مواردی که باید پردازش شوند به کار می‌رود.
.
.HP
\fB\-\-separator\fP \fIString\fP
.br
رشته‌ای که برای جدا کردن هر ستون استفاده می‌شود. هنگام grep کردن خروجی مفید است.
.
.HP
\fB\-\-shared\fP
.br
گزارش/نمایش VGهای مشترک (shared) که در صورت عدم استفاده از lvmlockd بر روی میزبان، نادیده گرفته می‌شدند.
برای اطلاعات بیشتر درباره VGهای مشترک به \fBlvmlockd\fP(8) مراجعه کنید.
.
.HP
\fB\-O\fP|\fB\-\-sort\fP \fIString\fP
.br
فهرست مرتب و جداشده با ویرگول از ستون‌ها برای مرتب‌سازی. جایگزین انتخاب پیش‌فرض می‌شود. برای مرتب‌سازی معکوس بر روی یک ستون، قبل از نام آن ستون علامت \fB\-\fP قرار دهید.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی. دستورها متاداده را به‌روزرسانی نخواهند کرد.
این عملکرد با غیرفعال کردن تمامی عملیات‌های نوشتن متاداده پیاده‌سازی شده است، اما همچنان وضعیت موفقیت را به تابع فراخواننده بازمی‌گرداند. این موضوع ممکن است در عملیات‌های چندمرحله‌ای منجر به پیام‌های خطای غیرعادی شود اگر ابزاری به خواندن متاداده‌ای تکیه کند که فرض می‌کند تغییر کرده است در حالی که تغییری نکرده است.
.
.HP
\fB\-\-unbuffered\fP
.br
تولید فوری خروجی بدون مرتب‌سازی یا تراز کردن دقیق ستون‌ها.
.
.HP
.ad
\fB\-\-units\fP \c
.nh
\%[\fINumber\fP]\fBr\fP|\:\fBR\fP|\:\fBh\fP|\:\fBH\fP|\:\fBb\fP|\:\fBB\fP|\:\fBs\fP|\:\fBS\fP|\:\fBk\fP|\:\fBK\fP|\:\fBm\fP|\:\fBM\fP|\:\fBg\fP|\:\fBG\fP|\:\fBt\fP|\:\fBT\fP|\:\fBp\fP|\:\fBP\fP|\:\fBe\fP|\:\fBE\fP
.hy
.ad
.br
تمام اندازه‌ها در خروجی با این واحدها نشان داده می‌شوند:
خوانا برای انسان (r) همراه با نشانگر گرد کردن '<'،
خوانا برای انسان (h)، بایت (b)، سکتورها (s)، کیلوبایت (k)، مگابایت (m)،
گیگابایت (g)، ترابایت (t)، پتابایت (p)، اگزابایت (e).
برای استفاده از مضارب ۱۰۰۰ (استاندارد SI) به جای ۱۰۲۴ از حروف بزرگ استفاده کنید.
واحدهای سفارشی نیز قابل تعیین هستند، مثلاً \-\-units 3M.
.
.HP
\fB\-\-unquoted\fP
.br
هنگامی که همراه با \-\-nameprefixes استفاده شود، مقادیر خروجی در جفت‌های field=value داخل گیومه قرار نمی‌گیرند.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی (verbose). تکرار از ۱ تا ۴ بار برای افزایش جزئیات پیام‌های ارسالی به خروجی استاندارد (stdout) و خطای استاندارد (stderr).
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تایید به صورت تعاملی و در نظر گرفتن همیشگی پاسخ مثبت (yes). با احتیاط بسیار زیاد استفاده شود. (برای پاسخ منفی خودکار، گزینه \-qq را ببینید.)
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I VG
نام گروه حجم (Volume Group). برای نام‌های معتبر به \fBlvm\fP(8) مراجعه کنید.
.TP
.I Tag
نام برچسب (Tag). برای اطلاعات درباره نام برچسب‌ها و استفاده از برچسب‌ها به جای VG، LV یا PV به \fBlvm\fP(8) مراجعه کنید.
.TP
.I String
برای اطلاعات درباره محتوای رشته به توضیحات گزینه‌ها مراجعه کنید.
.TP
.IR Size [UNIT]
اندازه یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد.
واحدهای ورودی همواره به عنوان مقادیر بر مبنای ۲ در نظر گرفته می‌شوند، صرف‌نظر از اینکه با حروف کوچک یا بزرگ نوشته شوند؛ به عنوان مثال هر دو مقدار 'k' و 'K' به ۱۰۲۴ اشاره دارند.
واحد ورودی پیش‌فرض با یک حرف مشخص می‌شود و پس از آن |UNIT می‌آید.
UNIT نشان‌دهنده سایر واحدهای ورودی ممکن است:
.BR b | B
بایت،
.BR s | S
سکتورهای ۵۱۲ بایتی،
.BR k | K
کیبی‌بایت (KiB)،
.BR m | M
میبی‌بایت (MiB)،
.BR g | G
گیبی‌بایت (GiB)،
.BR t | T
تبی‌بایت (TiB)،
.BR p | P
پبی‌بایت (PiB)،
.BR e | E
اگزی‌بایت (EiB).
(این مورد نباید با گزینه کنترلی خروجی \-\-units اشتباه گرفته شود که در آن حروف بزرگ به معنای مضارب ۱۰۰۰ هستند.)
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
برای اطلاعات بیشتر در مورد متغیرهای محیطی مورد استفاده توسط lvm به \fBlvm\fP(8) مراجعه فرمایید.
برای نمونه، LVM_VG_NAME معمولاً می‌تواند به جای یک پارامتر الزامی VG جایگزین شود.
.
.SH "نکات (NOTES)"
.
بیت‌های vg_attr عبارتند از:
.IP 1 3
مجوزها (Permissions): قابل نوشتن (\fBw\fP)، فقط‌خواندنی (\fBr\fP)
.IP 2 3
قابلیت تغییر اندازه (Resi\fBz\fPeable)
.IP 3 3
صادرشده (E\fBx\fPported)
.IP 4 3
ناقص (\fBp\fPartial): یک یا چند حجم فیزیکی متعلق به گروه حجم در سیستم مفقود هستند
.IP 5 3
سیاست تخصیص (Allocation policy): پیوسته (\fBc\fPontiguous)، چسبنده (c\fBl\fPing)، عادی (\fBn\fPormal)، هرجا (\fBa\fPnywhere)
.IP 6 3
خوشه‌ای (\fBc\fPlustered)، مشترک (\fBs\fPhared)
.
.SH "همچنین ببینید (SEE ALSO)"
.
.nh
.na
.BR lvm (8),
.BR lvm.conf (5),
.BR lvmconfig (8),
.BR lvmdevices (8),
.P
.BR pvchange (8),
.BR pvck (8),
.BR pvcreate (8),
.BR pvdisplay (8),
.BR pvmove (8),
.BR pvremove (8),
.BR pvresize (8),
.BR pvs (8),
.BR pvscan (8),
.P
.BR vgcfgbackup (8),
.BR vgcfgrestore (8),
.BR vgchange (8),
.BR vgck (8),
.BR vgcreate (8),
.BR vgconvert (8),
.BR vgdisplay (8),
.BR vgexport (8),
.BR vgextend (8),
.BR vgimport (8),
.BR vgimportclone (8),
.BR vgimportdevices (8),
.BR vgmerge (8),
.BR vgmknodes (8),
.BR vgreduce (8),
.BR vgremove (8),
.BR vgrename (8),
.BR vgs (8),
.BR vgscan (8),
.BR vgsplit (8),
.P
.BR lvcreate (8),
.BR lvchange (8),
.BR lvconvert (8),
.BR lvdisplay (8),
.BR lvextend (8),
.BR lvreduce (8),
.BR lvremove (8),
.BR lvrename (8),
.BR lvresize (8),
.BR lvs (8),
.BR lvscan (8),
.P
.BR lvm\-fullreport (8),
.BR lvm\-lvpoll (8),
.BR blkdeactivate (8),
.BR lvmdump (8),
.P
.BR dmeventd (8),
.BR lvmpolld (8),
.BR lvmlockd (8),
.BR lvmlockctl (8),
.BR cmirrord (8),
.BR lvmdbusd (8),
.BR fsadm (8),
.P
.BR lvmsystemid (7),
.BR lvmreport (7),
.BR lvmcache (7),
.BR lvmraid (7),
.BR lvmthin (7),
.BR lvmvdo (7),
.BR lvmautoactivation (7)