.\" Manpage for malcontent\-client. .\" Documentation is under the same licence as the malcontent .\" package. .TH man 8 "20 Mar 2025" "1.2" "malcontent\-client man page" .\" .SH "نام (NAME)" .IX Header "نام (NAME)" malcontent\-client \- ابزار دسترسی به کنترل‌های والدین .\" .SH "خلاصه دستور (SYNOPSIS)" .IX Header "خلاصه دستور (SYNOPSIS)" .\" \fBmalcontent\-client get\-app\-filter [\-q] [\-n] [\fPUSER\fB] .PP \fBmalcontent\-client check\-app\-filter [\-q] [\-n] [\fPUSER\fB] \fPARG\fB .PP \fBmalcontent\-client set\-app\-filter [\-q] [\-n] [\fPUSER\fB] \fPARG\fB .PP \fBmalcontent\-client oars\-section [\-q] [\-n] [\fPUSER\fB] \fPSECTION\fB .PP \fBmalcontent\-client get\-session\-limits [\-q] [\-n] [\fPUSER\fB] .PP \fBmalcontent\-client set\-session\-limits [\-q] [\-n] [\fPUSER\fB] \fPLIMIT\-TYPE\fB .PP \fBmalcontent\-client monitor [\-q] [\fPUSER\fB] .PP \fBmalcontent\-client record\-usage [\-q] \fPUSAGE\-ENTRIES\fB .PP \fBmalcontent\-client query\-usage [\-q] \fPUSER\fB \fPRECORD\-TYPE\fB \fPIDENTIFIER\fB .PP \fBmalcontent\-client get\-estimated\-times [\-q] \fPRECORD\-TYPE\fB .PP \fBmalcontent\-client request\-extension [\-q] \fPRECORD\-TYPE\fB \fPIDENTIFIER\fB [\fPDURATION\fB] .PP \fBmalcontent\-client get\-web\-filter [\-q] [\-n] [\fPUSER\fB] .PP \fBmalcontent\-client set\-web\-filter [\-q] [\-n] [\fPUSER\fB] \fPARG\fB .PP \fBmalcontent\-client update\-web\-filters [\-q] [\-n] [\fPUSER\fB] .PP \fBmalcontent\-client dump\-web\-filters [\-q] [\-n] [\fPUSER\fB] .\" .SH "توضیحات (DESCRIPTION)" .IX Header "توضیحات (DESCRIPTION)" .\" \fBmalcontent\-client\fP ابزاری برای پرس‌وجو و به‌روزرسانی تنظیمات کنترل‌های والدین برای کاربران سیستم است. انجام هر کاری فراتر از بررسی کنترل‌های والدینِ کاربر فعلی، معمولاً نیازمند دسترسی مدیر سیستم (administrator) است. .PP این ابزار با accounts-service که داده‌های کنترل‌های والدین را ذخیره می‌کند، ارتباط برقرار می‌کند. .PP نخستین آرگومان آن، دستوری است که باید اجرا شود. دستورهای پشتیبانی‌شده در ادامه مستند شده‌اند. .PP رابط خط فرمان (API) و قالب خروجی ناپایدار بوده و احتمالاً در نسخه‌های آیندهٔ \fBmalcontent\-client\fP تغییر خواهند کرد. .\" .SH "گزینه‌های \fBget\-app\-filter\fP (get\-app\-filter OPTIONS)" .IX Header "گزینه‌های get-app-filter (get-app-filter OPTIONS)" .\" دریافت فیلتر برنامه برای یک کاربر. برای مثال: .RS .ad l # malcontent\-client get\-app\-filter timmy .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که فیلتر برنامه برای او دریافت می‌شود. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBcheck\-app\-filter\fP (check\-app\-filter OPTIONS)" .IX Header "گزینه‌های check-app-filter (check-app-filter OPTIONS)" .\" بررسی اینکه آیا یک برنامه، نوع محتوا یا ارجاع flatpak مشخص بر اساس فیلتر برنامهٔ فعلی کاربر، مجاز به استفاده توسط او هست یا خیر. برای مثال: .RS .ad l # malcontent\-client check\-app\-filter timmy $(which gnome\-calculator) .PP # malcontent\-client check\-app\-filter timmy x\-scheme\-handler/http .PP # malcontent\-client check\-app\-filter timmy app/com.realm667.WolfenDoom_Blade_of_Agony/x86_64/stable .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که فیلتر برنامه برای او بررسی می‌شود. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fBARG\fP" مسیر یک برنامه، نوع محتوا یا ارجاع flatpak جهت بررسی در برابر فیلتر برنامه، برای مشخص شدن اینکه آیا برای کاربر مشخص‌شده مجاز است یا خیر. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBset\-app\-filter\fP (set\-app\-filter OPTIONS)" .IX Header "گزینه‌های set-app-filter (set-app-filter OPTIONS)" .\" تنظیم فیلتر برنامه برای یک کاربر و جایگزینی تمام مقادیر قبلی موجود در آن. برای مثال: .RS .ad l # malcontent\-client set\-app\-filter timmy \\ \-\-disallow\-user\-installation \\ $(which gnome\-calculator) \\ x\-scheme\-handler/http \\ app/com.realm667.WolfenDoom_Blade_of_Agony/x86_64/stable .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که فیلتر برنامه برای او تنظیم می‌شود. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fBARG\fP" موردی که باید در فیلتر برنامهٔ کاربر فیلتر شود. این مورد می‌تواند یک مسیر مطلق یا یک ارجاع flatpak از یک برنامه جهت مسدودسازی باشد؛ یک نوع محتوا برای مسدود کردن تمام برنامه‌هایی که آن نوع را مدیریت می‌کنند؛ یا یک جفت \fBsection=value\fP مربوط به OARS جهت مسدود کردن نصب برنامه‌هایی با رده‌بندی شدیدتر در آن بخش OARS. می‌توان چندین مورد را مشخص کرد، و آنها به‌طور کامل جایگزین فیلتر برنامهٔ فعلی کاربر خواهند شد. در صورت مشخص نشدن هیچ موردی (صفر مورد)، فیلتر برنامه پاک خواهد شد. .\" .IP "\fB\-\-allow\-user\-installation\fP" به کاربر اجازه نصب flatpakها در مخزن کاربری داده شود. .\" .IP "\fB\-\-disallow\-user\-installation\fP" کاربر از نصب flatpakها در مخزن کاربری منع شود. .\" .IP "\fB\-\-allow\-system\-installation\fP" به کاربر اجازه نصب flatpakها در مخزن سیستمی داده شود. .\" .IP "\fB\-\-disallow\-system\-installation\fP" کاربر از نصب flatpakها در مخزن سیستمی منع شود. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBoars\-section\fP (oars\-section OPTIONS)" .IX Header "گزینه‌های oars-section (oars-section OPTIONS)" .\" دریافت مقدار تنظیم‌شده برای یک بخش مشخص از OARS از فیلتر برنامهٔ کاربر داده‌شده. برای مثال: .RS .ad l # malcontent\-client oars\-section timmy language\-profanity .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که فیلتر OARS برای او دریافت می‌شود. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fBSECTION\fP" بخش OARS که سطح محدودیت کاربر مورد نظر باید برای آن دریافت شود. برای مثال، \fBlanguage\-profanity\fP. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBget\-session\-limits\fP (get\-session\-limits OPTIONS)" .IX Header "گزینه‌های get-session-limits (get-session-limits OPTIONS)" .\" دریافت محدودیت‌های نشست تنظیم‌شده برای یک کاربر. برای مثال: .RS .ad l # malcontent\-client get\-session\-limits timmy .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که محدودیت‌های نشست برای او دریافت می‌شود. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .IP "\fB\-\-now yyyy\-mm\-ddThh:mm:ssZ\fP" بررسی محدودیت‌های نشست (به‌ویژه زمان انقضای نشست) در برابر تاریخ/زمان مشخص‌شده که در قالب ISO 8601 ارائه می‌شود. (پیش‌فرض: تاریخ/زمان فعلی.) .\" .SH "گزینه‌های \fBset\-session\-limits\fP (set\-session\-limits OPTIONS)" .IX Header "گزینه‌های set-session-limits (set-session-limits OPTIONS)" .\" تنظیم محدودیت‌های نشست برای یک کاربر و جایگزینی کامل مقادیر قبلی آن. برای مثال: .RS .ad l # malcontent\-client set\-session\-limits timmy \\ daily\-schedule \\ \-\-start\-time 16:00 \-\-end\-time 18:00 .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که محدودیت‌های نشست برای او تنظیم می‌شود. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fBLIMIT\-TYPE\fP" نوع محدودیت نشست برای استفاده در مورد این کاربر. مقادیر ممکن عبارتند از: .RS .IP \fBnone\fP \- بدون محدودیت نشست. .IP \fBdaily\-schedule\ \-\-start\-time\ HH[:MM[:SS]]\ \-\-end\-time\ HH[:MM[:SS]]\fP \- برنامهٔ زمان‌بندی روزانه با زمان‌های شروع و پایان مشخص. این مقادیر باید به‌صورت دو آرگومان ارائه شوند که زمان شروع و پایان برنامه در طول شبانه‌روز را مشخص می‌کنند. .IP \fBdaily\-limit\ \-\-daily\-limit\ SECONDS\fP \- محدودیت روزانه بر کل مدت‌زمان فعال استفاده از رایانه در طول روز. این مقدار باید به‌صورت یک محدودیت زمانی بر حسب ثانیه ارائه شود. .RE .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBmonitor\fP (monitor OPTIONS)" .IX Header "گزینه‌های monitor (monitor OPTIONS)" .\" پایش تغییرات مربوط به هر یک از تنظیمات کنترل‌های والدین برای یک کاربر مشخص. برای مثال: .RS .ad l # malcontent\-client monitor timmy .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که کنترل‌های والدین او پایش می‌شوند. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .SH "گزینه‌های \fBrecord\-usage\fP (record\-usage OPTIONS)" .IX Header "گزینه‌های record-usage (record-usage OPTIONS)" .\" ثبت زمان‌های استفاده از نشست یا برنامه برای کاربر فعلی. برای مثال: .RS .ad l # malcontent\-client record\-usage 2025-04-22T08:00:00Z 2025-04-22T16:00:00Z login-session .PP # malcontent\-client record\-usage 2025-04-22T08:00:00Z 2025-04-22T16:00:00Z app "org.gnome.gedit" .ad b .RE .\" .IP "\fBUSAGE\-ENTRIES\fP" یک یا چند مدخل استفاده برای افزودن. هر مدخل مجموعه‌ای از چهار آرگومان است: .RS .IP \(bu تاریخ و زمان شروع دورهٔ استفاده (در قالب ISO 8601)، .IP \(bu تاریخ و زمان پایان دورهٔ استفاده (همچنین در قالب ISO 8601)، .IP \(bu نوع رکورد (\fBlogin\-session\fP یا \fBapp\fP) و .IP \(bu شناسهٔ رکورد (این مورد برای رکوردهای \fBlogin\-session\fP باید یک رشتهٔ خالی باشد، و برای رکوردهای \fBapp\fP شناسهٔ برنامه است). .RE .\" در صورتی که آخرین شناسهٔ رکورد در فهرست آرگومان‌ها خالی باشد، می‌توان آن را حذف کرد. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .SH "گزینه‌های \fBquery\-usage\fP (query\-usage OPTIONS)" .IX Header "گزینه‌های query-usage (query-usage OPTIONS)" .\" پرس‌وجوی زمان‌های استفاده از نشست یا برنامه برای یک کاربر مشخص. برای مثال: .RS .ad l # malcontent\-client query\-usage bob login-session "" .PP # malcontent\-client query\-usage bob app "org.gnome.gedit" .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که اطلاعات استفاده برای او دریافت می‌شود. .\" .IP "\fBRECORD\-TYPE IDENTIFIER\fP" نوع رکورد و شناسه‌ای که رکوردهای آن باید مورد پرس‌وجو قرار گیرند. برای مشاهدهٔ مقادیر معتبر، مستندات دستور \fBrecord\-usage\fP را ببینید. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBget\-estimated\-times\fP (get\-estimated\-times OPTIONS)" .IX Header "گزینه‌های get-estimated-times (get-estimated-times OPTIONS)" .\" پرس‌وجوی محدودیت‌های استفاده و نشست برای کاربر فعلی، جهت محاسبهٔ میزان زمان باقی‌مانده در نشست آنها یا زمان باقی‌مانده برای استفاده از برنامه‌ها. برای مثال: .RS .ad l # malcontent\-client get\-estimated\-times login\-session .ad b .RE .\" .IP "\fBRECORD\-TYPE\fP" نوع رکورد استفاده برای پرس‌وجو. این مقدار می‌تواند \fBlogin\-session\fP یا \fBapp\fP باشد. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .SH "گزینه‌های \fBrequest\-extension\fP (request\-extension OPTIONS)" .IX Header "گزینه‌های request-extension (request-extension OPTIONS)" .\" درخواست تمدید محدودیت زمان استفاده از رایانه (screen time) برای کاربر فعلی، برای نشست آنها یا برنامهٔ مشخص‌شده. برای مثال: .RS .ad l # malcontent\-client request\-extension login\-session "" .ad b .RE .\" .IP "\fBRECORD\-TYPE IDENTIFIER\fP" نوع رکورد و شناسه‌ای که درخواست تمدید برای آن ثبت می‌شود. برای مشاهدهٔ مقادیر معتبر، مستندات دستور \fBrecord\-usage\fP را ببینید. .\" .IP "\fBDURATION\fP" مدت زمان درخواستی برای تمدید (بر حسب ثانیه)، یا صفر تا به والدین اجازه داده شود مدت زمان را انتخاب کنند (معمولاً این به معنای تمدید تا پایان امروز است). (پیش‌فرض: صفر.) .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .SH "گزینه‌های \fBget\-web\-filter\fP (get\-web\-filter OPTIONS)" .IX Header "گزینه‌های get-web-filter (get-web-filter OPTIONS)" .\" دریافت فیلتر وب برای یک کاربر. برای مثال: .RS .ad l # malcontent\-client get\-web\-filter timmy .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که فیلتر وب برای او دریافت می‌شود. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBset\-web\-filter\fP (set\-web\-filter OPTIONS)" .IX Header "گزینه‌های set-web-filter (set-web-filter OPTIONS)" .\" تنظیم فیلتر وب برای یک کاربر و جایگزینی تمام مقادیر قبلی موجود در آن. برای مثال: .RS .ad l # malcontent\-client set\-web\-filter timmy \\ \-\-force\-safe\-search \\ \-\-filter\-type block\-list \\ adult=https://v.firebog.net/hosts/Prigent\-Adult.txt \\ advertising=https://v.firebog.net/hosts/Prigent\-Ads.txt \\ reddit.com \\ ~mastodon.social .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که فیلتر وب برای او تنظیم می‌شود. در صورت مشخص نشدن، به‌طور پیش‌فرض از کاربر فعلی استفاده خواهد شد. .\" .IP "\fBARG\fP" موردی که باید در فیلتر وب کاربر فیلتر شود. این مورد می‌تواند یک جفت \fBid=filter-URI\fP یا یک نام میزبان (hostname) جداگانه جهت مسدودسازی باشد. برای هر دو نوع مورد می‌توان از پیشوند \fB~\fP (تیلدا) استفاده کرد تا به جای مسدود شدن، مجاز دانسته شوند. شناسهٔ منبع فیلتر (filter URI) باید به یک فایل متنی با همان قالب \fB/etc/hosts\fP اشاره کند که وب‌سایت‌های مشمول فیلتر در آن فهرست شده‌اند. شناسهٔ (ID) مرتبط، یک رشتهٔ الفبایی-عددی دلخواه است که برای ردیابی فیلتر در طول زمان به کار می‌رود، حتی اگر URI اصلی آن تغییر کند. می‌توان چندین مورد را مشخص کرد، و آنها به‌طور کامل جایگزین فیلتر وب فعلی کاربر خواهند شد. در صورت مشخص نشدن هیچ موردی (صفر مورد)، فیلتر وب پاک خواهد شد. .\" .IP "\fB\-\-force\-safe\-search\fP" اجبار به فعال‌سازی حالت «جستجوی ایمن» (safe search) برای موتورهای جستجوی شناخته‌شده و وب‌سایت‌های پرطرفدار. .\" .IP "\fB\-\-filter\-type\fP" نوع فیلتر وب مورد استفاده برای این کاربر. مقادیر ممکن عبارتند از: .RS .IP \fBnone\fP \- بدون فیلتر وب. .IP \fBblock\-list\fP \- وب‌سایت‌ها به‌طور پیش‌فرض مجاز هستند، مگر اینکه در یکی از فهرست‌های مسدودسازی (block lists) آمده باشند. وب‌سایت‌های موجود در فهرست‌های مجاز (allow lists) همواره مجاز هستند. .IP \fBallow\-list\fP \- وب‌سایت‌ها به‌طور پیش‌فرض مسدود هستند، مگر اینکه در یکی از فهرست‌های مجاز آمده باشند. فهرست‌های مسدودسازی نادیده گرفته می‌شوند. .RE .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBupdate\-web\-filters\fP (update\-web\-filters OPTIONS)" .IX Header "گزینه‌های update-web-filters (update-web-filters OPTIONS)" .\" بارگیری و به‌روزرسانی فیلترهای وب کامپایل‌شده برای یک کاربر خاص یا برای تمام کاربران. این دستور، پیکربندی فعلی فیلتر وب کاربر را خوانده و پایگاه دادهٔ فیلتر کامپایل‌شده را با استفاده از آن پیکربندی به‌روزرسانی می‌کند. برای مثال: .RS .ad l # malcontent\-client update\-web\-filters timmy .ad b .RE .\" برای به‌روزرسانی پیکربندی فیلتر وب یک کاربر، از \fBmalcontent\-client set\-web\-filter\fP استفاده کنید. .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که فیلترهای وب برای او به‌روزرسانی می‌شوند. در صورت مشخص نشدن، فیلترهای وب برای تمام کاربرانی که این فیلترها را تنظیم کرده‌اند به‌روزرسانی خواهد شد. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "گزینه‌های \fBdump\-web\-filters\fP (dump\-web\-filters OPTIONS)" .IX Header "گزینه‌های dump-web-filters (dump-web-filters OPTIONS)" .\" تخلیه و نمایش (Dump) فیلترهای وب کامپایل‌شده برای یک کاربر خاص یا برای تمام کاربران. این‌ها همان قواعد فیلتری هستند که در حال حاضر مورد استفاده قرار می‌گیرند. برای مثال: .RS .ad l # malcontent\-client dump\-web\-filters timmy .ad b .RE .\" .IP "\fBUSER\fP" نام کاربری یا شناسهٔ کاربری (ID) کاربری که فیلترهای وب برای او تخلیه می‌شوند. در صورت مشخص نشدن، فیلترهای وب برای تمام کاربرانی که این فیلترها را تنظیم کرده‌اند تخلیه خواهد شد. .\" .IP "\fB\-q\fP، \fB\-\-quiet\fP" با پیشرفت عملیات، تنها پیام‌های خطا نمایش داده شوند و هیچ پیام اطلاع‌رسانی ارائه نشود. (پیش‌فرض: نمایش پیام‌های اطلاع‌رسانی.) .\" .IP "\fB\-n\fP، \fB\-\-no\-interactive\fP" اجازه احراز هویت تعاملی از طریق polkit داده نشود. اگر برای تکمیل عملیات به این مورد نیاز باشد، عملیات با شکست مواجه خواهد شد. (پیش‌فرض: اجازه احراز هویت تعاملی داده می‌شود.) .\" .SH "محیط (ENVIRONMENT)" .IX Header "محیط (ENVIRONMENT)" .\" \fBmalcontent\-client\fP از متغیرهای محیطی استاندارد GLib برای اشکال‌زدایی پشتیبانی می‌کند. این متغیرها برای استفاده در محیط عملیاتی (production) در نظر گرفته \fBنشده‌اند\fP: .\" .IP \fI$G_MESSAGES_DEBUG\fP 4 .IX Item "$G_MESSAGES_DEBUG" این متغیر می‌تواند شامل یک یا چند نام دامنهٔ اشکال‌زدایی برای نمایش خروجی اشکال‌زدایی باشد. مقدار \fIall\fP تمام خروجی‌های اشکال‌زدایی را فعال می‌کند. به‌طور پیش‌فرض، هیچ خروجی اشکال‌زدایی فعال نیست. .\" .SH "وضعیت خروج (EXIT STATUS)" .IX Header "وضعیت خروج (EXIT STATUS)" .\" \fBmalcontent\-client\fP در صورت مواجهه با مشکل، ممکن است یکی از کدهای خطای زیر را بازگرداند. .\" .IP "0" 4 .IX Item "0" هیچ مشکلی رخ نداد. این ابزار اجرا شد و فیلتر برنامه را با موفقیت بررسی کرد. در صورت اجرای دستور \fBcheck\-app\-filter\fP، مسیر، نوع محتوا یا ارجاع flatpak داده‌شده برای کاربر مورد نظر مجاز بوده است. .\" .IP "1" 4 .IX Item "1" هنگام راه‌اندازی، یک گزینهٔ نامعتبر به \fBmalcontent\-client\fP داده شد. .\" .IP "2" 4 .IX Item "2" کاربر فعلی مجوز لازم برای پرس‌وجوی فیلتر برنامه را برای کاربر مورد نظر نداشت. .\" .IP "3" 4 .IX Item "3" در صورت اجرای دستور \fBcheck\-app\-filter\fP، مسیر، نوع محتوا یا ارجاع flatpak داده‌شده برای کاربر مورد نظر مجاز \fIنبود\fP. .\" .IP "4" 4 .IX Item "4" قابلیت Malcontent در سطح سیستم غیرفعال است و بنابراین کنترل‌های والدین فعال نبوده و اعمال نمی‌شود. .\" .IP "5" 4 .IX Item "5" عملیات ناموفق بود و اطلاعات خطای مشخص‌تری در دسترس نیست. .\" .IP "6" 4 .IX Item "6" سرویس مشغول بود؛ کمی بعد دوباره تلاش کنید. .\" .SH "اشکالات (BUGS)" .IX Header "اشکالات (BUGS)" .\" هرگونه اشکالی که پیدا می‌شود باید در وب‌سایت پروژه گزارش شود: .br \fIhttps://gitlab.freedesktop.org/pwithnall/malcontent/-/issues\fP .\" .SH "نویسنده (AUTHOR)" .IX Header "نویسنده (AUTHOR)" .\" Endless Mobile, Inc. Philip Withnall .\" .SH "حق نشر (COPYRIGHT)" .IX Header "حق نشر (COPYRIGHT)" .\" Copyright © 2018 Endless Mobile, Inc. Copyright © 2025 GNOME Foundation, Inc.