.TH "VGREMOVE" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgremove \- حذف و پاکسازی یک یا چند گروه حجم از سامانه LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgremove\fP [\fIگزینهها\fR] \fIگروه_حجم\fR...
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgremove\fR یک یا چند گروه حجم را از سیستم حذف کرده و شناسه و ساختار متادیتای آنها را پاک میسازد. اگر حجم‌های منطقی (LV) درون گروه حجم وجود داشته باشند، اعلانی برای تأیید حذف آن‌ها نمایش داده خواهد شد.
.P
اگر یک یا چند حجم فیزیکی (PV) در گروه حجم مفقود شده باشند، استفاده از دستور
.B vgreduce \-\-removemissing
را برای سازگار کردن مجدد متاداده‌های گروه حجم در نظر بگیرید.
.P
تکرار گزینه اجبار (\fB\-ff\fP) برای حذف اجباری حجم‌های منطقی درون گروه حجم بدون درخواست تأیید استفاده می‌شود.
.
.SH "نحوه استفاده (USAGE)"
.
\fBvgremove\fP \fIVG\fP|\fITag\fP|\fISelect\fP ...
.br
.RS 4
.na
[ \fB\-f\fP|\fB\-\-force\fP ]
.br
[ \fB\-S\fP|\fB\-\-select\fP \fIString\fP ]
.br
[    \fB\-\-nohistory\fP ]
.br
[    \fB\-\-noudevsync\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ COMMON_OPTIONS ]
.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 \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\-\-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\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی (دیباگ). برای افزایش جزئیات پیام‌های ارسالی به فایل لاگ یا syslog (در صورت پیکربندی) بین ۱ تا ۶ بار تکرار کنید.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
دستگاه‌های قابل مشاهده و در دسترس برای دستور را محدود می‌کند.
دستگاه‌هایی که در لیست نباشند به صورت مفقود به نظر خواهند رسید. این گزینه می‌تواند تکرار شود، یا فهرستی از دستگاه‌ها را با کاما جدا شده بپذیرد. این گزینه بر فایل دستگاه‌ها اولویت دارد.
.
.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\-f\fP|\fB\-\-force\fP ...
.br
نادیده گرفتن بررسی‌ها، تأییدیه‌ها و محافظت‌های مختلف.
با احتیاط بسیار زیاد استفاده شود.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd.
این اطلاعات علاوه بر اطلاعات فعال‌شده توسط تنظیم log/journal در lvm.conf است.
command: ثبت اطلاعات پیرامون دستور.
output: ثبت خروجی پیش‌فرض دستور.
debug: ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌های موارد خاص به lvmlockd استفاده می‌شود.
برای اطلاعات بیشتر به \fBlvmlockd\fP(8) مراجعه کنید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای طولانی.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل hints برای مکان‌یابی دستگاه‌های مربوط به PVها. در صورت عدم استفاده از hints، دستور ممکن است دستگاه‌های بیشتری را جهت یافتن PVها بخواند. این دستور همچنان باطل‌سازی استاندارد فایل hint را در صورت لزوم انجام خواهد داد.
.
.HP
\fB\-\-nohistory\fP
.br
عدم ثبت تاریخچه حجم‌های منطقی در حال حذف.
این گزینه هیچ اثری ندارد مگر اینکه تنظیم پیکربندی metadata/record_lvs_history فعال شده باشد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال کردن قفل‌گذاری. با احتیاط استفاده شود، دستورات همزمان ممکن است نتایج نادرستی تولید کنند.
.
.HP
\fB\-\-noudevsync\fP
.br
همگام‌سازی udev را غیرفعال می‌کند. فرایند منتظر اعلان از سوی udev نخواهد ماند و بدون توجه به هرگونه پردازش احتمالی udev در پس‌زمینه ادامه خواهد یافت. تنها زمانی از این گزینه استفاده کنید که udev در حال اجرا نباشد یا قواعدی داشته باشد که دستگاه‌های ایجادشده توسط LVM را نادیده بگیرد.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار (alias) برای \-\-commandprofile یا \-\-metadataprofile، بسته به دستور مورد نظر.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
سرکوب خروجی و پیام‌های گزارش (log). بر \-\-debug و \-\-verbose اولویت دارد.
با یک بار تکرار بیشتر، همچنین تمامی اعلان‌های تأیید با پاسخ پیش‌فرض 'no' سرکوب می‌شوند.
.
.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\-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\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی. دستورات متاداده را به‌روزرسانی نخواهند کرد.
این قابلیت با غیرفعال کردن تمامی عملیات نوشتن متاداده پیاده‌سازی شده است، اما با این وجود وضعیت موفقیت را به تابع فراخوان بازمی‌گرداند. در صورتی که ابزاری وابسته به خواندن متاداده‌ای باشد که تصور می‌کند تغییر یافته اما تغییری نکرده است، این امر ممکن است منجر به پیام‌های خطای غیرعادی در عملیات چندمرحله‌ای شود.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی (verbose). برای افزایش جزئیات پیام‌های ارسالی به stdout و stderr بین ۱ تا ۴ بار تکرار کنید.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تعاملی تایید و فرض همیشگی پاسخ بله. با احتیاط بسیار زیاد استفاده شود.
(برای پاسخ منفی خودکار، به \-qq مراجعه کنید.)
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I VG
نام گروه حجم (Volume Group). برای نام‌های معتبر به \fBlvm\fP(8) مراجعه کنید.
.TP
.I Tag
نام برچسب (Tag). برای اطلاعات در مورد نام‌های برچسب و استفاده از برچسب‌ها به جای VG، LV یا PV به \fBlvm\fP(8) مراجعه کنید.
.TP
.I Select
گزینه Select نشان می‌دهد که در صورت استفاده از گزینه \fB\-\-select\fP، پارامتر موضعی الزامی می‌تواند حذف شود. هیچ آرگومانی در این موقعیت ظاهر نمی‌شود.
.TP
.I String
برای کسب اطلاعات پیرامون محتوای رشته، به توضیحات گزینه مربوطه مراجعه کنید.
.TP
.IR Size [UNIT]
مقدار Size یک عدد ورودی است که یک واحد اختیاری را می‌پذیرد.
واحدهای ورودی همواره به عنوان مقادیر مبنای ۲ (دودویی) محاسبه می‌شوند، صرف‌نظر از کوچک یا بزرگ بودن حروف؛ برای نمونه هم 'k' و هم 'K' برابر با ۱۰۲۴ در نظر گرفته می‌شوند.
واحد ورودی پیش‌فرض با یک حرف و پس از آن |UNIT مشخص شده است.
عبارت UNIT نمایانگر سایر واحدهای ورودی مجاز است:
.BR b | B
بایت (Bytes)،
.BR s | S
سکتورهای ۵۱۲ بایتی (Sectors)،
.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 "مثال‌ها (EXAMPLES)"
.
حذف یک گروه حجم مشخص:
.br
.B vgremove vg00
.P
حذف یک گروه حجم به همراه حذف اجباری تمام حجم‌های منطقی درون آن بدون درخواست تأیید:
.br
.B vgremove \-ff vg00
.
.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)