.TH "LVSCAN" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
lvscan \- پویش و فهرست کردن تمام حجمهای منطقی موجود در سیستم
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBlvscan\fP [\fIگزینهها\fR]
.
.SH "توضیحات (DESCRIPTION)"
دستور \fBlvscan\fR تمام گروههای حجم و دیسکهای بلوکی پشتیبانیشده توسط LVM را برای یافتن حجمهای منطقی پویش کرده و وضعیت فعال بودن، اسنپشات یا اندازه هر کدام را چاپ میکند.
.P
خروجی شامل یک خط به ازای هر حجم منطقی (LV) است که مواردی مانند فعال یا غیرفعال بودن آن، وضعیت اسنپ‌شات یا مبدا (origin) بودن، اندازه دستگاه و خط‌مشی تخصیص آن را مشخص می‌سازد. برای دستیابی به اطلاعات جامع‌تر و کامل‌تر درباره حجم‌های منطقی، از دستورات
.BR lvs (8)
یا
.BR lvdisplay (8)
استفاده کنید.
.
.SH "نحوه استفاده (USAGE)"
.
\fBlvscan\fP
.br
.RS 4
.na
[ \fB\-a\fP|\fB\-\-all\fP ]
.br
[ \fB\-b\fP|\fB\-\-blockdevice\fP ]
.br
[    \fB\-\-cache\fP ]
.br
[    \fB\-\-ignorelockingfailure\fP ]
.br
[    \fB\-\-readonly\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\-a\fP|\fB\-\-all\fP
.br
نمایش اطلاعات پیرامون حجم‌های منطقی داخلی (Internal LVs). این موارد اجزای تشکیل‌دهنده حجم‌های منطقی عادی، نظیر آینه‌ها (mirrors) هستند که به‌طور مستقل در دسترس نبوده و برای نمونه قابلیت سوار شدن (mount) ندارند.
.
.HP
\fB\-b\fP|\fB\-\-blockdevice\fP
.br
دیگر استفاده نمی‌شود (منسوخ شده است).
.
.HP
\fB\-\-cache\fP
.br
پویش یک یا چند دستگاه و ثبت وضعیت برخط (online) آن‌ها یا به‌روزرسانی حافظه موقت (cache) و وضعیت اجرایی LVM.
.
.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\-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\-\-lockopt\fP \fIرشته\fP
.br
جهت ارسال گزینه‌های موارد ویژه به دیمن lvmlockd. برای اطلاعات بیشتر به
.BR lvmlockd (8)
مراجعه نمایید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش راهنمای جامع و کامل دستور.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنما (hints file) جهت مکان‌یابی دستگاه‌ها برای حجم‌های فیزیکی (PV). عدم بهره‌گیری از فایل راهنما ممکن است سبب شود دستور برای یافتن PVها دستگاه‌های بیشتری را اسکن کند. در صورت لزوم، دستور همچنان باطل‌سازی استاندارد فایل راهنما را انجام خواهد داد.
.
.HP
\fB\-\-nolocking\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\-\-readonly\fP
.br
جلوگیری از اعمال تغییرات توسط دستور، از جمله فعال‌سازی حجم‌ها و به‌روزرسانی فراداده (برای حجم‌های منطقی فقط‌خواندنی به \fB\-\-permission r\fP رجوع کنید).
.
.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
عدم پرسش تعاملی جهت اخذ تاییدیه و اعمال پیش‌فرض پاسخ مثبت به تمامی سوالات. با احتیاط بسیار زیاد مصرف شود (برای پاسخ منفی خودکار به \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)