.TH "LVM-LVPOLL" "8" "مه ۲۰۲۵" "lvm2" "دستورهای مدیریتی و نگهداری"
.
.SH "نام (NAME)"
lvm-lvpoll \- ادامه و نظارت بر عملیات پیمایش و تبدیل روی حجمهای منطقی LVM
.
.SH "خلاصه دستور (SYNOPSIS)"
\fBlvm lvpoll\fP \fB\-\-polloperation\fP \fIعملیات\fP \fIحجم_منطقی\fP
.
.SH "توضیحات (DESCRIPTION)"
دستور داخلی \fBlvm lvpoll\fR توسط سرویس lvmpolld برای نظارت بر اتمام عملیات طولانی مانند تبدیل آینهای (lvconvert) و انتقال دادهها (pvmove) استفاده میشود.
خود \fBlvpoll\fP این عملیات را آغاز نمی‌کند و در حالت عادی نیازی به اجرای مستقیم آن توسط کاربر نیست.
.
.SH "نحوه استفاده (USAGE)"
.
\fBlvm lvpoll\fP \fB\-\-polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP \fILV\fP ...
.br
.RS 4
.na
[ \fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP ]
.br
[ \fB\-i\fP|\fB\-\-interval\fP \fINumber\fP ]
.br
[    \fB\-\-abort\fP ]
.br
[    \fB\-\-handlemissingpvs\fP ]
.br
[ COMMON_OPTIONS ]
.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 \fIString\fP ]
.br
[    \fB\-\-config\fP \fIString\fP ]
.br
[    \fB\-\-devices\fP \fIPV\fP ]
.br
[    \fB\-\-devicesfile\fP \fIString\fP ]
.br
[    \fB\-\-driverloaded\fP \fBy\fP|\fBn\fP ]
.br
[    \fB\-\-journal\fP \fIString\fP ]
.br
[    \fB\-\-lockopt\fP \fIString\fP ]
.br
[    \fB\-\-longhelp\fP ]
.br
[    \fB\-\-nohints\fP ]
.br
[    \fB\-\-nolocking\fP ]
.br
[    \fB\-\-profile\fP \fIString\fP ]
.br
[    \fB\-\-version\fP ]
.ad
.RE
.
.SH "گزینه‌ها (OPTIONS)"
.
.HP
\fB\-\-abort\fP
.br
توقف پردازش یک عملیات پیمایش در lvmpolld.
.
.HP
\fB\-A\fP|\fB\-\-autobackup\fP \fBy\fP|\fBn\fP
.br
مشخص می‌کند که آیا فراداده‌ها پس از تغییر باید به طور خودکار پشتیبان‌گیری شوند یا خیر.
فعال‌سازی این گزینه اکیداً توصیه می‌شود!
برای اطلاعات بیشتر \fBvgcfgbackup\fP(8) را ببینید.
.
.HP
\fB\-\-commandprofile\fP \fIString\fP
.br
نمایه دستور مورد استفاده برای پیکربندی دستور.
برای اطلاعات بیشتر درباره نمایه‌ها \fBlvm.conf\fP(5) را ببینید.
.
.HP
\fB\-\-config\fP \fIString\fP
.br
تنظیمات پیکربندی برای دستور. این تنظیمات بر مقادیر \fBlvm.conf\fP(5) تقدم دارند.
آرگومان String از همان قالب \fBlvm.conf\fP(5) استفاده می‌کند، یا می‌تواند از نحو بخش/فیلد استفاده کند.
برای اطلاعات بیشتر درباره پیکربندی \fBlvm.conf\fP(5) را ببینید.
.
.HP
\fB\-d\fP|\fB\-\-debug\fP ...
.br
تنظیم سطح اشکال‌زدایی. از ۱ تا ۶ بار تکرار کنید تا جزئیات پیام‌های ارسالی به فایل لاگ و/یا syslog (در صورت پیکربندی) افزایش یابد.
.
.HP
\fB\-\-devices\fP \fIPV\fP
.br
دستگاه‌هایی را که برای دستور قابل مشاهده و دسترسی هستند محدود می‌کند.
دستگاه‌هایی که در فهرست نباشند به عنوان مفقود ظاهر می‌شوند. این گزینه می‌تواند تکرار شود، یا یک فهرست از دستگاه‌ها با کاما جدا شده را می‌پذیرد. این گزینه بر فایل دستگاه‌ها تقدم دارد.
.
.HP
\fB\-\-devicesfile\fP \fIString\fP
.br
فایلی حاوی فهرست دستگاه‌هایی که LVM باید استفاده کند.
این فایل باید در \fI/etc/lvm/devices/\fP موجود باشد و با دستور \fBlvmdevices\fP(8) مدیریت می‌شود.
این تنظیمات بر \fBdevices/devicesfile\fP و \fBdevices/use_devicesfile\fP در \fBlvm.conf\fP(5) تقدم دارد.
.
.HP
\fB\-\-driverloaded\fP \fBy\fP|\fBn\fP
.br
اگر بر روی no تنظیم شود، دستور تلاشی برای استفاده از device-mapper نخواهد کرد.
برای آزمایش و اشکال‌زدایی.
.
.HP
\fB\-\-handlemissingpvs\fP
.br
امکان ادامه عملیات پیمایش را در صورت مفقود بودن PVها فراهم می‌کند، به عنوان مثال برای تعمیرات ناشی از دستگاه‌های معیوب.
.
.HP
\fB\-h\fP|\fB\-\-help\fP
.br
نمایش متن راهنما.
.
.HP
\fB\-i\fP|\fB\-\-interval\fP \fINumber\fP
.br
گزارش میزان پیشرفت در فواصل زمانی منظم.
.
.HP
\fB\-\-journal\fP \fIString\fP
.br
ثبت اطلاعات در ژورنال systemd.
این اطلاعات علاوه بر اطلاعات فعال‌شده با تنظیم log/journal در lvm.conf است.
command: ثبت اطلاعات درباره دستور.
output: ثبت خروجی پیش‌فرض دستور.
debug: ثبت اشکال‌زدایی کامل دستور.
.
.HP
\fB\-\-lockopt\fP \fIString\fP
.br
برای ارسال گزینه‌های موارد خاص به lvmlockd استفاده می‌شود.
برای اطلاعات بیشتر \fBlvmlockd\fP(8) را ببینید.
.
.HP
\fB\-\-longhelp\fP
.br
نمایش متن راهنمای جامع.
.
.HP
\fB\-\-nohints\fP
.br
عدم استفاده از فایل راهنما (hints) برای یافتن دستگاه‌های مربوط به PVها. در صورت عدم استفاده از راهنماها، دستور ممکن است دستگاه‌های بیشتری را برای یافتن PVها بخواند. دستور همچنان ابطال استاندارد فایل راهنما را در صورت لزوم انجام خواهد داد.
.
.HP
\fB\-\-nolocking\fP
.br
غیرفعال‌سازی قفل‌گذاری. با احتیاط استفاده شود؛ دستورات همزمان ممکن است نتایج نادرستی ایجاد کنند.
.
.HP
\fB\-\-polloperation\fP \fBpvmove\fP|\fBconvert\fP|\fBmerge\fP|\fBmerge_thin\fP
.br
دستوری که باید از طریق lvmpolld انجام شود.
.
.HP
\fB\-\-profile\fP \fIString\fP
.br
نام مستعار برای \-\-commandprofile یا \-\-metadataprofile بسته به نوع دستور.
.
.HP
\fB\-q\fP|\fB\-\-quiet\fP ...
.br
فرونشاندن خروجی و پیام‌های گزارش. بر \-\-debug و \-\-verbose تقدم دارد.
یک بار تکرار کنید تا هرگونه پرسش تاییدیه با پاسخ 'no' نیز فرونشانده شود.
.
.HP
\fB\-t\fP|\fB\-\-test\fP
.br
اجرا در حالت آزمایشی. دستورات فراداده‌ها را به‌روزرسانی نخواهند کرد.
این قابلیت با غیرفعال کردن تمامی عملیات نوشتن فراداده و با این حال بازگرداندن وضعیت موفقیت به تابع فراخواننده پیاده‌سازی شده است. این امر ممکن است در عملیات چندمرحله‌ای چنانچه ابزاری به بازخوانی فراداده‌هایی که فکر می‌کند تغییر کرده‌اند اما تغییر نکرده‌اند تکیه کند، منجر به پیام‌های خطای غیرمعمول شود.
.
.HP
\fB\-v\fP|\fB\-\-verbose\fP ...
.br
تنظیم سطح پرگویی. از ۱ تا ۴ بار تکرار کنید تا جزئیات پیام‌های ارسالی به stdout و stderr افزایش یابد.
.
.HP
\fB\-\-version\fP
.br
نمایش اطلاعات نسخه.
.
.HP
\fB\-y\fP|\fB\-\-yes\fP
.br
عدم درخواست تایید به صورت تعاملی و در نظر گرفتن همیشگی پاسخ مثبت. با احتیاط بسیار زیاد استفاده شود.
(برای پاسخ منفی خودکار، \-qq را ببینید.)
.
.SH "متغیرها (VARIABLES)"
.
.TP
.I LV
نام حجم منطقی (Logical Volume). برای نام‌های معتبر \fBlvm\fP(8) را ببینید.
یک آرگومان مکانی LV به طور کلی شامل نام VG و نام LV است، مانند VG/LV.
.TP
.I String
برای اطلاعات درباره محتوای رشته به توضیحات گزینه مربوطه مراجعه کنید.
.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).
(این مورد نباید با گزینه کنترل خروجی \-\-units اشتباه گرفته شود که در آن حروف بزرگ به معنای مضرب‌های ۱۰۰۰ هستند.)
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
برای اطلاعات درباره متغیرهای محیطی مورد استفاده lvm به \fBlvm\fP(8) مراجعه کنید.
به عنوان مثال، LVM_VG_NAME معمولاً می‌تواند به جای پارامتر الزامی VG جایگزین شود.
.
.SH "نکات (NOTES)"
.
برای یافتن نام LV مربوط به pvmove که توسط دستور اصلی
\fBpvmove /dev/name\fP
ایجاد شده است، از دستور زیر استفاده کنید:
.br
\fBlvs \-a \-S move_pv=/dev/name\fP
.
.SH "مثال‌ها (EXAMPLES)"
.
ادامه پیمایش یک عملیات pvmove:
.br
.B lvm lvpoll \-\-polloperation pvmove vg00/pvmove0
.P
لغو یک عملیات pvmove:
.br
.B lvm lvpoll \-\-polloperation pvmove \-\-abort vg00/pvmove0
.P
ادامه پیمایش تبدیل آینه‌ای:
.br
.B lvm lvpoll \-\-polloperation convert vg00/lvmirror
.P
ادامه تعمیر آینه‌ای:
.br
.B lvm lvpoll \-\-polloperation convert vg/damaged_mirror \-\-handlemissingpvs
.P
ادامه ادغام تصویر لحظه‌ای:
.br
.B lvm lvpoll \-\-polloperation merge vg/snapshot_old
.P
ادامه ادغام تصویر لحظه‌ای کم‌حجم (thin snapshot merge):
.br
.B lvm lvpoll \-\-polloperation merge_thin vg/thin_snapshot
.
.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)