.\" Manpage for malcontent\-timer\-extension\-agent.
.\" Documentation is under the same licence as the malcontent package.
.\" SPDX-License-Identifier: LGPL-2.1-or-later
.TH man 8 "21 Oct 2025" "1.0" "malcontent\-timer\-extension\-agent man page"
.\"
.SH "نام (NAME)"
.IX Header "نام (NAME)"
malcontent\-timer\-extension\-agent \- عامل تمدید زمان‌سنج کنترل‌های والدین
.\"
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "خلاصه دستور (SYNOPSIS)"
.\"
\fBmalcontent\-timer\-extension\-agent\fP [\fB\-a\fP \fIbus\-address\fP] [\fB\-t\fP \fIinactivity\-timeout\fP]
.\"
.SH "توضیحات (DESCRIPTION)"
.IX Header "توضیحات (DESCRIPTION)"
.\"
\fBmalcontent\-timer\-extension\-agent\fP یک فرآیند عامل برای تصمیم‌گیری در خصوص تایید درخواست‌های تمدید از سوی حساب‌های کاربری فرزند است که محدودیت‌های زمان استفاده از صفحه نمایش به عنوان بخشی از کنترل‌های والدین برای آن‌ها تنظیم شده است.
.PP
این پیاده‌سازی از فرآیند عامل، یک کنش polkit ایجاد می‌کند تا به والدین اجازه دهد با استفاده از یک کادر گفتگوی polkit در رایانه محلی، درخواست تمدید محدودیت زمان استفاده از صفحه نمایش را تایید (یا رد) کنند.
.PP
سایر پیاده‌سازی‌های عامل ممکن است در آینده بررسی‌های پیچیده‌تری انجام دهند؛ برای نمونه با ارسال پیام به تلفن همراه والدین تا بتوانند درخواست‌ها را از راه دور تایید یا رد کنند.
.PP
\fBmalcontent\-timer\-extension\-agent\fP برای اجرا توسط
\fBsystemd\fP(1)
طراحی شده و با فعال‌سازی از طریق سامانه D\-Bus کار می‌کند. نیازی به اجرای دستی
\fBmalcontent\-timer\-extension\-agent\fP
نیست. برای درخواست تمدید محدودیت‌های زمان استفاده از صفحه نمایش از طریق خط فرمان، از
\fBmalcontent\-client\fP(8)
استفاده کنید.
.\"
.SH "گزینه‌ها (OPTIONS)"
.IX Header "گزینه‌ها (OPTIONS)"
.\"
.IP "\fB\-a\fP, \fB\-\-bus\-address=\fP"
نشانی یک گذرگاه پیام D\-Bus برای اتصال به آن. این گزینه فقط برای مصارف اشکال‌زدایی در نظر گرفته شده است. (پیش‌فرض: گذرگاه سیستم).
.\"
.IP "\fB\-t\fP, \fB\-\-inactivity\-timeout=\fP"
مدت زمان مهلت عدم فعالیت (به میلی‌ثانیه) که در صورت عدم ارسال هیچ درخواستی در طول این دوره، سرویس پیش از خروج منتظر می‌ماند. اگر روی
\fB0\fP
تنظیم شود، این مهلت زمانی غیرفعال شده و سرویس به طور نامحدود اجرا خواهد شد. (پیش‌فرض: ۳۰ ثانیه).
.\"
.SH "محیط (ENVIRONMENT)"
.IX Header "محیط (ENVIRONMENT)"
.\"
\fBmalcontent\-timer\-extension\-agent\fP از متغیرهای محیطی استاندارد GLib برای اشکال‌زدایی پشتیبانی می‌کند. این متغیرها برای استفاده در محیط عملیاتی در نظر گرفته
\fBنشده‌اند\fP:
.\"
.IP \fI$G_MESSAGES_DEBUG\fP 4
.IX Item "$G_MESSAGES_DEBUG"
این متغیر می‌تواند شامل یک یا چند نام دامنه اشکال‌زدایی باشد تا خروجی اشکال‌زدایی مربوط به آن‌ها نمایش داده شود. مقدار
\fIall\fP
تمام خروجی‌های اشکال‌زدایی را فعال خواهد کرد. حالت پیش‌فرض بر روی عدم فعال‌سازی هیچ‌گونه خروجی اشکال‌زدایی تنظیم شده است.
.\"
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "وضعیت خروج (EXIT STATUS)"
.\"
\fBmalcontent\-timer\-extension\-agent\fP در صورت مواجهه با مشکل ممکن است یکی از کدهای خطای زیر را برگرداند:
.\"
.IP "0" 4
.IX Item "0"
هیچ مشکلی رخ نداد. عامل اجرا شد، به صفر یا چند درخواست پاسخ داد و سپس به دلیل بسته شدن صریح یا اتمام مهلت زمانی پس از پایان تمامی درخواست‌ها خارج شد.
.\"
.IP "1" 4
.IX Item "1"
یک گزینه نامعتبر در زمان راه‌اندازی به
\fBmalcontent\-timer\-extension\-agent\fP
داده شده است.
.\"
.IP "2" 4
.IX Item "2"
نام D\-Bus برای
\fBmalcontent\-timer\-extension\-agent\fP
در دسترس نبود.
.\"
.IP "3" 4
.IX Item "3"
\fBmalcontent\-timer\-extension\-agent\fP
در محیطی نامناسب، برای نمونه به عنوان کاربر ریشه (root)، اجرا شد.
.\"
.SH "فایل‌ها (FILES)"
.IX Header "فایل‌ها (FILES)"
.\"
.IP \fI/lib/systemd/system/malcontent\-timer\-extension\-agent.service\fP 4
.IX Item "/lib/systemd/system/malcontent\-timer\-extension\-agent.service"
فایل سرویس
\fBsystemd\fP(1)
که محیط زمان اجرا را برای
\fBmalcontent\-timer\-extension\-agent\fP
مشخص می‌کند. به
\fBsystemd.service\fP(5)
مراجعه کنید.
.\"
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "همچنین ببینید (SEE ALSO)"
.\"
\fBmalcontent\-client\fP(8),
\fBmalcontent\-timerd\fP(8)
.\"
.SH "اشکالات (BUGS)"
.IX Header "اشکالات (BUGS)"
.\"
هرگونه اشکالی که پیدا می‌شود باید در وب‌سایت پروژه گزارش شود:
.br
\fIhttps://gitlab.freedesktop.org/pwithnall/malcontent/-/issues\fP
.\"
.SH "نویسنده (AUTHOR)"
.IX Header "نویسنده (AUTHOR)"
.\"
GNOME Foundation, Inc.
Philip Withnall
.\"
.SH "حق نشر (COPYRIGHT)"
.IX Header "حق نشر (COPYRIGHT)"
.\"
Copyright © 2025 GNOME Foundation, Inc.