TLSRPT-FETCHER(1) tlsrpt-fetcher TLSRPT-FETCHER(1)

tlsrpt-fetcher - عامل انتقال داده جهت آوردن داده‌های گزارش TLSRPT از tlsrpt-collectd به tlsrpt-reportd.

tlsrpt-fetcher [OPTION] DAY [DOMAIN]

برنامهٔ tlsrpt-fetcher توسط tlsrpt-reportd فراخوانی می‌شود تا داده‌های از پیش تجمیع‌شده را از tlsrpt-collectdها جمع‌آوری کند. بازیابی داده‌ها در دو مرحله انجام می‌پذیرد.

در مرحلهٔ نخست، reportd فهرستی از دامنه‌هایی که برای آن‌ها داده جمع‌آوری شده است را درخواست می‌کند.

در این مرحله، reportd ابتدا بررسی می‌کند که آیا tlsrpt-fetcher از نسخهٔ پروتکل سازگار پشتیبانی می‌کند یا خیر، تا در صورتی که نسخه‌های آینده از پروتکل متفاوتی استفاده کنند مشکلی پیش نیاید. بنابراین، سطر نخست نشان‌دهندهٔ نسخهٔ پروتکل واکِش‌گر (fetcher) است.

سطر دوم زمان فعلی بستهٔ tlsrpt-collectd/tlsrpt-fetcher است. اگر این زمان اختلاف زیادی با زمان tlsrpt-reportd داشته باشد، هشداری داده می‌شود مبنی بر اینکه ممکن است داده‌ها به‌طور کامل پردازش نشده باشند.

سطرهای بعدی شامل دامنه‌ها هستند، در هر سطر یک دامنه. پایان فهرست با سطری که تنها شامل یک کاراکتر «.» تکی است مشخص می‌شود.

--storage=URL

استفاده از فضای ذخیره‌سازی دادهٔ مشخص‌شده توسط URL.

--config_file=filename

خواندن گزینه‌ها از بخش tlsrpt_fetcher در فایل پیکربندی سبک INI با نام filename. متغیرهای محیطی بر تنظیمات فایل پیکربندی اولویت دارند و گزینه‌های خط فرمان بر هر دوی آن‌ها تقدم دارند.

--help

چاپ پیام راهنما که تمامی گزینه‌ها را شرح می‌دهد.

--logfilename=filename

استفاده از filename به عنوان فایل لاگ.

--log_level=level

تنظیم سطح لاگ روی level؛ مقادیر مجاز عبارتند از: debug، info، warn، error.

تمام گزینه‌های پیکربندی به‌جز --help و --config_file را می‌توان از طریق متغیرهای محیطی نیز تنظیم کرد. متغیر محیطی برای هر گزینهٔ پیکربندی، شامل پیشوند TLSRPT_FETCHER_ است که به دنبال آن نام تنظیم پیکربندی با حروف بزرگ می‌آید. به عنوان مثال، گزینهٔ --log_level را می‌توان در عوض با استفاده از متغیر محیطی TLSRPT_FETCHER_LOG_LEVEL پیکربندی کرد.

0

موفقیت.

1

شکست. داده‌ها تحویل داده نشدند.

واکشی فهرست دامنه‌هایی که برای روز 2001-02-03 داده‌های گزارش دارند. یک هدر پروتکل انتقال و فهرستی از دامنه‌ها با یک دامنه در هر سطر چاپ می‌شود. هدر پروتکل از دو سطر تشکیل شده است: - نسخهٔ پروتکل - زمان فعلی منبع داده در قالب UTC

یک کاراکتر «.» تکی پایان فهرست را مشخص می‌کند:

tlsrpt-fetcher 2001-02-03

واکشی جزئیات گزارش برای دامنهٔ example.com برای روز 2001-02-03:

tlsrpt-fetcher 2001-02-03 example.com

tlsrpt-collectd(1)، tlsrpt-reportd(1)

Boris Lohner

2026-09-01 tlsrpt-fetcher