'\" t
.\"     Title: sssctl
.\"    Author: The SSSD upstream - https://github.com/SSSD/sssd/
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/09/2026
.\"    Manual: SSSD Manual pages
.\"    Source: SSSD
.\"  Language: English
.\"
.TH "SSSCTL" "8" "06/09/2026" "SSSD" "SSSD Manual pages"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
sssctl \- ابزار کنترل و وضعیت SSSD
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsssctl\fR\ 'u
\fBsssctl\fR \fICOMMAND\fR [\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsssctl\fR
روشی ساده و یکپارچه برای دریافت اطلاعات درباره وضعیت SSSD، مانند سرور فعال، سرورهای شناسایی‌شده خودکار، دامنه‌ها و اشیاء ذخیره‌شده در حافظه موقت (کَش) ارائه می‌دهد\&. علاوه بر این، می‌تواند پرونده‌های داده SSSD را برای عیب‌یابی به روشی مدیریت کند که دستکاری آن‌ها هنگام اجرای SSSD ایمن باشد\&.
.SH "دستورهای موجود (AVAILABLE COMMANDS)"
.PP
برای فهرست کردن تمامی دستورهای موجود،
\fBsssctl\fR
را بدون هیچ پارامتری اجرا کنید\&. برای چاپ راهنمای مربوط به دستور انتخاب‌شده،
\fBsssctl COMMAND \-\-help\fR
را اجرا نمایید\&.
.SH "گزینه‌های عمومی (COMMON OPTIONS)"
.PP
این گزینه‌ها برای تمامی دستورها در دسترس هستند\&.
.PP
\fB\-\-debug\fR \fILEVEL\fR
.RS 4
ابزار SSSD از دو روش برای مشخص کردن سطح اشکال‌زدایی (دیباگ) پشتیبانی می‌کند\&. ساده‌ترین راه مشخص کردن یک مقدار ده‌دهی از 0 تا 9 است که به منزله فعال‌سازی آن سطح و تمام پیام‌های اشکال‌زدایی سطوح پایین‌تر است\&. گزینه جامع‌تر مشخص کردن یک بیت‌ماسک هگزادسیمال برای فعال یا غیرفعال کردن سطوح خاص است (مثلاً اگر مایلید یک سطح را مسدود کنید)\&.
.sp
سطوح اشکال‌زدایی در حال حاضر پشتیبانی‌شده:
.sp
\fI0\fR,
\fI0x0010\fR: خرابی‌های مرگبار (Fatal)\&. هر چیزی که مانع راه‌اندازی SSSD شود یا باعث توقف اجرای آن گردد\&.
.sp
\fI1\fR,
\fI0x0020\fR: خرابی‌های بحرانی (Critical)\&. خطایی که SSSD را متوقف نمی‌کند، اما نشان می‌دهد که دست‌کم یکی از قابلیت‌های اصلی به درستی کار نخواهد کرد\&.
.sp
\fI2\fR,
\fI0x0040\fR: خرابی‌های جدی (Serious)\&. خطایی که اعلام می‌کند یک درخواست یا عملیات خاص ناموفق بوده است\&.
.sp
\fI3\fR,
\fI0x0080\fR: خرابی‌های جزئی (Minor)\&. خطاهایی که به سطوح پایین‌تر نفوذ کرده و باعث شکست عملیات در سطح 2 می‌شوند\&.
.sp
\fI4\fR,
\fI0x0100\fR: تنظیمات پیکربندی\&.
.sp
\fI5\fR,
\fI0x0200\fR: داده‌های توابع\&.
.sp
\fI6\fR,
\fI0x0400\fR: پیام‌های ردگیری (Trace) برای توابع عملیاتی\&.
.sp
\fI7\fR,
\fI0x1000\fR: پیام‌های ردگیری برای توابع کنترلی داخلی\&.
.sp
\fI8\fR,
\fI0x2000\fR: محتویات متغیرهای داخلی توابع که ممکن است جالب توجه باشند\&.
.sp
\fI9\fR,
\fI0x4000\fR: اطلاعات ردگیری بسیار سطح پایین\&.
.sp
\fI10\fR,
\fI0x10000\fR: اطلاعات ردگیری حتی سطح پایین‌تر libldb\&. تقریباً هرگز واقعاً مورد نیاز نیست\&.
.sp
برای ثبت سطوح اشکال‌زدایی بیت‌ماسک مورد نیاز، کافی است اعداد آن‌ها را مانند مثال‌های زیر با هم جمع کنید:
.sp
\fIمثال\fR: برای ثبت خرابی‌های مرگبار، بحرانی، جدی و داده‌های توابع از 0x0270 استفاده کنید\&.
.sp
\fIمثال\fR: برای ثبت خرابی‌های مرگبار، تنظیمات پیکربندی، داده‌های توابع و پیام‌های ردگیری برای توابع کنترلی داخلی از 0x1310 استفاده کنید\&.
.sp
\fIیادداشت\fR: قالب بیت‌ماسک برای سطوح اشکال‌زدایی در نگارش 1\&.7\&.0 معرفی شد\&.
.sp
\fIپیش‌فرض\fR: 0x0070 (یعنی خرابی‌های مرگبار، بحرانی و جدی؛ معادل تنظیم 2 در نماد ده‌دهی)
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsssd\fR(8),
\fBsssd.conf\fR(5),
\fBsssd-ldap\fR(5),
\fBsssd-ldap-attributes\fR(5),
\fBsssd-krb5\fR(5),
\fBsssd-simple\fR(5),
\fBsssd-ipa\fR(5),
\fBsssd-ad\fR(5),
\fBsssd-idp\fR(5),
\fBsssd-sudo\fR(5),
\fBsssd-session-recording\fR(5),
\fBsss_cache\fR(8),
\fBsss_debuglevel\fR(8),
\fBsss_obfuscate\fR(8),
\fBsss_seed\fR(8),
\fBsssd_krb5_locator_plugin\fR(8),
\fBsss_ssh_authorizedkeys\fR(1), \fBsss_ssh_knownhosts\fR(1),
\fBsssd-ifp\fR(5),
\fBpam_sss\fR(8)\&.
\fBsss_rpcidmapd\fR(5)
.SH "نویسندگان (AUTHORS)"
.PP
\fBتوسعه‌دهندگان بالادستی SSSD \- https://github.com/SSSD/sssd\fR