." Manpage for malcontent\-webd.
." Documentation is under the same licence as the malcontent package.
." SPDX-License-Identifier: LGPL-2.1-or-later
.TH man 8 "9 Jun 2025" "1.0" "راهنمای malcontent\-webd"
."
.SH "نام (NAME)"
.IX Header "NAME"
malcontent\-webd \- دیمن فیلترینگ وب برای کنترل والدین
."
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
."
\fBmalcontent\-webd\fP [\fB\-a\fP \fIbus\-address\fP]
."
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
."
برنامه \fBmalcontent\-webd\fP یک فرآیند هماهنگ‌کننده برای مدیریت لیست‌های مسدودسازی (blocklists) و لیست‌های مجاز (allowlists) فیلترینگ وب است. حساب‌های کاربری فرزندان که تحت کنترل والدین در رایانه قرار دارند، لیست‌های مسدودسازی را از \fBmalcontent\-webd\fP دریافت کرده و از آن‌ها برای تعیین وب‌سایت‌های مجاز یا مسدود هنگام مرور اینترنت استفاده می‌کنند.
.PP
برنامه \fBmalcontent\-webd\fP طوری طراحی شده است که توسط \fBsystemd\fP(1) اجرا شود؛ یا از طریق D\-Bus فعال گردد (برای به‌روزرسانی لیست فیلتر یک کاربر خاص) یا بر اساس یک زمان‌سنج systemd راه‌اندازی شود (برای به‌روزرسانی لیست‌های فیلتر تمام کاربران). نیازی به اجرای دستی \fBmalcontent\-webd\fP وجود ندارد. برای ویرایش لیست‌های مسدودسازی فیلترینگ وب از \fBmalcontent\-client\fP(8) استفاده کنید.
.PP
فیلترینگ واقعی ترافیک وب در نشست‌های کاربری فرزندان توسط یک ماژول NSS به نام \fBnss\-malcontent\fP(8) انجام می‌شود.
.PP
اگر هنگام به‌روزرسانی لیست‌های فیلتر برای تمام کاربران از طریق زمان‌سنج systemd خطایی رخ دهد، اطلاعات خطا در فایل \fB/var/lib/malcontent\-webd/update\-error\fP نوشته خواهد شد. پس از یک به‌روزرسانی موفق، این فایل حذف می‌شود.
.PP
فایل خطا یک فایل کلید\-مقدار است، به عنوان مثال:
.IP
.nf
[Web Filter Update Error]
ErrorCode=org.freedesktop.MalcontentWeb1.Filtering.Error.Downloading  # این فیلد اختیاری است
ErrorMessage[en_GB]=There was an error downloading foo from blah.     # این فیلد الزامی است
.fi
."
.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\-webd\fP از متغیرهای محیطی استاندارد GLib برای اشکال‌زدایی پشتیبانی می‌کند. این متغیرها برای استفاده در محیط‌های عملیاتی در نظر گرفته \fBنشده‌اند\fP:
."
.IP \fI\fP 4
.IX Item ""
این متغیر می‌تواند شامل یک یا چند نام دامنه اشکال‌زدایی برای نمایش خروجی‌های دیباگ باشد. مقدار \fIall\fP تمام خروجی‌های اشکال‌زدایی را فعال می‌کند. مقدار پیش‌فرض فعال نبودن خروجی اشکال‌زدایی است.
."
.SH "وضعیت خروج (EXIT STATUS)"
.IX Header "EXIT STATUS"
."
برنامه \fBmalcontent\-webd\fP در صورت مواجهه با مشکل ممکن است یکی از کدهای خطای زیر را برگرداند:
."
.IP "0" 4
.IX Item "0"
هیچ مشکلی رخ نداده است. دیمن فیلترینگ وب اجرا شد، به درخواست‌ها پاسخ داد و سپس به دلیل بسته شدن صریح یا اتمام مهلت زمانی پس از پایان تمام درخواست‌ها خارج شد.
."
.IP "1" 4
.IX Item "1"
یک گزینه نامعتبر هنگام راه‌اندازی به \fBmalcontent\-webd\fP ارسال شد.
."
.IP "2" 4
.IX Item "2"
نام D\-Bus برای \fBmalcontent\-webd\fP در دسترس نبود.
."
.IP "3" 4
.IX Item "3"
برنامه \fBmalcontent\-webd\fP در یک محیط نامناسب، برای نمونه به عنوان کاربر ریشه (root)، اجرا شد.
."
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
."
.IP \fI/lib/systemd/system/malcontent\-webd.service\fP 4
.IX Item "/lib/systemd/system/malcontent\-webd.service"
فایل سرویس \fBsystemd\fP(1) که محیط زمان اجرا را برای \fBmalcontent\-webd\fP مشخص می‌کند. به \fBsystemd.service\fP(5) مراجعه کنید.
."
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
."
\fBmalcontent\-client\fP(8)
."
.SH "اشکالات (BUGS)"
.IX Header "BUGS"
."
هرگونه اشکال کشف‌شده باید در وب‌سایت پروژه گزارش شود:
.br
\fIhttps://gitlab.freedesktop.org/pwithnall/malcontent/-/issues\fP
."
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHOR"
."
بنیاد گنوم (GNOME Foundation, Inc.)
Philip Withnall
."
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
."
Copyright © 2025 GNOME Foundation, Inc.