.\" Automatically generated by Pandoc 3.2
.\"
.TH "earlyoom" "1" "" "" "General Commands Manual"
.SH "نام (NAME)"
earlyoom \- دیمن رسیدگی زودهنگام به کمبود حافظه (Early OOM)
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]earlyoom\f[R] [\f[B]OPTION\f[R]]\&...
.SH "توضیحات (DESCRIPTION)"
قابلیت oom\-killer معمولاً شهرت چندان خوبی در میان کاربران لینوکس ندارد.
ممکن است کاربر مجبور شود دقایق طولانی در برابر سیستمی که هیچ پاسخی نمی‌دهد بنشیند، به صدای خرخر دیسک گوش دهد و در نهایت با تمام شدن صبر و حوصله، دکمه ریست را فشار دهد تا سریعاً به کارهای خود بازگردد.
.PP
برنامهٔ \f[B]earlyoom\f[R] میزان حافظهٔ در دسترس و سواپ آزاد را تا ۱۰ بار در ثانیه بررسی می‌کند (در صورتی که حافظهٔ آزاد زیادی وجود داشته باشد با تناوب کمتری این کار را انجام می‌دهد).
اگر \f[B]هر دوی\f[R] حافظه \f[B]و\f[R] سواپ (در صورت وجود) به زیر ۱۰٪ برسند، بزرگ‌ترین فرایند (دارای بالاترین \f[CR]oom_score\f[R]) را خاتمه می‌دهد.
.PP
مقادیر درصدی از طریق آرگومان‌های خط فرمان قابل تنظیم هستند.
.PP
اگر هنگام تلاش برای خاتمه دادن به یک فرایند خطایی رخ دهد، \f[B]earlyoom\f[R] به مدت ۱ ثانیه به خواب می‌رود تا از پر شدن لاگ‌ها به دلیل خطاهای مکرر جلوگیری شود.
.SH "گزینه‌ها (OPTIONS)"
.SS \-m PERCENT[,KILL_PERCENT]
حداقل حافظهٔ در دسترس را برابر با PERCENT درصد از \f[CR]user mem total\f[R] تنظیم می‌کند (پیش‌فرض ۱۰٪).
.PP
مقدار \f[CR]user mem total\f[R] که در نسخهٔ ۱.۸ earlyoom معرفی شد، حافظهٔ قابل‌دسترسی توسط فضای کاربری است (\f[CR]MemAvailable\f[R]+\f[CR]AnonPages\f[R] همان‌طور که در \f[CR]/proc/meminfo\f[R] گزارش شده است).
هنگامی که دیسک رم tmpfs پر می‌شود، \f[CR]user mem total\f[R] متناسب با آن کاهش می‌یابد.
.PP
با استفاده از درصدی از \f[CR]user mem total\f[R] در مقایسه با کل حافظه، حداقل حافظهٔ تعیین‌شده همواره می‌تواند با خاتمه دادن به فرایندها به دست آید، حتی زمانی که tmpfs بخش بزرگی از حافظه را پر کرده باشد.
.PP
برنامهٔ earlyoom زمانی که \f[B]هر دوی\f[R] حافظهٔ در دسترس \f[B]و\f[R] سواپ آزاد زیر تنظیمات PERCENT مربوط به خود برسند، سیگنال SIGTERM ارسال می‌کند.
.PP
این برنامه هنگامی که \f[B]هر دو\f[R] به زیر تنظیم KILL_PERCENT مربوط به خود برسند (پیش‌فرض PERCENT/2)، سیگنال SIGKILL ارسال می‌کند.
.PP
اگر می‌خواهید همیشه از SIGKILL استفاده شود، مقدار یکسانی را برای PERCENT و KILL_PERCENT در نظر بگیرید.
.PP
مثال‌ها:
.IP
.EX
earlyoom              # sets PERCENT=10, KILL_PERCENT=5
earlyoom \-m 30        # sets PERCENT=30, KILL_PERCENT=15
earlyoom \-m 20,18     # sets PERCENT=20, KILL_PERCENT=18
.EE
.SS \-s PERCENT[,KILL_PERCENT]
حداقل سواپ آزاد را برابر با PERCENT درصد از کل تنظیم می‌کند (پیش‌فرض ۱۰٪).
اگر برابر یا کمتر از KILL_PERCENT باشد (پیش‌فرض PERCENT/2)، سیگنال SIGKILL و در غیر این صورت SIGTERM ارسال می‌کند.
.PP
می‌توانید از \f[CR]\-s 100\f[R] استفاده کنید تا earlyoom در عمل مصرف سواپ را نادیده بگیرد: فرایندها به محض این‌که حافظهٔ در دسترس به زیر حداقلِ پیکربندی‌شده سقوط کند خاتمه می‌یابند، صرف‌نظر از این‌که چه مقدار فضای سواپ آزاد است.
.PP
اگر می‌خواهید همیشه از SIGKILL استفاده شود، مقدار یکسانی را برای PERCENT و KILL_PERCENT در نظر بگیرید.
.SS \-M SIZE[,KILL_SIZE]
به‌عنوان جایگزینی برای تعیین درصد کل حافظه، \f[CR]\-M\f[R] حداقل حافظهٔ در دسترس را به میزان SIZE کیبی‌بایت (KiB) تنظیم می‌کند.
این مقدار در داخل برنامه به درصدی از \f[CR]mem total\f[R] که در زمان راه‌اندازی گزارش شده است تبدیل می‌شود.
از \f[CR]user mem total\f[R] برای محاسبهٔ زمان راه‌اندازی استفاده نمی‌شود، زیرا باعث می‌شد نتیجه به این‌که tmpfs در آن لحظه چقدر پر است وابسته شود.
.PP
اگر هر دو گزینهٔ \f[CR]\-M\f[R] و \f[CR]\-m\f[R] را ارسال کنید، مقدار کمتر استفاده می‌شود.
مثال: رزرو ۱۰٪ از رم، اما حداکثر ۱ گیبی‌بایت (GiB):
.IP
.EX
earlyoom \-m 10 \-M 1048576
.EE
.PP
برنامهٔ earlyoom در صورتی که مقدار برابر یا کمتر از KILL_SIZE باشد (پیش‌فرض SIZE/2) سیگنال SIGKILL ارسال می‌کند، در غیر این صورت SIGTERM.
.SS \-S SIZE[,KILL_SIZE]
به‌عنوان جایگزینی برای تعیین درصدی از کل سواپ، \f[CR]\-S\f[R] حداقل سواپ آزاد را به میزان SIZE کیبی‌بایت (KiB) تنظیم می‌کند.
این مقدار در داخل برنامه به درصد تبدیل می‌شود.
اگر هر دو گزینهٔ \f[CR]\-S\f[R] و \f[CR]\-s\f[R] را ارسال کنید، مقدار کمتر استفاده می‌شود.
.PP
در صورتی که مقدار برابر یا کمتر از KILL_SIZE باشد (پیش‌فرض SIZE/2) سیگنال SIGKILL و در غیر این صورت SIGTERM ارسال می‌کند.
.SS \-k
در نسخهٔ ۱.۲ earlyoom حذف شده است؛ جهت سازگاری نادیده گرفته می‌شود.
.SS \-i
در نسخهٔ ۱.۷ earlyoom حذف شده است؛ جهت سازگاری نادیده گرفته می‌شود.
.SS \-d, \[en]debug
فعال‌سازی پیام‌های اشکال‌زدایی.
.SS \-v
چاپ اطلاعات نسخه و خروج.
.SS \-r INTERVAL
زمان بین چاپ گزارش‌های دوره‌ای حافظه، بر حسب ثانیه (پیش‌فرض ۱.۰).
یک گزارش حافظه به این صورت است:
.IP
.EX
mem avail: 21790 of 23909 MiB (91.14%), swap free:    0 of    0 MiB ( 0.00%)
.EE
.PP
برای چاپ گزارش در هر ساعت آن را روی ۳۶۰۰، برای چاپ روزی یک‌بار روی ۸۶۴۰۰ و غیره تنظیم کنید.
برای غیرفعال کردن چاپ گزارش‌های دوره‌ای حافظه، آن را روی ۰ قرار دهید.
پایش حافظهٔ آزاد و خاتمه دادن به فرایندها در شرایط کمبود حافظه، مستقل از این گزینه و با یک نرخ نظرسنجی انطباقی اجرا می‌شود که صرفاً به حافظهٔ آزاد بستگی دارد.
به دلیل این نرخ نظرسنجی انطباقی، هنگامی که حافظهٔ آزاد زیادی وجود دارد، بازهٔ زمانی واقعی ممکن است تا ۱ ثانیه طولانی‌تر از مقدار تنظیم‌شده باشد.
.SS \-p
افزایش اولویت earlyoom: تنظیم niceness برنامهٔ earlyoom روی \-20 و oom_score_adj روی \-100.
.PP
هنگامی که earlyoom از طریق سرویس پیش‌فرض systemd اجرا می‌شود، سوییچ \f[CR]\-p\f[R] کار نمی‌کند.
برای دستیابی به همان اثر، سه خط زیر را در \f[CR]sudo systemctl edit earlyoom\f[R] وارد کنید:
.IP
.EX
[Service]
OOMScoreAdjust=\-100
Nice=\-20
.EE
.SS \-n
فعال‌سازی اعلان‌ها از طریق d\-bus.
.PP
برای مشاهدهٔ واقعی اعلان‌ها در نشست گرافیکی (GUI) خود، باید برنامهٔ
\c
.UR https://github.com/rfjakob/systembus-notify
systembus\-notify
.UE \c
\ با کاربر شما در حال اجرا باشد.
.SS \-N /PATH/TO/SCRIPT
اجرای اسکریپت داده‌شده پس از خاتمه دادن به هر فرایند.
باید یک مسیر مطلق باشد.
.PP
درون اسکریپت، اطلاعات مربوط به فرایند خاتمه‌یافته را می‌توان از طریق متغیرهای محیطی زیر دریافت کرد:
.IP
.EX
EARLYOOM_PID     Process PID
EARLYOOM_NAME    Process name truncated to 16 bytes (as reported in /proc/PID/comm)
EARLYOOM_CMDLINE Process cmdline truncated to 256 bytes (as reported in /proc/PID/cmdline)
EARLYOOM_UID     UID of the user running the process
.EE
.PP
هشدار: متغیر \f[CR]EARLYOOM_NAME\f[R] می‌تواند شامل فاصله، خط جدید، نویسه‌های ویژه باشد و توسط کاربر کنترل می‌شود، یا حتی می‌تواند خالی باشد!
اطمینان حاصل کنید که اسکریپت اعلان شما می‌تواند این موارد را مدیریت کند!
.SS \-P /PATH/TO/SCRIPT
اجرای اسکریپت مشخص‌شده پیش از خاتمه دادن به هر فرایند.
باید یک مسیر مطلق باشد.
.PP
توضیحات \f[CR]\-N\f[R] را ببینید؛ رفتار این گزینه دقیقاً مشابه است، به جز این‌که پیش از خاتمه یافتن فرایند اجرا می‌شود.
.PP
توجه داشته باشید که تاخیر کوتاهی (۲۰۰ میلی‌ثانیه) در خاتمه دادن به قربانیِ انتخاب‌شده وجود دارد تا فرصتی برای ایجاد این برنامه و انجام کاری معنادار فراهم شود.
برنامهٔ فراخوانی‌شده باید بسیار سریع باشد تا قبل از خاتمه یافتن فرایندِ در حال اجرا، اطلاعات را از آن جمع‌آوری کند.
.PP
هرگونه تاخیری از این دست، و منابع اضافی مصرف‌شده توسط فرایند ایجادشده، همواره هزینه‌ای تحمیل کرده و سیستمی را که خود دچار کمبود منابع است بیشتر تحت فشار قرار می‌دهد.
بنابراین، فرایند فراخوانی‌شده باید تا حد امکان سبک و سریع باشد.
.SS \-g
خاتمه دادن به تمامی فرایندهایی که شناسه گروه فرایند (PGID) یکسانی با فرایندِ دارای مصرف بیش از حد حافظه دارند.
.PP
برای مثال، با فعال بودن این پرچم، اگر یکی از زیرفرایندهای یک برنامه حافظهٔ بسیار زیادی مصرف کند، کل برنامه خاتمه داده می‌شود (البته تا زمانی که همه آن‌ها PGID یکسانی داشته باشند).
.PP
زمانی این پرچم را فعال کنید که پاکسازی کامل «کل برنامه» مطلوب‌تر باشد و مطمئن باشید که برنامه تمام فرایندهای خود را در یک PGID قرار می‌دهد.
.PP
توجه داشته باشید که برخی از محیط‌های رومیزی (به‌عنوان مثال GNOME) تمام برنامه‌های رومیزی را در همان گروه فرایند \f[CR]gnome\-shell\f[R] قرار می‌دهند.
در صورت فعال بودن این پرچم، ممکن است earlyoom تمام این فرایندها از جمله \f[CR]gnome\-shell\f[R] را خاتمه دهد.
.PP
حتماً از قبل نحوه رفتار محیط خود را بررسی کنید.
از دستور
.IP
.EX
pstree \-gT
.EE
.PP
برای نمایش تمام فرایندها به همراه PGID درون براکت استفاده کنید.
.SS \-\-prefer REGEX
اولویت دادن به خاتمه فرایندهایی که نام \f[CR]comm\f[R] آن‌ها با REGEX مطابقت دارد (مقدار ۳۰۰ را به oom_score اضافه می‌کند).
.PP
نام \f[CR]comm\f[R] همان رشتهٔ موجود در \f[CR]/proc/pid/comm\f[R] است.
این نام ۱۵ بایت اول نام فرایند است.
نام‌های طولانی‌تر به ۱۵ بایت کوتاه می‌شوند.
.PP
نام \f[CR]comm\f[R] همان چیزی است که برنامه‌های \f[CR]top\f[R]، \f[CR]pstree\f[R] و \f[CR]ps \-e\f[R] نیز نشان می‌دهند.
از هر یک از این ابزارها برای یافتن نام مناسب \f[CR]comm\f[R] استفاده کنید.
.PP
مثال: می‌خواهید با \f[CR]gnome\-control\-center\f[R] که طولانی‌تر از ۱۵ بایت است تطبیق دهید:
.IP
.EX
earlyoom \-\-prefer \[aq]\[ha]gnome\-control\-c$\[aq]
.EE
.SS \-\-avoid REGEX
اجتناب از خاتمه دادن به فرایندهایی که نام \f[CR]comm\f[R] آن‌ها با REGEX مطابقت دارد (مقدار ۳۰۰ را از oom_score کسر می‌کند).
.SS \-\-ignore REGEX
نادیده گرفتن فرایندهایی که نام \f[CR]comm\f[R] آن‌ها با REGEX مطابقت دارد.
.PP
برخلاف گزینهٔ \-\-avoid، این گزینه هرگونه امکان خاتمه دادن به فرایندهای مطابقت‌یافته را که ممکن بود به دلیل کسب oom_score بالا رخ دهد، به‌کلی غیرفعال می‌کند.
.PP
از این گزینه با احتیاط استفاده کنید، زیرا هنگامی که earlyoom تصمیم به توقف فرایندها می‌گیرد، ممکن است فرایندهای دیگری به جای فرایندهای نادیده‌گرفته‌شده قربانی شوند.
.SS \-\-sort\-by\-rss
یافتن فرایند با بیشترین مقدار rss (پیش‌فرض oom_score است).
.SS \-\-dryrun
اجرای آزمایشی (هیچ فرایندی خاتمه داده نمی‌شود).
.SS \-\-syslog
استفاده از syslog به‌جای جریان‌های استاندارد.
.PP
معمولاً به این گزینه نیازی نیست، زیرا systemd لاگ‌برداری تمام خروجی‌ها را مدیریت می‌کند.
.PP
گزینهٔ \-\-syslog ممکن است برای سیستم‌های تعبیه‌شدهٔ حداقلی که فاقد systemd هستند مفید باشد.
برای مشاهدهٔ اطلاعات بیشتر به https://github.com/rfjakob/earlyoom/pull/292 مراجعه کنید.
.SS \-h, \-\-help
نمایش این متن راهنما.
.SH "وضعیت خروج (EXIT STATUS)"
0: اجرای موفقیت‌آمیز برنامه.
.PP
1: سایر خطاها \- برای جزئیات به پیام خطا مراجعه کنید.
.PP
2: تداخل در گزینه‌ها.
.PP
4: عدم امکان رفتن به دایرکتوری /proc.
.PP
5: عدم امکان باز کردن proc.
.PP
7: عدم امکان باز کردن /proc/sysrq\-trigger.
.PP
13: گزینه‌های ناشناخته.
.PP
14: پارامترهای نادرست برای سایر گزینه‌ها.
.PP
15: پارامترهای نادرست برای آستانهٔ حافظه.
.PP
16: پارامترهای نادرست برای آستانهٔ سواپ.
.PP
102: عدم امکان باز کردن /proc/meminfo.
.PP
103: عدم امکان خواندن /proc/meminfo.
.PP
104: عدم امکان یافتن مدخل مشخص در /proc/meminfo.
.PP
105: عدم امکان تبدیل عدد هنگام تجزیهٔ محتویات /proc/meminfo.
.SH "چرا OOM-Killer هسته فعال نمی‌شود؟ (WHY NOT TRIGGER THE KERNEL OOM KILLER?)"
برنامهٔ earlyoom از دستور \f[CR]echo f > /proc/sysrq\-trigger\f[R] استفاده نمی‌کند، زیرا توسعه‌دهندگان مرورگر کروم با تنظیم بسیار بالای \f[CR]oom_score_adj\f[R]، مرورگر خود را همواره به اولین قربانی (بی‌گناه!) تبدیل کرده‌اند.
در عوض، earlyoom خودش با خواندن و بررسی \f[CR]/proc/*/status\f[R] (در واقع \f[CR]/proc/*/statm\f[R] که حاوی همان اطلاعات است اما تجزیهٔ برنامه‌نویسی آن ساده‌تر است) وضعیت را تشخیص می‌دهد.
.PP
علاوه بر این، در هسته‌های جدیدتر (روی 4.0.5 آزمایش شده)، فعال کردن دستی oom-killer هسته ممکن است اصلاً کار نکند؛ یعنی ممکن است فقط مقداری حافظهٔ گرافیکی را آزاد کند (که بلافاصله مجدداً تخصیص داده می‌شود) و در واقع هیچ فرایندی را خاتمه ندهد.
.SH "میزان مصرف حافظه (MEMORY USAGE)"
حدود ۲ مبی‌بایت (MiB) VmRSS.
تمامی حافظه با استفاده از mlockall() قفل می‌شود تا اطمینان حاصل شود که earlyoom در شرایط کمبود حافظه دچار افت سرعت نمی‌شود.
.SH "گزارش باگ‌ها (BUGS)"
اگر در زمان راه‌اندازی earlyoom مقدار کل سواپ صفر باشد، هرگونه مقدار \f[CR]\-S\f[R] (حرف بزرگ «S») نادیده گرفته شده، یک هشدار چاپ می‌شود و درصدهای پیش‌فرض سواپ به کار می‌روند.
.PP
برای فرایندهایی که با \f[CR]\-\-prefer\f[R] مطابقت دارند، مقادیر منفی \f[CR]oom_score_adj\f[R] لحاظ نمی‌شوند و فرایند یک \f[CR]oom_score\f[R] مؤثر حداقل ۳۰۰ دریافت می‌کند.
برای جزئیات بیشتر به https://github.com/rfjakob/earlyoom/issues/159 مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نویسندهٔ earlyoom آقای Jakob Unterwurzacher ⟨jakobunt\[at]gmail.com⟩ است.
.PP
این صفحهٔ راهنما توسط Yangfl ⟨mmyangfl\[at]gmail.com⟩ برای پروژهٔ دبیان نوشته شده است (و ممکن است توسط دیگران نیز استفاده شود).
.SH "همچنین ببینید (SEE ALSO)"
nohang(8)