نام (NAME)

pvscan - پویش و فهرست کردن تمام حجمهای فیزیکی در دیسکهای سیستم

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

pvscan [گزینهها]

توضیحات (DESCRIPTION)

دستور pvscan تمام دیسکها و پارتیشنهای سیستم را برای یافتن حجمهای فیزیکی LVM پویش میکند و در حالت فعالسازی خودکار (--cache -aay) حجمهای منطقی مرتبط را به طور خودکار فعال میسازد.

هنگامی که بدون گزینه --cache فراخوانی شود، pvscan حجم‌های فیزیکی (PV) موجود در سیستم را مانند دستورات pvs(8) یا pvdisplay(8) فهرست می‌کند.

هنگامی که از --cache استفاده می‌شود، pvscan وضعیت زمان اجرای LVM را در سیستم به‌روزرسانی کرده یا همراه با -aay فعال‌سازی خودکار (autoactivation) را انجام می‌دهد.

pvscan --cache دستگاه

اگر دستگاه حضور داشته باشد، LVM ثبت می‌کند که حجم فیزیکی روی آن دستگاه برخط (online) است. اگر دستگاه حضور نداشته باشد، LVM رکورد برخط بودن آن حجم فیزیکی را حذف می‌کند. در این حالت، pvscan تنها همان دستگاه مشخص‌شده را بررسی و می‌خواند.

pvscan --cache

وضعیت زمان اجرا را برای تمام دستگاه‌های LVM به‌روزرسانی می‌کند.

pvscan --cache -aay دستگاه

مراحل --cache را برای دستگاه انجام داده، سپس بررسی می‌کند که آیا گروه حجم (VG) استفاده‌کننده از آن دستگاه کامل شده است یا خیر. در صورت کامل بودن، حجم‌های منطقی (LVs) موجود در آن VG به‌طور خودکار فعال می‌شوند؛ مشابه کاری که دستور vgchange -aay vgname انجام می‌دهد (نام دستگاه می‌تواند با شماره‌های اصلی و فرعی major و minor جایگزین شود).

pvscan --cache -aay

مراحل --cache را برای تمام دستگاه‌ها انجام داده و سپس هر VG کامل‌شده‌ای را به‌طور خودکار فعال می‌سازد.

pvscan --cache --listvg|--listlvs دستگاه

مراحل --cache را برای دستگاه انجام داده و سپس نام VG استفاده‌کننده از دستگاه یا نام‌های LVهای استفاده‌کننده از آن را چاپ می‌کند. معمولاً گزینه --checkcomplete نیز گنجانده می‌شود تا بررسی شود آیا تمام PVهای مربوط به VG یا LVها برخط هستند یا خیر. هنگامی که این دستور توسط یک قاعده udev فراخوانی شود، خروجی باید با مشخصات قوانین udev سازگار باشد (گزینه --udevoutput را ببینید). قاعده udev از نتایج به‌دست‌آمده برای انجام فعال‌سازی خودکار استفاده خواهد کرد.

فعال‌سازی خودکار VGها یا LVها را می‌توان با استفاده از vgchange یا lvchange همراه با --setautoactivation y|n فعال یا غیرفعال کرد، یا با افزودن نام‌ها به بخش activation/auto_activation_volume_list در فایل lvm.conf(5).

برای اطلاعات بیشتر درباره چگونگی استفاده از pvscan جهت فعال‌سازی خودکار، به lvmautoactivation(7) مراجعه کنید.

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

نمایش اطلاعات حجم‌های فیزیکی (PV).

pvscan

—

ثبت برخط یا برون‌خط (آفلاین) بودن یک حجم فیزیکی (PV).

pvscan --cache

—

ثبت برخط بودن حجم فیزیکی (PV) و فعال‌سازی خودکار گروه حجم (VG) در صورت کامل بودن.

pvscan --cache -a|--activate ay

—

ثبت برخط بودن حجم فیزیکی (PV) و چاپ نام گروه حجم (VG) استفاده‌کننده از آن.

pvscan --cache --listvg PV

—

ثبت برخط بودن حجم فیزیکی (PV) و چاپ نام حجم‌های منطقی (LVs) استفاده‌کننده از آن.

pvscan --cache --listlvs PV

—

فهرست کردن حجم‌های منطقی (LVs) استفاده‌کننده از حجم فیزیکی.

pvscan --listlvs PV

—

فهرست کردن گروه حجم (VG) استفاده‌کننده از حجم فیزیکی.

pvscan --listvg PV

—

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

گزینه‌ها (OPTIONS)

-a|--activate y|n|ay
فعال‌سازی خودکار حجم‌های منطقی (LVs) در یک گروه حجم (VG) هنگامی که حجم‌های فیزیکی پویش‌شده، گروه حجم را کامل کرده باشند (تنها مقدار ay قابل اعمال است).

-A|--allpvs
نمایش اطلاعات مربوط به حجم‌های فیزیکی خارج از فایل دستگاه‌ها (devices file). شناسه دستگاه (device ID) را برای حجم‌های فیزیکی موجود در فایل دستگاه‌ها نمایش می‌دهد.

--autoactivation رشته
مشخص ساختن اینکه آیا فعال‌سازی خودکار از طریق یک رویداد (event) به‌کار رفته است یا خیر. این مورد به دستور اجازه می‌دهد تنظیمات ویژه فعال‌سازی رویدادمحور را اعمال کند، مانند بهینه‌سازی‌های پویش دستگاه با به‌کارگیری فایل‌های pvs_online ایجادشده توسط pvscanهای رویدادمحور.

--cache
پویش یک یا چند دستگاه و ثبت برخط (online) بودن آن‌ها.

--checkcomplete
بررسی اینکه آیا تمام دستگاه‌های مورد استفاده توسط یک VG یا LV موجود هستند یا خیر، و چاپ "complete" یا "incomplete" برای هر VG یا LV فهرست‌شده. این گزینه به عنوان بخشی از فعال‌سازی خودکار رویدادمحور استفاده می‌شود؛ بنابراین اگر این گزینه مشخص شده باشد و event_activation=0 در تنظیمات پیکربندی باشد، pvscan هیچ عملیاتی انجام نخواهد داد.

--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
در صورت تنظیم بر روی no یا n، دستور تلاشی برای به‌کارگیری device-mapper نخواهد کرد. برای مقاصد آزمایشی و اشکال‌زدایی.

-e|--exported
تنها حجم‌های فیزیکی متعلق به گروه‌های حجم برون‌سپاری‌شده (exported VGs) را نمایش می‌دهد.

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

--ignorelockingfailure
اجازه به دستور برای ادامه با عملیات فراداده فقط‌خواندنی (read-only) پس از بروز خطاهای قفل‌گذاری.

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

--listlvs
چاپ فهرستی از حجم‌های منطقی (LVs) که از این دستگاه استفاده می‌کنند.

--listvg
چاپ نام گروه حجمی (VG) که از این دستگاه استفاده می‌کند.

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

--longhelp
نمایش متن کامل و مفصل راهنما.

-j|--major شماره
شماره اصلی (major number) دستگاه.

--minor شماره
شماره فرعی (minor number) دستگاه.

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

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

--noudevsync
غیرفعال‌سازی همگام‌سازی با udev. فرایند منتظر اعلان‌های udev نخواهد ماند و صرف‌نظر از هرگونه پردازش احتمالی udev در پس‌زمینه ادامه می‌یابد. تنها در صورتی از این گزینه استفاده کنید که udev در حال اجرا نباشد یا دارای قوانینی باشد که دستگاه‌های ایجادشده توسط LVM را نادیده می‌گیرند.

-n|--novolumegroup
تنها حجم‌های فیزیکی را نمایش می‌دهد که عضو هیچ گروه حجمی نیستند.

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

-q|--quiet ...
جلوگیری از نمایش خروجی و پیام‌های وقایع. بر گزینه‌های --debug و --verbose ارجحیت دارد. تکرار یک‌باره دیگر این گزینه، تمام اعلان‌های تایید را با پاسخ خودکار «خیر» (no) همراه می‌سازد.

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

-s|--short
قالب فهرست‌بندی کوتاه و فشرده.

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

--udevoutput
خروجی دستور تغییر می‌یابد تا قابلیت وارد شدن (import) از درون یک قاعده udev را داشته باشد.

-u|--uuid
نمایش شناسه‌های یکتا (UUID) علاوه بر نام دستگاه‌ها.

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

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

--vgonline
نخستین دستوری که یک VG کامل را مشاهده کند، آن را به شکلی منحصر‌به‌فرد گزارش می‌کند. سایر دستوراتی که آن VG کامل را مشاهده کنند، آن را به شیوه‌ای متفاوت گزارش خواهند داد.

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

متغیرها (VARIABLES)

PV

نام حجم فیزیکی (Physical Volume)، یک مسیر دستگاه در زیر شاخه /dev. برای دستوراتی که اکستنت‌های فیزیکی را مدیریت می‌کنند، یک آرگومان مکانی PV معمولاً پسوندی را می‌پذیرد که مشخص‌کننده یک محدوده (یا چند محدوده) از اکستنت‌های فیزیکی (PEs) است. هنگامی که نخستین PE حذف شود، پیش‌فرض ابتدای دستگاه خواهد بود و هنگامی که آخرین PE حذف شود، انتهای دستگاه در نظر گرفته می‌شود. محدوده آغاز و پایان (شامل هر دو): PV[:PE-PE]... محدوده آغاز و طول (شمارش از ۰): PV[:PE+PE]...

رشته

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

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)