'\" t
.\"     Title: tlsrpt-collectd
.\"    Author: Boris Lohner
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-01
.\"    Manual: tlsrpt-collectd
.\"    Source: tlsrpt-collectd
.\"  Language: Persian
.\"
.TH "TLSRPT\-COLLECTD" "1" "2026-09-01" "tlsrpt\-collectd" "tlsrpt\-collectd"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
tlsrpt\-collectd \- دیمنی برای جمع‌آوری داده‌های گزارش TLSRPT از نمونه‌های MTA از طریق سوکت دامنه یونیکس
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtlsrpt\-collectd\fP [\fIگزینه\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
دیمن tlsrpt\-collectd داده‌های مربوط به تحویل موفق رمزگذاری‌شدهٔ ایمیل‌ها یا خطاهای رخ‌داده در حین تلاش برای تحویل را از MTAها جمع‌آوری می‌کند.
این داده‌ها از پیش تجمیع شده و توسط tlsrpt\-fetcherهای متناظر بازیابی خواهند شد.
.sp
دیمن tlsrpt\-collectd می‌تواند از پس‌اندهای ذخیره‌سازی مختلفی استفاده کند و اگر قرار باشد داده‌ها توسط tlsrpt\-reportd استفاده شوند، باید برای هر یک از این پیاده‌سازی‌ها یک پیاده‌سازی fetcher متناظر ارائه شود.
.sp
همچنین امکان پیاده‌سازی پس‌اندهای ذخیره‌سازی که توسط tlsrpt\-reportd پرس‌وجو نمی‌شوند نیز وجود دارد.
چنین پس‌اندهای «ذخیره‌سازی» صرفاً داده‌ها را برای اهداف تحلیلی جمع‌آوری کرده و راهکاری برای بازیابی دوبارهٔ آن‌ها ارائه نمی‌دهند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-storage\fP=\fIURL\fP
.RS 4
استفاده از فضای ذخیره‌سازی داده که با \fIURL\fP مشخص شده است.
این مقدار می‌تواند فهرستی از چند پس‌اند ذخیره‌سازی باشد که با کاما از یکدیگر جدا شده‌اند.
طرح‌وارهٔ URL، نوع پس‌اند ذخیره‌سازی را مشخص می‌کند.
.RE
.sp
\fB\-\-socketname\fP=\fIpath\fP
.RS 4
شنود روی سوکت دامنه یونیکس در \fIpath\fP برای دریافت داده‌های گزارش.
.RE
.sp
\fB\-\-socketuser\fP=\fIname\fP
.RS 4
تنظیم مالکیت کاربریِ سوکت روی \fIname\fP.
.RE
.sp
\fB\-\-socketgroup\fP=\fIname\fP
.RS 4
تنظیم مالکیت گروهیِ سوکت روی \fIname\fP.
.RE
.sp
\fB\-\-socketmode\fP=\fIoctal\fP
.RS 4
تنظیم بیت‌های حالت فایلِ سوکت روی حالت عددی \fIoctal\fP؛ برای نمونه 0200 تا فقط دسترسی نوشتن برای مالک فراهم باشد.
.RE
.sp
\fB\-\-sockettimeout\fP=\fIn\fP
.RS 4
ثبت (Commit) داده‌های تجمیع‌شده در فضای ذخیره‌سازی، در صورتی که \fIn\fP ثانیه از آخرین ثبت گذشته باشد.
.RE
.sp
\fB\-\-max_uncommited_datagrams\fP=\fIn\fP
.RS 4
ثبت داده‌های تجمیع‌شده در فضای ذخیره‌سازی پس از دریافت \fIn\fP دیتاگرام.
.RE
.sp
\fB\-\-retry_commit_datagram_count\fP=\fIn\fP
.RS 4
پس از ناموفق بودن ثبت داده‌های تجمیع‌شده، تلاش مجدد به جای آنکه بلافاصله پس از دیتاگرام بعدی انجام شود، پس از دریافت \fIn\fP دیتاگرام دیگر انجام خواهد شد.
اگر ثبت داده‌ها به دلیل پایان مهلت زمانی (timeout) با شکست مواجه شود، تلاش مجدد پس از هر دیتاگرام ممکن است خطر مواجههٔ پی‌درپی با همان مهلت زمانی را در پی داشته باشد.
تلاش مجدد تنها پس از هر \fIn\fP دیتاگرام، زمان انتظار برای این وقفه‌ها را کاهش می‌دهد.
.RE
.sp
\fB\-\-daily_rollover_script\fP=\fIscript\fP
.RS 4
اگر این گزینه تنظیم شود، پس از گذشت نیمه‌شب به وقت UTC و انجام مراحل نگهداری، \fIscript\fP اجرا خواهد شد.
این قابلیت می‌تواند برای ارسال (push) پایگاه داده collectd به مکانی دیگر در پیکربندی‌هایی مفید باشد که در آن‌ها امکان پرس‌وجوی مستقیم یک TLSRPT\-collectd دوردست توسط TLSRPT\-reportd وجود ندارد، اما TLSRPT\-collectd می‌تواند داده‌ها را به سوی TLSRPT\-reportd ارسال کند.
.RE
.sp
\fB\-\-dump_path_for_invalid_datagram\fP=\fIpath\fP
.RS 4
در صورت دریافت یک دیتاگرام نامعتبر و فعال بودن این گزینه، دیتاگرام نامعتبر در فایلی به نام \fIpath\fP ذخیره خواهد شد.
.RE
.SS "گزینه‌های عمومی (General options)"
.sp
\fB\-\-config_file\fP=\fIfilename\fP
.RS 4
خواندن گزینه‌ها از بخش tlsrpt_collectd در فایل پیکربندی به سبک INI در \fIfilename\fP.
متغیرهای محیطی بر تنظیمات فایل پیکربندی اولویت دارند و گزینه‌های خط فرمان بر هر دو اولویت خواهند داشت.
.RE
.sp
\fB\-\-help\fP
.RS 4
نمایش پیام راهنما که تمامی گزینه‌ها را شرح می‌دهد.
.RE
.sp
\fB\-\-pidfilename\fP=\fIpath\fP
.RS 4
فایلی را مشخص می‌کند که شناسه فرایند (PID) دیمن tlsrpt\-collectd را در خود نگه می‌دارد. یک رشتهٔ خالی مانع از ایجاد فایل PID می‌شود.
.RE
.SS "گزینه‌های ثبت وقایع (Logging options)"
.sp
\fB\-\-logfilename\fP=\fIfilename\fP
.RS 4
استفاده از \fIfilename\fP به عنوان فایل لاگ.
.RE
.sp
\fB\-\-log_level\fP=\fIlevel\fP
.RS 4
تنظیم سطح ثبت وقایع روی \fIlevel\fP؛ مقادیر مجاز: debug، info، warn، error.
.RE
.SH "محیط (ENVIRONMENT)"
.sp
تمامی گزینه‌های پیکربندی به جز \-\-help و \-\-config_file را می‌توان از طریق متغیرهای محیطی نیز تنظیم کرد.
متغیر محیطی متناظر با هر گزینهٔ پیکربندی، شامل پیشوند TLSRPT_COLLECTD_ به همراه نام تنظیم پیکربندی با حروف تمام بزرگ است.
برای نمونه، گزینهٔ \-\-log_level را می‌توان با استفاده از متغیر محیطی TLSRPT_COLLECTD_LOG_LEVEL پیکربندی کرد.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
موفقیت‌آمیز.
.RE
.sp
\fB1\fP
.RS 4
شکست.
داده‌ها تحویل داده نشدند.
.RE
.sp
\fB2\fP
.RS 4
شکست.
داده‌ها تحویل داده نشدند.
.RE
.sp
\fB3\fP
.RS 4
خطای نحوهٔ استفاده (Usage error).
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
اجرای tlsrpt\-collectd با یک فایل پیکربندی خاص و بازنویسی تنظیم log\-level:
.sp
\fBtlsrpt\-collectd \-\-config\-file /path/to/config.cfg \-\-log_level info\fP
.SH "همچنین ببینید (SEE ALSO)"
.sp
man:tlsrpt\-fetcher[1], man:tlsrpt\-reportd[1]
.SH "نویسندگان (AUTHORS)"
.sp
Boris Lohner