.TH DMEVENTD 8 "DM TOOLS 2.03.42(2) (2026-08-06)" "Red Hat, Inc." \" -*- nroff -*-
.
.de NSY
.  ie t .SY \\$1
.  el \{\
.    ie \\n(.$>1 \{\
.      PD 0
.      TP \\w'\\$1\ 'u
.    \}
.    el .TP
.    B \\$1
.    nh
.    na
.  \}
..
.
.SH "نام (NAME)"
.
dmeventd \- دیمن مانیتورینگ رویدادهای Device-Mapper
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.NSY dmeventd 1
.RB [ \-d
.RB [ \-d
.RB [ \-d ]]]
.RB [ \-e\ \c
.IR exit_on_path ]
.RB [ \-f ]
.RB [ \-g\ \c
.IR seconds ]
.RB [ \-h ]
.RB [ \-i ]
.RB [ \-l ]
.RB [ \-R ]
.RB [ \-V ]
.RB [ \-? ]
.
.PD
.ad
.hy
.
.SH "توضیحات (DESCRIPTION)"
.
.B dmeventd
دیمن مانیتورینگ و پایش رویدادها برای دستگاه‌های نگاشتگر دستگاه (device-mapper) است.
پلاگین‌های کتابخانه‌ای می‌توانند ثبت‌نام کرده و هنگام وقوع رویدادهای خاص، اقداماتی
را به مرحله اجرا درآورند.
.
.SH "گزینه‌ها (OPTIONS)"
.
.TP
.B \-d
تکرار از ۱ تا ۳ بار
.RB ( \-d ,
.BR \-dd ,
.BR \-ddd )
برای افزایش جزئیات پیام‌های اشکال‌زدایی (debug) ارسال‌شده به
.BR syslog .
هر
.B d
اضافی اطلاعات اشکال‌زدایی بیشتری می‌افزاید.
.
.TP
\fB\-e\fP \fIexit_on_path\fP
مسیر فایلی را مشخص می‌کند که هنگام دریافت سیگنال
.RB ( SIGINT ,
.BR SIGTERM )
وجود آن توسط دیمن بررسی می‌شود و به آن اجازه می‌دهد حتی در صورت وجود
دستگاه‌های همچنان تحت پایش، خارج شود.
این گزینه می‌تواند در زمان خاموش شدن سیستم که دستگاه‌ها به درستی از حالت پایش
خارج نشده‌اند کمک کند.
برای غیرفعال کردن این رفتار، آن را روی رشته خالی "" تنظیم کنید.
مقدار پیش‌فرض
"\fI/run/nologin\fP"
است.
.
.TP
.B \-f
انشعاب ایجاد نشود (Don't fork)؛ اجرا در پیش‌زمینه.
.
.TP
\fB\-g\fP \fIseconds\fP
تعیین دوره مهلت (grace period) برای پاک‌سازی ریسه‌های مانیتورینگ (۰\-۳۰۰ ثانیه، پیش‌فرض: ۱۰).
در طول این دوره، ریسه‌های پایشی که پردازش رویدادها را به پایان رسانده‌اند، به جای خاتمه فوری،
منتظر استفاده مجدد احتمالی می‌مانند.
اگر همان ترکیب دستگاه و پلاگین دوباره در طول دوره مهلت ثبت شود، از ریسه موجود مجدداً استفاده
می‌شود که بار اضافی (overhead) را به‌طور چشمگیری کاهش می‌دهد. برای غیرفعال کردن استفاده مجدد از ریسه،
مقدار را روی ۰ قرار دهید.
.
.TP
.B \-h
نمایش اطلاعات راهنما.
.
.TP
.B \-i
استعلام اطلاعات وضعیت از نمونه دیمن در حال اجرا. قالب این اطلاعات داخلی و ناپایدار
بوده و برای توسعه‌دهندگان در نظر گرفته شده است.
قالب ممکن است میان نسخه‌های مختلف تغییر کند.
.
.TP
.B \-l
ثبت گزارش‌ها از طریق stdout و stderr به جای syslog.
این گزینه فقط همراه با گزینه
.B \-f
کار می‌کند، در غیر این صورت نادیده گرفته می‌شود.
.
.TP
.B \-?
نمایش اطلاعات راهنما در stderr.
.
.TP
.B \-R
جایگزینی یک نمونه در حال اجرای dmeventd. نسخه dmeventd در حال اجرا باید
2.02.77 یا جدیدتر باشد. نمونه جدید dmeventd فهرست دستگاه‌ها و رویدادهای
تحت پایش را از دیمن در حال اجرای فعلی دریافت خواهد کرد.
.
.TP
.B \-V
نمایش نسخه dmeventd.
.
.SH "پلاگین‌های LVM (LVM PLUGINS)"
.
.TP
.B Mirror
تلاش برای مدیریت خودکار خرابی دستگاه.
ببینید:
.BR lvm.conf (5).
.
.TP
.B Raid
تلاش برای مدیریت خودکار خرابی دستگاه.
ببینید:
.BR lvm.conf (5).
.
.TP
.B Snapshot
میزان پر شدن یک تصویر لحظه‌ای (snapshot) را پایش کرده و هنگامی که از ۸۰٪ فراتر رود،
یک هشدار به syslog ارسال می‌کند.
این هشدار در پر شدن ۸۵٪، ۹۰٪ و ۹۵٪ تصویر لحظه‌ای تکرار می‌شود.
ببینید:
.BR lvm.conf (5).
تصویر لحظه‌ای که فضای آن تمام شود نامعتبر می‌گردد و در صورت سوار (mount) بودن،
در صورت امکان پیاده‌سازی (umount) می‌شود.
.
.TP
.B Thin
میزان پر شدن داده‌ها و متاداده‌های استخر کم‌حجم (thin pool) را پایش کرده و هنگامی که از
۸۰٪ پر شود، یک هشدار به syslog ارسال می‌کند.
این هشدار زمانی که بیش از ۸۵٪، ۹۰٪ و ۹۵٪ استخر پر شود تکرار می‌گردد. ببینید:
.BR lvm.conf (5).
هنگامی که یک استخر کم‌حجم بیش از ۵۰٪ (داده یا متاداده) پر شود، پلاگین thin دستور پیکربندی‌شده
\fBdmeventd/\:thin_command\fP
را با هر ۵٪ افزایش فراخوانی می‌کند.
در تنظیمات پیش‌فرض، این پلاگین دستور داخلی
\fBlvm lvextend \-\-use\-policies\fP
را برای تغییر اندازه استخر کم‌حجم در صورت پر شدن بیش از آستانه پیکربندی‌شده
\fBactivation/\:thin_pool\%_auto\%extend\%_threshold\fP
فراخوانی می‌نماید.
اگر دستور با شکست مواجه شود، پلاگین thin دیمن dmeventd اجرای آن را با تأخیر زمانی فزاینده
بین تلاش‌ها تا حداکثر ۴۲ دقیقه ادامه خواهد داد.
کاربر همچنین می‌تواند یک دستور خارجی را برای پشتیبانی از عملیات نگهداری پیشرفته‌تر
یک استخر کم‌حجم پیکربندی کند.
چنین دستور خارجی می‌تواند مثلاً برخی از تصاویر لحظه‌ای غیرضروری را حذف کند یا از
\fBfstrim\fP(8)
برای بازیابی فضای آزاد در استخر استفاده کند، و همچنین در صورتی که سایر اقدامات فضای کافی آزاد
نکرده باشند، می‌تواند از
\fBlvextend \-\-use\-policies\fP
استفاده کند.
دستور با متغیر محیطی
\fBLVM_RUN_BY\%_DM\%EVENTD=1\fP
اجرا می‌شود تا هر دستور lvm2 که در این محیط اجرا می‌شود، برای تعامل با dmeventd تلاش نکند.
برای مشاهده میزان پر بودن استخر، دستور می‌تواند این دو متغیر محیطی را بررسی کند:
\fBDMEVENTD\%_THIN\%_POOL\%_DATA\fP
و
\fBDMEVENTD\%_THIN\%_POOL\%_METADATA\fP.
دستور همچنین می‌تواند وضعیت را با ابزارهایی مانند
\fBlvs\fP(8)
بخواند.
.
.TP
.B Vdo
میزان پر شدن داده‌های استخر VDO را پایش کرده و هنگامی که از ۸۰٪ پر شود، یک هشدار به
syslog ارسال می‌کند.
این هشدار زمانی که بیش از ۸۵٪، ۹۰٪ و ۹۵٪ استخر VDO پر شود تکرار می‌گردد. ببینید:
.BR lvm.conf (5).
هنگامی که یک استخر VDO بیش از ۵۰٪ پر شود، پلاگین vdo دستور پیکربندی‌شده
\fBdmeventd/\:vdo_command\fP
را با هر ۵٪ افزایش فراخوانی می‌کند.
در تنظیمات پیش‌فرض، این پلاگین دستور داخلی
\fBlvm lvextend \-\-use\-policies\fP
را برای تغییر اندازه استخر VDO در صورت پر شدن بیش از آستانه پیکربندی‌شده
\fBactivation/\:vdo_pool\%_auto\%extend\%_threshold\fP
فراخوانی می‌نماید.
اگر دستور با شکست مواجه شود، پلاگین vdo دیمن dmeventd اجرای آن را با تأخیر زمانی فزاینده
بین تلاش‌ها تا حداکثر ۴۲ دقیقه ادامه خواهد داد.
کاربر همچنین می‌تواند یک دستور خارجی را برای پشتیبانی از عملیات نگهداری پیشرفته‌تر
یک استخر VDO پیکربندی کند.
چنین دستور خارجی می‌تواند مثلاً مقداری فضای غیرضروری را با
\fBfstrim\fP(8)
آزاد کند، و همچنین در صورتی که سایر اقدامات فضای کافی آزاد نکرده باشند، می‌تواند از
\fBlvextend \-\-use\-policies\fP
استفاده کند.
دستور با متغیر محیطی
\fBLVM_RUN_BY\%_DMEVENTD=1\fP
اجرا می‌شود تا هر دستور lvm2 که در این محیط اجرا می‌شود، برای تعامل با dmeventd تلاش نکند.
برای مشاهده میزان پر بودن استخر VDO، دستور می‌تواند این متغیر محیطی را بررسی کند:
\fBDMEVENTD_VDO_POOL\fP.
دستور همچنین می‌تواند وضعیت را با ابزارهایی مانند
\fBlvs\fP(8)
بخواند.
.
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.
.TP
.B DMEVENTD_THIN_POOL_DATA
این متغیر توسط پلاگین thin تنظیم می‌شود و در دسترس برنامه اجرا شده قرار می‌گیرد.
مقدار آن بیانگر میزان مصرف واقعی حجم داده استخر کم‌حجم است.
هنگام پردازش رویداد خطا، این متغیر تنظیم نمی‌شود.
.
.TP
.B DMEVENTD_THIN_POOL_METADATA
این متغیر توسط پلاگین thin تنظیم می‌شود و در دسترس برنامه اجرا شده قرار می‌گیرد.
مقدار آن بیانگر میزان مصرف واقعی حجم متاداده استخر کم‌حجم است.
هنگام پردازش رویداد خطا، این متغیر تنظیم نمی‌شود.
.
.TP
.B DMEVENTD_VDO_POOL
این متغیر توسط پلاگین vdo تنظیم می‌شود و در دسترس برنامه اجرا شده قرار می‌گیرد.
مقدار آن بیانگر میزان مصرف واقعی حجم داده استخر VDO است.
هنگام پردازش رویداد خطا، این متغیر تنظیم نمی‌شود.
.
.TP
.B LVM_RUN_BY_DMEVENTD
این متغیر توسط پلاگین‌های thin و vdo تنظیم می‌شود تا از تعامل بازگشتی (recursive) با
dmeventd توسط هر دستور lvm2 اجرا شده از محیط thin_command یا vdo_command جلوگیری کند.
.
.SH "همچنین ببینید (SEE ALSO)"
.
.nh
.na
.BR lvm (8),
.BR lvm.conf (5),
.BR lvextend (8),
.P
.BR fstrim (8)