.TH "VGSCAN" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
vgscan \- جستجو و پویش تمام دیسکها برای یافتن گروههای حجم LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBvgscan\fP [\fIگزینهها\fR]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBvgscan\fR تمام دیسکهای سیستم را برای یافتن گروههای حجم (VG) پویش کرده و در صورت فعالسازی mknodes یا cache، فایلهای دستگاه یا حافظه موقت را بهروزرسانی میکند.
.
.SH "نحوه استفاده (USAGE)"
.
\fBvgscan\fP
.br
.RS 4
.na
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-mknodes\fP ]
.br
[    \fB\-\-notifydbus\fP ]
.br
[    \fB\-\-refresh\fP ]
.br
[    \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ]
.br
[ گزینه‌های_عمومی ]
.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
تعیین نمایه دستوری (command profile) مورد استفاده جهت پیکربندی دستور. برای اطلاعات بیشتر درباره نمایه‌ها به
.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
تنظیم سطح اشکال‌زدایی (debug). تکرار از ۱ تا ۶ مرتبه جهت افزایش جزئیات پیام‌های ارسالی به فایل وقایع یا syslog (در صورت پیکربندی).
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
محدود کردن دستگاه‌های قابل مشاهده و در دسترس برای دستور. دستگاه‌هایی که در این لیست قید نشده باشند، مفقود (missing) به شمار می‌آیند. این گزینه قابلیت تکرار داشته یا فهرستی از دستگاه‌های جداشده با کاما را می‌پذیرد. این گزینه بر فایل دستگاه‌ها (devices file) اولویت دارد.
.
.HP
\fB\-\-devicesfile\fP \fIرشته\fP
.br
فایلی شامل فهرست دستگاه‌هایی که LVM باید استفاده کند. این فایل باید در مسیر
.I /etc/lvm/devices/
موجود باشد و با استفاده از دستور
.BR lvmdevices (8)
مدیریت می‌شود. این گزینه بر تنظیمات \fBdevices/devicesfile\fP و \fBdevices/use_devicesfile\fP در فایل
.BR lvm.conf (5)
ارجحیت دارد.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
اگر روی n تنظیم شود، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. برای مقاصد آزمایش و اشکال‌زدایی.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-\-ignorelockingfailure\fP
.br
امکان‌پذیر ساختن ادامه اجرای دستور با عملیات‌های فراداده فقط‌خواندنی، پس از شکست در قفل‌گذاری.
.
.HP
\fB\-\-journal\fP \fIرشته\fP
.br
ثبت اطلاعات در ژورنال systemd (systemd journal). این اطلاعات علاوه بر مواردی است که توسط تنظیم log/journal در lvm.conf فعال می‌شوند.
command: ثبت اطلاعات درباره دستور.
output: ثبت خروجی پیش‌فرض دستور.
debug: ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-\-lockopt\fP \fIرشته\fP
.br
جهت ارسال گزینه‌ها برای حالت‌های خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به
.BR lvmlockd (8)
مراجعه فرمایید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای بلند و کامل.
.
.HP
\fB\-\-mknodes\fP
.br
همچنین فایل‌های ویژه LVM در مسیر /dev را که برای حجم‌های منطقی (LVs) فعال مورد نیاز هستند بررسی می‌کند؛ موارد مفقود را ایجاد کرده و فایل‌های بلااستفاده را حذف می‌نماید. برای استفاده در محیط‌های udev، همچنین به گزینه مکمل \fB\-\-refresh\fP مراجعه نمایید.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنماها (hints file) برای یافتن دستگاه‌های مربوط به PVها. در صورت عدم استفاده از hints، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها بخواند. دستور همچنان در موارد مناسب، عملیات استاندارد باطل‌سازی فایل hints را انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال‌سازی قفل‌گذاری. با احتیاط استفاده شود، دستورات هم‌روند ممکن است نتایج نادرستی ایجاد نمایند.
.
.HP
\fB\-\-notifydbus\fP
.br
ارسال یک اعلان به D-Bus. در صورتی که LVM بدون پشتیبانی از اعلان D-Bus کامپایل شده باشد، یا تنظیم notify_dbus در پیکربندی غیرفعال باشد، دستور با خطا پایان می‌یابد.
.
.HP
\fB\-\-profile\fP \fIرشته\fP
.br
نام مستعاری برای \fB\-\-commandprofile\fP یا \fB\-\-metadataprofile\fP، بسته به نوع دستور.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشانی خروجی و پیام‌های گزارش (log). بر گزینه‌های \fB\-\-debug\fP و \fB\-\-verbose\fP اولویت دارد. تکرار برای یک‌بار همچنین هرگونه پرسش تعاملی را با پاسخ 'no' فرونشانی می‌کند.
.
.HP
\fB\-\-refresh\fP
.br
اگر LV فعال باشد، فراداده آن را دوباره بارگذاری (reload) می‌کند. در محیطی که از udev برای مدیریت محتوای مسیر /dev استفاده می‌شود، استفاده از این گزینه به‌شدت توصیه می‌شود؛ زیرا refresh همچنین رویدادهای udev را برای یک LV بازتولید می‌کند که بر اساس آن‌ها قوانین udev موجود اعمال شده تا محتوا و دسترسی‌های /dev تنظیم گردند. همچنین، این عملیات در صورت بروز مشکل یا در صورت استفاده از اشکال اشتراک‌گذاری دستی LV مفید خواهد بود.
.
.HP
\fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP
.br
قالب فعلی خروجی گزارش‌ها را که به‌صورت سراسری در تنظیمات report/output_format فایل
.BR lvm.conf (5)
تعریف شده است بازنویسی می‌کند.
\fBbasic\fP قالب اولیه همراه با سطرها و ستون‌ها است. اگر بیش از یک گزارش در هر دستور وجود داشته باشد، پیشوند هر گزارش با نام گزارش جهت شناسایی مشخص می‌شود.
\fBjson\fP خروجی گزارش را در قالب JSON تولید می‌کند.
\fBjson_std\fP خروجی گزارش را در قالب JSON سازگارتر با استاندارد JSON تولید می‌نماید.
برای اطلاعات بیشتر به
.BR lvmreport (7)
مراجعه نمایید.
.
.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
عدم پرسش تعاملی برای تایید و فرض گرفتن همیشگی پاسخ مثبت (yes). با احتیاط بسیار زیاد مصرف شود (برای پاسخ منفی خودکار، به \fB\-qq\fP رجوع فرمایید).
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I رشته
برای اطلاعات تکمیلی درباره محتوای رشته، توضیحات مربوط به گزینه را ملاحظه کنید.
.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).
(این مورد نباید با گزینه کنترل خروجی \fB\-\-units\fP اشتباه گرفته شود که در آن حروف بزرگ به مفهوم مضارب ۱۰۰۰ هستند).
.
.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)