'\" t
.\"     Title: tlsrpt-fetcher
.\"    Author: Boris Lohner
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-01
.\"    Manual: tlsrpt-fetcher
.\"    Source: tlsrpt-fetcher
.\"  Language: Persian
.\"
.TH "TLSRPT\-FETCHER" "1" "2026-09-01" "tlsrpt\-fetcher" "tlsrpt\-fetcher"
.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\-fetcher \- عامل انتقال داده جهت آوردن داده‌های گزارش TLSRPT از tlsrpt\-collectd به tlsrpt\-reportd.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBtlsrpt\-fetcher\fP [\fIOPTION\fP] \fIDAY\fP [\fIDOMAIN\fP]
.SH "توضیحات (DESCRIPTION)"
.sp
برنامهٔ \fBtlsrpt\-fetcher\fP توسط \fBtlsrpt\-reportd\fP فراخوانی می‌شود تا داده‌های از پیش تجمیع‌شده را از \fBtlsrpt\-collectd\fPها جمع‌آوری کند.
بازیابی داده‌ها در دو مرحله انجام می‌پذیرد.
.sp
در مرحلهٔ نخست، \fBreportd\fP فهرستی از دامنه‌هایی که برای آن‌ها داده جمع‌آوری شده است را درخواست می‌کند.
.sp
در این مرحله، \fBreportd\fP ابتدا بررسی می‌کند که آیا \fBtlsrpt\-fetcher\fP از نسخهٔ پروتکل سازگار پشتیبانی می‌کند یا خیر، تا در صورتی که نسخه‌های آینده از پروتکل متفاوتی استفاده کنند مشکلی پیش نیاید.
بنابراین، سطر نخست نشان‌دهندهٔ نسخهٔ پروتکل واکِش‌گر (fetcher) است.
.sp
سطر دوم زمان فعلی بستهٔ tlsrpt\-collectd/tlsrpt\-fetcher است.
اگر این زمان اختلاف زیادی با زمان \fBtlsrpt\-reportd\fP داشته باشد، هشداری داده می‌شود مبنی بر اینکه ممکن است داده‌ها به‌طور کامل پردازش نشده باشند.
.sp
سطرهای بعدی شامل دامنه‌ها هستند، در هر سطر یک دامنه.
پایان فهرست با سطری که تنها شامل یک کاراکتر «.» تکی است مشخص می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-\-storage\fP=\fIURL\fP
.RS 4
استفاده از فضای ذخیره‌سازی دادهٔ مشخص‌شده توسط \fIURL\fP.
.RE
.SS "گزینه‌های عمومی (General options)"
.sp
\fB\-\-config_file\fP=\fIfilename\fP
.RS 4
خواندن گزینه‌ها از بخش tlsrpt_fetcher در فایل پیکربندی سبک INI با نام \fIfilename\fP.
متغیرهای محیطی بر تنظیمات فایل پیکربندی اولویت دارند و گزینه‌های خط فرمان بر هر دوی آن‌ها تقدم دارند.
.RE
.sp
\fB\-\-help\fP
.RS 4
چاپ پیام راهنما که تمامی گزینه‌ها را شرح می‌دهد.
.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
تمام گزینه‌های پیکربندی به‌جز \fB\-\-help\fP و \fB\-\-config_file\fP را می‌توان از طریق متغیرهای محیطی نیز تنظیم کرد.
متغیر محیطی برای هر گزینهٔ پیکربندی، شامل پیشوند TLSRPT_FETCHER_ است که به دنبال آن نام تنظیم پیکربندی با حروف بزرگ می‌آید.
به عنوان مثال، گزینهٔ \fB\-\-log_level\fP را می‌توان در عوض با استفاده از متغیر محیطی TLSRPT_FETCHER_LOG_LEVEL پیکربندی کرد.
.SH "وضعیت خروج (EXIT STATUS)"
.sp
\fB0\fP
.RS 4
موفقیت.
.RE
.sp
\fB1\fP
.RS 4
شکست. داده‌ها تحویل داده نشدند.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
واکشی فهرست دامنه‌هایی که برای روز 2001\-02\-03 داده‌های گزارش دارند.
یک هدر پروتکل انتقال و فهرستی از دامنه‌ها با یک دامنه در هر سطر چاپ می‌شود.
هدر پروتکل از دو سطر تشکیل شده است:
\- نسخهٔ پروتکل
\- زمان فعلی منبع داده در قالب UTC
.sp
یک کاراکتر «.» تکی پایان فهرست را مشخص می‌کند:
.sp
\fBtlsrpt\-fetcher 2001\-02\-03\fP
.sp
واکشی جزئیات گزارش برای دامنهٔ example.com برای روز 2001\-02\-03:
.sp
\fBtlsrpt\-fetcher 2001\-02\-03 example.com\fP
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBtlsrpt\-collectd\fP(1)، \fBtlsrpt\-reportd\fP(1)
.SH "نویسندگان (AUTHORS)"
.sp
Boris Lohner