نام (NAME)

lvscan - پویش و فهرست کردن تمام حجمهای منطقی موجود در سیستم

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

lvscan [گزینهها]

توضیحات (DESCRIPTION)

دستور lvscan تمام گروههای حجم و دیسکهای بلوکی پشتیبانیشده توسط LVM را برای یافتن حجمهای منطقی پویش کرده و وضعیت فعال بودن، اسنپشات یا اندازه هر کدام را چاپ میکند.

خروجی شامل یک خط به ازای هر حجم منطقی (LV) است که مواردی مانند فعال یا غیرفعال بودن آن، وضعیت اسنپ‌شات یا مبدا (origin) بودن، اندازه دستگاه و خط‌مشی تخصیص آن را مشخص می‌سازد. برای دستیابی به اطلاعات جامع‌تر و کامل‌تر درباره حجم‌های منطقی، از دستورات lvs(8) یا lvdisplay(8) استفاده کنید.

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

lvscan

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

گزینه‌ها (OPTIONS)

-a|--all
نمایش اطلاعات پیرامون حجم‌های منطقی داخلی (Internal LVs). این موارد اجزای تشکیل‌دهنده حجم‌های منطقی عادی، نظیر آینه‌ها (mirrors) هستند که به‌طور مستقل در دسترس نبوده و برای نمونه قابلیت سوار شدن (mount) ندارند.

-b|--blockdevice
دیگر استفاده نمی‌شود (منسوخ شده است).

--cache
پویش یک یا چند دستگاه و ثبت وضعیت برخط (online) آن‌ها یا به‌روزرسانی حافظه موقت (cache) و وضعیت اجرایی LVM.

--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 به عمل نمی‌آورد. کاربرد در آزمون و اشکال‌زدایی.

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

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

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

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

--longhelp
نمایش راهنمای جامع و کامل دستور.

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

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

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

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

--readonly
جلوگیری از اعمال تغییرات توسط دستور، از جمله فعال‌سازی حجم‌ها و به‌روزرسانی فراداده (برای حجم‌های منطقی فقط‌خواندنی به --permission r رجوع کنید).

--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
عدم پرسش تعاملی جهت اخذ تاییدیه و اعمال پیش‌فرض پاسخ مثبت به تمامی سوالات. با احتیاط بسیار زیاد مصرف شود (برای پاسخ منفی خودکار به -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)