نام (NAME)

vgscan - جستجو و پویش تمام دیسکها برای یافتن گروههای حجم LVM

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

vgscan [گزینهها]

توضیحات (DESCRIPTION)

دستور vgscan تمام دیسکهای سیستم را برای یافتن گروههای حجم (VG) پویش کرده و در صورت فعالسازی mknodes یا cache، فایلهای دستگاه یا حافظه موقت را بهروزرسانی میکند.

نحوه استفاده (USAGE)

vgscan

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

گزینه‌ها (OPTIONS)

--commandprofile رشته
تعیین نمایه دستوری (command profile) مورد استفاده جهت پیکربندی دستور. برای اطلاعات بیشتر درباره نمایه‌ها به lvm.conf(5) مراجعه کنید.

--config رشته
تنظیمات پیکربندی برای دستور. این مقادیر بر تنظیمات فایل lvm.conf(5) ارجحیت دارند. آرگومان رشته از همان قالب lvm.conf(5) یا ساختار بخش/فیلد پیروی می‌کند. برای اطلاعات بیشتر در خصوص پیکربندی به lvm.conf(5) مراجعه نمایید.

-d|--debug ...
تنظیم سطح اشکال‌زدایی (debug). تکرار از ۱ تا ۶ مرتبه جهت افزایش جزئیات پیام‌های ارسالی به فایل وقایع یا syslog (در صورت پیکربندی).

--devices PV
محدود کردن دستگاه‌های قابل مشاهده و در دسترس برای دستور. دستگاه‌هایی که در این لیست قید نشده باشند، مفقود (missing) به شمار می‌آیند. این گزینه قابلیت تکرار داشته یا فهرستی از دستگاه‌های جداشده با کاما را می‌پذیرد. این گزینه بر فایل دستگاه‌ها (devices file) اولویت دارد.

--devicesfile رشته
فایلی شامل فهرست دستگاه‌هایی که LVM باید استفاده کند. این فایل باید در مسیر /etc/lvm/devices/ موجود باشد و با استفاده از دستور lvmdevices(8) مدیریت می‌شود. این گزینه بر تنظیمات devices/devicesfile و devices/use_devicesfile در فایل lvm.conf(5) ارجحیت دارد.

--driverloaded y|n
اگر روی n تنظیم شود، دستور تلاشی برای استفاده از device-mapper نخواهد کرد. برای مقاصد آزمایش و اشکال‌زدایی.

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

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

--journal رشته
ثبت اطلاعات در ژورنال systemd (systemd journal). این اطلاعات علاوه بر مواردی است که توسط تنظیم log/journal در lvm.conf فعال می‌شوند. command: ثبت اطلاعات درباره دستور. output: ثبت خروجی پیش‌فرض دستور. debug: ثبت اشکال‌زدایی کامل دستور.

--lockopt رشته
جهت ارسال گزینه‌ها برای حالت‌های خاص به lvmlockd استفاده می‌شود. برای اطلاعات بیشتر به lvmlockd(8) مراجعه فرمایید.

--longhelp
نمایش متن راهنمای بلند و کامل.

--mknodes
همچنین فایل‌های ویژه LVM در مسیر /dev را که برای حجم‌های منطقی (LVs) فعال مورد نیاز هستند بررسی می‌کند؛ موارد مفقود را ایجاد کرده و فایل‌های بلااستفاده را حذف می‌نماید. برای استفاده در محیط‌های udev، همچنین به گزینه مکمل --refresh مراجعه نمایید.

--nohints
عدم استفاده از فایل راهنماها (hints file) برای یافتن دستگاه‌های مربوط به PVها. در صورت عدم استفاده از hints، ممکن است دستور دستگاه‌های بیشتری را برای یافتن PVها بخواند. دستور همچنان در موارد مناسب، عملیات استاندارد باطل‌سازی فایل hints را انجام خواهد داد.

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

--notifydbus
ارسال یک اعلان به D-Bus. در صورتی که LVM بدون پشتیبانی از اعلان D-Bus کامپایل شده باشد، یا تنظیم notify_dbus در پیکربندی غیرفعال باشد، دستور با خطا پایان می‌یابد.

--profile رشته
نام مستعاری برای --commandprofile یا --metadataprofile، بسته به نوع دستور.

-q|--quiet ...
فرونشانی خروجی و پیام‌های گزارش (log). بر گزینه‌های --debug و --verbose اولویت دارد. تکرار برای یک‌بار همچنین هرگونه پرسش تعاملی را با پاسخ 'no' فرونشانی می‌کند.

--refresh
اگر LV فعال باشد، فراداده آن را دوباره بارگذاری (reload) می‌کند. در محیطی که از udev برای مدیریت محتوای مسیر /dev استفاده می‌شود، استفاده از این گزینه به‌شدت توصیه می‌شود؛ زیرا refresh همچنین رویدادهای udev را برای یک LV بازتولید می‌کند که بر اساس آن‌ها قوانین udev موجود اعمال شده تا محتوا و دسترسی‌های /dev تنظیم گردند. همچنین، این عملیات در صورت بروز مشکل یا در صورت استفاده از اشکال اشتراک‌گذاری دستی LV مفید خواهد بود.

--reportformat basic|json|json_std
قالب فعلی خروجی گزارش‌ها را که به‌صورت سراسری در تنظیمات report/output_format فایل lvm.conf(5) تعریف شده است بازنویسی می‌کند. basic قالب اولیه همراه با سطرها و ستون‌ها است. اگر بیش از یک گزارش در هر دستور وجود داشته باشد، پیشوند هر گزارش با نام گزارش جهت شناسایی مشخص می‌شود. json خروجی گزارش را در قالب JSON تولید می‌کند. json_std خروجی گزارش را در قالب JSON سازگارتر با استاندارد JSON تولید می‌نماید. برای اطلاعات بیشتر به lvmreport(7) مراجعه نمایید.

-t|--test
اجرا در حالت آزمایشی (تست). دستورات فراداده را به‌روزرسانی نخواهند کرد. این ویژگی با غیرفعال‌سازی کلیه عملیات‌های نوشتن فراداده اما برگرداندن وضعیت موفقیت به تابع فراخواننده پیاده‌سازی شده است. در عملیات‌های چندمرحله‌ای چنانچه ابزاری متکی بر خواندن مجدد فراداده‌ای باشد که تصور می‌کند تغییر یافته در حالی که تغییری نکرده است، این امر ممکن است سبب بروز پیام‌های خطای غیرمعمول گردد.

-v|--verbose ...
تنظیم سطح پرگویی (verbose). تکرار از ۱ تا ۴ مرتبه جهت افزایش میزان جزئیات پیام‌های ارسالی به خروجی استاندارد (stdout) و خطای استاندارد (stderr).

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

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

متغیرها (VARIABLES)

رشته

برای اطلاعات تکمیلی درباره محتوای رشته، توضیحات مربوط به گزینه را ملاحظه کنید.

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 جایگزین شود.

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