.TH "PVSCAN" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری" . .SH "نام (NAME)" pvscan \- پویش و فهرست کردن تمام حجمهای فیزیکی در دیسکهای سیستم . .SH "خلاصه دستور (SYNOPSIS)" \fBpvscan\fP [\fIگزینهها\fR] . .SH "توضیحات (DESCRIPTION)" دستور \fBpvscan\fR تمام دیسکها و پارتیشنهای سیستم را برای یافتن حجمهای فیزیکی LVM پویش میکند و در حالت فعالسازی خودکار (--cache -aay) حجمهای منطقی مرتبط را به طور خودکار فعال میسازد. .P هنگامی که بدون گزینه .B \-\-cache فراخوانی شود، .B pvscan حجم‌های فیزیکی (PV) موجود در سیستم را مانند دستورات .BR pvs (8) یا .BR pvdisplay (8) فهرست می‌کند. .P هنگامی که از .B \-\-cache استفاده می‌شود، .B pvscan وضعیت زمان اجرای LVM را در سیستم به‌روزرسانی کرده یا همراه با .B \-aay فعال‌سازی خودکار (autoactivation) را انجام می‌دهد. .P .B pvscan \-\-cache .I دستگاه .P اگر دستگاه حضور داشته باشد، LVM ثبت می‌کند که حجم فیزیکی روی آن دستگاه برخط (online) است. اگر دستگاه حضور نداشته باشد، LVM رکورد برخط بودن آن حجم فیزیکی را حذف می‌کند. در این حالت، .B pvscan تنها همان دستگاه مشخص‌شده را بررسی و می‌خواند. .P .B pvscan \-\-cache .P وضعیت زمان اجرا را برای تمام دستگاه‌های LVM به‌روزرسانی می‌کند. .P .B pvscan \-\-cache \-aay .I دستگاه .P مراحل .B \-\-cache را برای دستگاه انجام داده، سپس بررسی می‌کند که آیا گروه حجم (VG) استفاده‌کننده از آن دستگاه کامل شده است یا خیر. در صورت کامل بودن، حجم‌های منطقی (LVs) موجود در آن VG به‌طور خودکار فعال می‌شوند؛ مشابه کاری که دستور .B vgchange \-aay vgname انجام می‌دهد (نام دستگاه می‌تواند با شماره‌های اصلی و فرعی major و minor جایگزین شود). .P .B pvscan \-\-cache \-aay .P مراحل .B \-\-cache را برای تمام دستگاه‌ها انجام داده و سپس هر VG کامل‌شده‌ای را به‌طور خودکار فعال می‌سازد. .P .B pvscan \-\-cache \-\-listvg|\-\-listlvs .I دستگاه .P مراحل .B \-\-cache را برای دستگاه انجام داده و سپس نام VG استفاده‌کننده از دستگاه یا نام‌های LVهای استفاده‌کننده از آن را چاپ می‌کند. معمولاً گزینه .B \-\-checkcomplete نیز گنجانده می‌شود تا بررسی شود آیا تمام PVهای مربوط به VG یا LVها برخط هستند یا خیر. هنگامی که این دستور توسط یک قاعده udev فراخوانی شود، خروجی باید با مشخصات قوانین udev سازگار باشد (گزینه .B \-\-udevoutput را ببینید). قاعده udev از نتایج به‌دست‌آمده برای انجام فعال‌سازی خودکار استفاده خواهد کرد. .P فعال‌سازی خودکار VGها یا LVها را می‌توان با استفاده از .B vgchange یا .B lvchange همراه با .B \-\-setautoactivation y|n فعال یا غیرفعال کرد، یا با افزودن نام‌ها به بخش .B activation/auto_activation_volume_list در فایل .BR lvm.conf (5) . .P برای اطلاعات بیشتر درباره چگونگی استفاده از pvscan جهت فعال‌سازی خودکار، به .BR lvmautoactivation (7) مراجعه کنید. . .SH "نحوه استفاده (USAGE)" . نمایش اطلاعات حجم‌های فیزیکی (PV). .br .P \fBpvscan\fP .br .RS 4 .na [ \fB\-e\fP|\fB\-\-exported\fP ] .br [ \fB\-n\fP|\fB\-\-novolumegroup\fP ] .br [ \fB\-s\fP|\fB\-\-short\fP ] .br [ \fB\-u\fP|\fB\-\-uuid\fP ] .br [ \fB\-A\fP|\fB\-\-allpvs\fP ] .br [ \fB\-\-ignorelockingfailure\fP ] .br [ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ] .br [ گزینه‌های_عمومی ] .ad .RE .P \(em .P ثبت برخط یا برون‌خط (آفلاین) بودن یک حجم فیزیکی (PV). .br .P \fBpvscan\fP \fB\-\-cache\fP .br .RS 4 .na [ \fB\-j\fP|\fB\-\-major\fP \fIشماره\fP ] .br [ \fB\-\-ignorelockingfailure\fP ] .br [ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ] .br [ \fB\-\-minor\fP \fIشماره\fP ] .br [ \fB\-\-noudevsync\fP ] .br [ گزینه‌های_عمومی ] .ad .RE .RS 4 [ \fIرشته\fP|\fIPV\fP ... ] .RE .P \(em .P ثبت برخط بودن حجم فیزیکی (PV) و فعال‌سازی خودکار گروه حجم (VG) در صورت کامل بودن. .br .P \fBpvscan\fP \fB\-\-cache\fP \fB\-a\fP|\fB\-\-activate\fP \fBay\fP .br .RS 4 .na [ \fB\-j\fP|\fB\-\-major\fP \fIشماره\fP ] .br [ \fB\-\-ignorelockingfailure\fP ] .br [ \fB\-\-reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP ] .br [ \fB\-\-minor\fP \fIشماره\fP ] .br [ \fB\-\-noudevsync\fP ] .br [ \fB\-\-autoactivation\fP \fIرشته\fP ] .br [ گزینه‌های_عمومی ] .ad .RE .RS 4 [ \fIرشته\fP|\fIPV\fP ... ] .RE .P \(em .P ثبت برخط بودن حجم فیزیکی (PV) و چاپ نام گروه حجم (VG) استفاده‌کننده از آن. .br .P \fBpvscan\fP \fB\-\-cache\fP \fB\-\-listvg\fP \fIPV\fP .br .RS 4 .na [ \fB\-\-ignorelockingfailure\fP ] .br [ \fB\-\-checkcomplete\fP ] .br [ \fB\-\-vgonline\fP ] .br [ \fB\-\-udevoutput\fP ] .br [ \fB\-\-autoactivation\fP \fIرشته\fP ] .br [ گزینه‌های_عمومی ] .ad .RE .P \(em .P ثبت برخط بودن حجم فیزیکی (PV) و چاپ نام حجم‌های منطقی (LVs) استفاده‌کننده از آن. .br .P \fBpvscan\fP \fB\-\-cache\fP \fB\-\-listlvs\fP \fIPV\fP .br .RS 4 .na [ \fB\-\-ignorelockingfailure\fP ] .br [ \fB\-\-checkcomplete\fP ] .br [ \fB\-\-vgonline\fP ] .br [ گزینه‌های_عمومی ] .ad .RE .P \(em .P فهرست کردن حجم‌های منطقی (LVs) استفاده‌کننده از حجم فیزیکی. .br .P \fBpvscan\fP \fB\-\-listlvs\fP \fIPV\fP .br .RS 4 .na [ گزینه‌های_عمومی ] .ad .RE .P \(em .P فهرست کردن گروه حجم (VG) استفاده‌کننده از حجم فیزیکی. .br .P \fBpvscan\fP \fB\-\-listvg\fP \fIPV\fP .br .RS 4 .na [ گزینه‌های_عمومی ] .ad .RE .P \(em .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\-a\fP|\fB\-\-activate\fP \fBy\fP|\fBn\fP|\fBay\fP .br فعال‌سازی خودکار حجم‌های منطقی (LVs) در یک گروه حجم (VG) هنگامی که حجم‌های فیزیکی پویش‌شده، گروه حجم را کامل کرده باشند (تنها مقدار \fBay\fP قابل اعمال است). . .HP \fB\-A\fP|\fB\-\-allpvs\fP .br نمایش اطلاعات مربوط به حجم‌های فیزیکی خارج از فایل دستگاه‌ها (devices file). شناسه دستگاه (device ID) را برای حجم‌های فیزیکی موجود در فایل دستگاه‌ها نمایش می‌دهد. . .HP \fB\-\-autoactivation\fP \fIرشته\fP .br مشخص ساختن اینکه آیا فعال‌سازی خودکار از طریق یک رویداد (event) به‌کار رفته است یا خیر. این مورد به دستور اجازه می‌دهد تنظیمات ویژه فعال‌سازی رویدادمحور را اعمال کند، مانند بهینه‌سازی‌های پویش دستگاه با به‌کارگیری فایل‌های pvs_online ایجادشده توسط pvscanهای رویدادمحور. . .HP \fB\-\-cache\fP .br پویش یک یا چند دستگاه و ثبت برخط (online) بودن آن‌ها. . .HP \fB\-\-checkcomplete\fP .br بررسی اینکه آیا تمام دستگاه‌های مورد استفاده توسط یک VG یا LV موجود هستند یا خیر، و چاپ "complete" یا "incomplete" برای هر VG یا LV فهرست‌شده. این گزینه به عنوان بخشی از فعال‌سازی خودکار رویدادمحور استفاده می‌شود؛ بنابراین اگر این گزینه مشخص شده باشد و event_activation=0 در تنظیمات پیکربندی باشد، pvscan هیچ عملیاتی انجام نخواهد داد. . .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 در صورت تنظیم بر روی no یا n، دستور تلاشی برای به‌کارگیری device-mapper نخواهد کرد. برای مقاصد آزمایشی و اشکال‌زدایی. . .HP \fB\-e\fP|\fB\-\-exported\fP .br تنها حجم‌های فیزیکی متعلق به گروه‌های حجم برون‌سپاری‌شده (exported VGs) را نمایش می‌دهد. . .HP \fB\-h\fP|\fB\-\-help\fP .br نمایش متن راهنما. . .HP \fB\-\-ignorelockingfailure\fP .br اجازه به دستور برای ادامه با عملیات فراداده فقط‌خواندنی (read-only) پس از بروز خطاهای قفل‌گذاری. . .HP \fB\-\-journal\fP \fIرشته\fP .br ثبت اطلاعات در ژورنال systemd. این اطلاعات افزون بر مواردی است که با تنظیم log/journal در lvm.conf فعال می‌شوند: .br \fBcommand\fP: ثبت اطلاعات درباره دستور. .br \fBoutput\fP: ثبت خروجی پیش‌فرض دستور. .br \fBdebug\fP: ثبت جزئیات کامل اشکال‌زدایی دستور. . .HP \fB\-\-listlvs\fP .br چاپ فهرستی از حجم‌های منطقی (LVs) که از این دستگاه استفاده می‌کنند. . .HP \fB\-\-listvg\fP .br چاپ نام گروه حجمی (VG) که از این دستگاه استفاده می‌کند. . .HP \fB\-\-lockopt\fP \fIرشته\fP .br جهت ارسال گزینه‌های موارد خاص به دیمن lvmlockd. برای اطلاعات بیشتر به .BR lvmlockd (8) مراجعه کنید. . .HP \fB\-\-longhelp\fP .br نمایش متن کامل و مفصل راهنما. . .HP \fB\-j\fP|\fB\-\-major\fP \fIشماره\fP .br شماره اصلی (major number) دستگاه. . .HP \fB\-\-minor\fP \fIشماره\fP .br شماره فرعی (minor number) دستگاه. . .HP \fB\-\-nohints\fP .br عدم استفاده از فایل راهنما (hints file) جهت مکان‌یابی دستگاه‌ها برای حجم‌های فیزیکی. در صورت عدم استفاده از فایل راهنما، دستور ممکن است برای یافتن PVها دستگاه‌های بیشتری را بخواند. دستور همچنان باطل‌سازی استاندارد فایل راهنما را در موارد لازم انجام خواهد داد. . .HP \fB\-\-nolocking\fP .br غیرفعال‌سازی قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی ایجاد نمایند. . .HP \fB\-\-noudevsync\fP .br غیرفعال‌سازی همگام‌سازی با udev. فرایند منتظر اعلان‌های udev نخواهد ماند و صرف‌نظر از هرگونه پردازش احتمالی udev در پس‌زمینه ادامه می‌یابد. تنها در صورتی از این گزینه استفاده کنید که udev در حال اجرا نباشد یا دارای قوانینی باشد که دستگاه‌های ایجادشده توسط LVM را نادیده می‌گیرند. . .HP \fB\-n\fP|\fB\-\-novolumegroup\fP .br تنها حجم‌های فیزیکی را نمایش می‌دهد که عضو هیچ گروه حجمی نیستند. . .HP \fB\-\-profile\fP \fIرشته\fP .br نام مستعاری برای \fB\-\-commandprofile\fP یا \fB\-\-metadataprofile\fP، بسته به نوع دستور. . .HP \fB\-q\fP|\fB\-\-quiet\fP ... .br جلوگیری از نمایش خروجی و پیام‌های وقایع. بر گزینه‌های \fB\-\-debug\fP و \fB\-\-verbose\fP ارجحیت دارد. تکرار یک‌باره دیگر این گزینه، تمام اعلان‌های تایید را با پاسخ خودکار «خیر» (no) همراه می‌سازد. . .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\-s\fP|\fB\-\-short\fP .br قالب فهرست‌بندی کوتاه و فشرده. . .HP \fB\-t\fP|\fB\-\-test\fP .br اجرا در حالت آزمایشی (تست). دستورات فراداده را به‌روزرسانی نخواهند کرد. این ویژگی با غیرفعال‌سازی کلیه عملیات‌های نوشتن فراداده اما برگرداندن وضعیت موفقیت به تابع فراخواننده پیاده‌سازی شده است. در عملیات‌های چندمرحله‌ای چنانچه ابزاری متکی بر خواندن مجدد فراداده‌ای باشد که تصور می‌کند تغییر یافته در حالی که تغییری نکرده است، این امر ممکن است سبب بروز پیام‌های خطای غیرمعمول گردد. . .HP \fB\-\-udevoutput\fP .br خروجی دستور تغییر می‌یابد تا قابلیت وارد شدن (import) از درون یک قاعده udev را داشته باشد. . .HP \fB\-u\fP|\fB\-\-uuid\fP .br نمایش شناسه‌های یکتا (UUID) علاوه بر نام دستگاه‌ها. . .HP \fB\-v\fP|\fB\-\-verbose\fP ... .br تنظیم سطح پرگویی (verbose). تکرار از ۱ تا ۴ مرتبه جهت افزایش میزان جزئیات پیام‌های ارسالی به خروجی استاندارد (stdout) و خطای استاندارد (stderr). . .HP \fB\-\-version\fP .br نمایش اطلاعات نسخه دستور. . .HP \fB\-\-vgonline\fP .br نخستین دستوری که یک VG کامل را مشاهده کند، آن را به شکلی منحصر‌به‌فرد گزارش می‌کند. سایر دستوراتی که آن VG کامل را مشاهده کنند، آن را به شیوه‌ای متفاوت گزارش خواهند داد. . .HP \fB\-y\fP|\fB\-\-yes\fP .br عدم پرسش تعاملی برای تایید و فرض گرفتن همیشگی پاسخ مثبت (yes). با احتیاط بسیار زیاد مصرف شود (برای پاسخ منفی خودکار، به \fB\-qq\fP رجوع فرمایید). . .SH "متغیرها (VARIABLES)" . .TP .I PV نام حجم فیزیکی (Physical Volume)، یک مسیر دستگاه در زیر شاخه /dev. برای دستوراتی که اکستنت‌های فیزیکی را مدیریت می‌کنند، یک آرگومان مکانی PV معمولاً پسوندی را می‌پذیرد که مشخص‌کننده یک محدوده (یا چند محدوده) از اکستنت‌های فیزیکی (PEs) است. هنگامی که نخستین PE حذف شود، پیش‌فرض ابتدای دستگاه خواهد بود و هنگامی که آخرین PE حذف شود، انتهای دستگاه در نظر گرفته می‌شود. محدوده آغاز و پایان (شامل هر دو): \fIPV\fP[\fB:\fP\fIPE\fP\fB\-\fP\fIPE\fP]... محدوده آغاز و طول (شمارش از ۰): \fIPV\fP[\fB:\fP\fIPE\fP\fB+\fP\fIPE\fP]... .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)