نام (NAME)

malcontent-webd - دیمن فیلترینگ وب برای کنترل والدین

خلاصه دستور (SYNOPSIS)

malcontent-webd [-a bus-address]

توضیحات (DESCRIPTION)

برنامه malcontent-webd یک فرآیند هماهنگ‌کننده برای مدیریت لیست‌های مسدودسازی (blocklists) و لیست‌های مجاز (allowlists) فیلترینگ وب است. حساب‌های کاربری فرزندان که تحت کنترل والدین در رایانه قرار دارند، لیست‌های مسدودسازی را از malcontent-webd دریافت کرده و از آن‌ها برای تعیین وب‌سایت‌های مجاز یا مسدود هنگام مرور اینترنت استفاده می‌کنند.

برنامه malcontent-webd طوری طراحی شده است که توسط systemd(1) اجرا شود؛ یا از طریق D-Bus فعال گردد (برای به‌روزرسانی لیست فیلتر یک کاربر خاص) یا بر اساس یک زمان‌سنج systemd راه‌اندازی شود (برای به‌روزرسانی لیست‌های فیلتر تمام کاربران). نیازی به اجرای دستی malcontent-webd وجود ندارد. برای ویرایش لیست‌های مسدودسازی فیلترینگ وب از malcontent-client(8) استفاده کنید.

فیلترینگ واقعی ترافیک وب در نشست‌های کاربری فرزندان توسط یک ماژول NSS به نام nss-malcontent(8) انجام می‌شود.

اگر هنگام به‌روزرسانی لیست‌های فیلتر برای تمام کاربران از طریق زمان‌سنج systemd خطایی رخ دهد، اطلاعات خطا در فایل /var/lib/malcontent-webd/update-error نوشته خواهد شد. پس از یک به‌روزرسانی موفق، این فایل حذف می‌شود.

فایل خطا یک فایل کلید-مقدار است، به عنوان مثال:

[Web Filter Update Error]
ErrorCode=org.freedesktop.MalcontentWeb1.Filtering.Error.Downloading  # این فیلد اختیاری است
ErrorMessage[en_GB]=There was an error downloading foo from blah.     # این فیلد الزامی است

گزینه‌ها (OPTIONS)

-a, --bus-address=: نشانی یک گذرگاه پیام D-Bus برای اتصال. این گزینه فقط برای اهداف اشکال‌زدایی در نظر گرفته شده است. (پیش‌فرض: گذرگاه سیستم)
-t, --inactivity-timeout=: مهلت زمان غیرفعال بودن (بر حسب میلی‌ثانیه) پیش از خروج از سرویس در صورتی که در طول این مدت هیچ درخواستی ثبت نشده باشد. اگر روی 0 تنظیم شود، این مهلت غیرفعال شده و سرویس به طور نامحدود اجرا خواهد شد. (پیش‌فرض: ۳۰ ثانیه)

محیط (ENVIRONMENT)

برنامه malcontent-webd از متغیرهای محیطی استاندارد GLib برای اشکال‌زدایی پشتیبانی می‌کند. این متغیرها برای استفاده در محیط‌های عملیاتی در نظر گرفته نشده‌اند:

: این متغیر می‌تواند شامل یک یا چند نام دامنه اشکال‌زدایی برای نمایش خروجی‌های دیباگ باشد. مقدار all تمام خروجی‌های اشکال‌زدایی را فعال می‌کند. مقدار پیش‌فرض فعال نبودن خروجی اشکال‌زدایی است.

وضعیت خروج (EXIT STATUS)

برنامه malcontent-webd در صورت مواجهه با مشکل ممکن است یکی از کدهای خطای زیر را برگرداند:

0: هیچ مشکلی رخ نداده است. دیمن فیلترینگ وب اجرا شد، به درخواست‌ها پاسخ داد و سپس به دلیل بسته شدن صریح یا اتمام مهلت زمانی پس از پایان تمام درخواست‌ها خارج شد.
1: یک گزینه نامعتبر هنگام راه‌اندازی به malcontent-webd ارسال شد.
2: نام D-Bus برای malcontent-webd در دسترس نبود.
3: برنامه malcontent-webd در یک محیط نامناسب، برای نمونه به عنوان کاربر ریشه (root)، اجرا شد.

فایل‌ها (FILES)

/lib/systemd/system/malcontent-webd.service: فایل سرویس systemd(1) که محیط زمان اجرا را برای malcontent-webd مشخص می‌کند. به systemd.service(5) مراجعه کنید.

همچنین ببینید (SEE ALSO)

malcontent-client(8)

اشکالات (BUGS)

هرگونه اشکال کشف‌شده باید در وب‌سایت پروژه گزارش شود:
https://gitlab.freedesktop.org/pwithnall/malcontent/-/issues

نویسندگان (AUTHORS)

بنیاد گنوم (GNOME Foundation, Inc.) Philip Withnall