.TH "VGCK" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgck \- بررسی یکپارچگی و صحت ساختار متادیتای گروههای حجم LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgck\fP [\fIگزینهها\fR] [\fIگروه_حجم\fR...]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgck\fR صحت ساختاری و یکپارچگی متادیتای یک یا چند گروه حجم (VG) را بررسی کرده و خطاهای احتمالی را گزارش میکند.
.
.SH "کاربرد (USAGE)"
.
خواندن و نمایش اطلاعات درباره یک VG:
.br
.P
\fBvgck\fP
.br
.RS 4
.na
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ \fIگزینه‌های_عمومی\fR ]
.ad
.RE
.RS 4
[ \fIVG\fP|\fITag\fP ... ]
.RE
.P
بازنویسی متادیتای VG جهت رفع و اصلاح مشکلات:
.br
.P
\fBvgck\fP \fB\-\-updatemetadata\fP \fIVG\fP
.br
.RS 4
.na
[ \fIگزینه‌های_عمومی\fR ]
.ad
.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 \fIرشته\fP ]
.br
[    \fB\-\-config\fP \fIرشته\fP ]
.br
[    \fB\-\-devices\fP \fIPV\fP ]
.br
[    \fB\-\-devicesfile\fP \fIرشته\fP ]
.br
[    \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-journal\fP \fIرشته\fP ]
.br
[    \fB\-\-lockopt\fP \fIرشته\fP ]
.br
[    \fB\-\-longhelp\fP ]
.br
[    \fB\-\-nohints\fP ]
.br
[    \fB\-\-nolocking\fP ]
.br
[    \fB\-\-profile\fP \fIرشته\fP ]
.br
[    \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.HP
\fB\-\-commandprofile\fP \fIرشته\fP
.br
پروفایل فرمانی که برای پیکربندی دستور استفاده می‌شود. برای اطلاعات بیشتر درباره پروفایل‌ها،
.BR lvm.conf (5)
را ببینید.
.
.HP
\fB\-\-config\fP \fIرشته\fP
.br
تنظیمات پیکربندی برای دستور که بر تنظیمات
.BR lvm.conf (5)
ارجحیت دارند. آرگومان رشته از همان ساختار
.BR lvm.conf (5)
استفاده می‌کند یا می‌تواند از قالب بخش/فیلد بهره ببرد. برای اطلاعات بیشتر درباره پیکربندی،
.BR lvm.conf (5)
را ببینید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تعیین سطح اشکال‌زدایی (دیباگ). برای افزایش جزئیات پیام‌های ارسالی به فایل گزارش وقایع (لاگ) و/یا syslog (در صورت پیکربندی)، این گزینه را از ۱ تا ۶ بار تکرار کنید.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
دستگاه‌های قابل مشاهده و در دسترس دستور را محدود می‌کند. دستگاه‌هایی که در این فهرست نباشند ناموجود در نظر گرفته می‌شوند. این گزینه می‌تواند تکرار شود یا فهرستی از دستگاه‌ها را که با کاما از هم جدا شده‌اند بپذیرد. این گزینه بر فایل devices ارجحیت دارد.
.
.HP
\fB\-\-devicesfile\fP \fIرشته\fP
.br
فایلی شامل فهرستی از دستگاه‌هایی که LVM باید استفاده کند. این فایل باید در مسیر
.I /etc/lvm/devices/
موجود باشد و با استفاده از دستور
.BR lvmdevices (8)
مدیریت می‌شود. این گزینه تنظیمات
.B devices/devicesfile
و
.B devices/use_devicesfile
در
.BR lvm.conf (5)
را بازنویسی می‌کند.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
در صورت تنظیم بر روی no یا n، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. برای آزمون و اشکال‌زدایی.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-journal\fP \fIرشته\fP
.br
ثبت اطلاعات در ژورنال systemd. این اطلاعات علاوه بر اطلاعات فعال‌شده از طریق تنظیم log/journal در lvm.conf است:
.BR command :
ثبت اطلاعات درباره دستور.
.BR output :
ثبت خروجی پیش‌فرض دستور.
.BR debug :
ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-\-lockopt\fP \fIرشته\fP
.br
برای ارسال گزینه‌ها در موارد خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر،
.BR lvmlockd (8)
را ببینید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای تفصیلی و کامل.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنما (hints) برای مکان‌یابی دستگاه‌ها برای PVها. هنگامی که از hints استفاده نشود، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها بخواند. این دستور همچنان باطل‌سازی استاندارد فایل hints را در صورت نیاز انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی ایجاد کنند.
.
.HP
\fB\-\-profile\fP \fIرشته\fP
.br
نام مستعاری برای \-\-commandprofile یا \-\-metadataprofile بسته به دستور.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی‌ها و پیام‌های گزارش وقایع. این گزینه بر \-\-debug و \-\-verbose ارجحیت دارد. تکرار مجدد آن، پاسخ خودکار «نه» (no) به هرگونه اعلان تأیید را اعمال خواهد کرد.
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
قالب فعلی خروجی گزارش‌ها را که به صورت سراسری توسط تنظیم report/output_format در
.BR lvm.conf (5)
تعریف شده است بازنویسی می‌کند. مقدار
.B basic
قالب اصلی جدول‌بندی‌شده با ستون‌ها و سطرها است. اگر بیش از یک گزارش در هر دستور وجود داشته باشد، ابتدای هر گزارش برای شناسایی، نام گزارش درج می‌شود. مقدار
.B json
خروجی گزارش را در قالب JSON تولید می‌کند. مقدار
.B json_std
خروجی گزارش را در قالب استانداردتر JSON تولید می‌کند. برای اطلاعات بیشتر،
.BR lvmreport (7)
را ببینید.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی (Test mode). در این حالت دستورات متادیتا را به‌روزرسانی نخواهند کرد. این ویژگی با غیرفعال کردن تمام عملیات نوشتن متادیتا اما در عین حال بازگرداندن وضعیت موفقیت به تابع فراخواننده پیاده‌سازی شده است. چنانچه ابزاری در عملیات‌های چندمرحله‌ای متکی به خواندن مجدد متادیتایی باشد که فرض می‌کند تغییر یافته اما تغییری نکرده است، ممکن است این امر منجر به پیام‌های خطای غیرمعمول شود.
.
.HP
\fB\-\-updatemetadata\fP
.br
به‌روزرسانی متادیتای گروه حجم (VG) برای اصلاح و رفع مشکلات.
اگر متادیتای VG در زمان غیبت یا در دسترس نبودن یک PV به‌روزرسانی شده باشد و سپس آن PV با نسخه‌ای قدیمی از متادیتا مجدداً ظاهر شود، آن‌گاه این گزینه (یا هر دستور دیگری که متادیتا می‌نویسد) متادیتا را بر روی آن PV که پیش‌تر غایب بوده است به‌روزرسانی خواهد کرد. اگر یک PV در زمان غیبت از یک VG حذف شده باشد و سپس بازگردد، استفاده از این گزینه متادیتای منسوخ را از روی آن PV غایب قبلی پاک خواهد کرد. اگر متن متادیتا روی یک PV آسیب دیده باشد، استفاده از این گزینه متن متادیتای آسیب‌دیده را جایگزین و بازسازی می‌کند. برای آسیب‌های شدیدتر، مانند آسیب به هدرها،
.BR pvck (8)
را ببینید.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تعیین سطح پرحرفی (جزئیات). برای افزایش جزئیات پیام‌های ارسالی به stdout و stderr، از ۱ تا ۴ بار تکرار کنید.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه نرم‌افزار.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تأییدیه به صورت تعاملی و پیش‌فرض در نظر گرفتن همیشگی پاسخ مثبت (yes). با احتیاط بسیار زیاد استفاده شود. (برای پاسخ منفی خودکار، گزینه \-qq را ببینید.)
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I VG
نام گروه حجم (Volume Group). برای نام‌های معتبر،
.BR lvm (8)
را ببینید.
.TP
.I Tag
نام برچسب (تگ). برای اطلاعات بیشتر درباره نام‌های برچسب و استفاده از آن‌ها به جای VG، LV یا PV،
.BR lvm (8)
را ببینید.
.TP
.I رشته
برای اطلاعات بیشتر در مورد محتوای رشته، توضیحات مربوط به هر گزینه را ببینید.
.TP
.IR اندازه [واحد]
اندازه یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد. واحدهای ورودی بدون توجه به بزرگی یا کوچکی حروف همیشه به عنوان مقادیر بر مبنای دو (باینری) در نظر گرفته می‌شوند؛ به عنوان مثال 'k' و 'K' هر دو نشان‌دهنده ۱۰۲۴ هستند. واحد ورودی پیش‌فرض با حرف و به دنبال آن |واحد مشخص می‌شود. واحد نشان‌دهنده سایر واحدهای ورودی ممکن است:
.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،
.BR lvm (8)
را ببینید. به عنوان مثال، LVM_VG_NAME معمولاً می‌تواند به جای یک پارامتر الزامی VG جایگزین شود.
.
.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)