'\" t
.TH "SYSTEMD\-REPORT" "1" "" "systemd 261.2" "systemd-report"
.\" -----------------------------------------------------------------
.\" * 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)"
systemd-report \- تولید گزارش از معیارهای سیستم
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsystemd\-report\fR\ 'u
\fBsystemd\-report\fR [OPTIONS...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fIتوجه: این دستور در حال حاضر آزمایشی است\&. اگرچه احتمالاً به یک مؤلفه دائمی از systemd تبدیل خواهد شد، اما همچنان ممکن است رفتار و رابط آن تغییر کند\&.\fR
.PP
\fBsystemd\-report\fR
معیارها را از سیستم درخواست کرده و آن‌ها را در خروجی استاندارد می‌نویسد\&.
.SH "فرمان‌ها (COMMANDS)"
.PP
فرمان‌های زیر پشتیبانی می‌شوند:
.PP
\fBmetrics\fR [MATCH...]
.RS 4
فهرستی از مقادیر معیارها را از تمام سرویس‌های محلی ارائه‌دهنده آن‌ها دریافت کرده و در خروجی استاندارد می‌نویسد\&. به صورت اختیاری یک یا چند عبارت تطبیق را برای فیلتر کردن معیارهای نمایشی می‌پذیرد\&. این عبارت می‌تواند نام دقیق یک خانواده معیار برای جستجو یا پیشوندی از آن باشد (که فقط در مرزهای نقطه تطبیق داده می‌شود)\&. اگر چندین تطبیق به عنوان چند پارامتر مشخص شوند، هر معیاری که با
\fIهر یک\fR
از تطبیق‌های مشخص‌شده مطابقت داشته باشد نمایش داده می‌شود\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.PP
\fBdescribe\fR [MATCH...]
.RS 4
فهرستی از خانواده‌های معیار را از تمام سرویس‌های محلی ارائه‌دهنده آن‌ها دریافت کرده و در خروجی استاندارد می‌نویسد\&. این فرمان عمدتاً اطلاعات ایستای مربوط به معیارها، انواع داده آن‌ها و توضیحات خوانا برای انسان را بدون مقادیر برمی‌گرداند\&.
.sp
عبارت‌های تطبیق پشتیبانی‌شده توسط
\fBmetrics\fR
توسط
\fBdescribe\fR
نیز پشتیبانی می‌شوند\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.PP
\fBgenerate\fR [MATCH...]
.RS 4
فهرستی از معیارها را دریافت کرده و یک گزارش JSON ایجاد می‌کند\&.
.sp
عبارت‌های تطبیق پشتیبانی‌شده توسط
\fBmetrics\fR
در اینجا نیز پشتیبانی می‌شوند\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fBupload\fR [MATCH...]
.RS 4
این فرمان می‌تواند برای ارسال گزارش ایجادشده توسط
\fBgenerate\fR
به یک کارساز خارجی استفاده شود\&. دو سازوکار بارگذاری پشتیبانی می‌شود\&. اگر یک نشانی وب
"http://"
یا
"https://"
با
\fB\-\-url=\fR
مشخص شود، یک بارگذاری HTTP به مکان مشخص‌شده انجام خواهد شد\&. در غیر این صورت، از هر سوکتی در
/run/systemd/report\&.upload/
برای فراخوانی
\fBio\&.systemd\&.Report\&.Uploader\&.Upload()\fR
استفاده خواهد شد\&.
.sp
عبارت‌های تطبیق پشتیبانی‌شده توسط
\fBmetrics\fR
در اینجا نیز پشتیبانی می‌شوند\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fBlist\-sources\fR
.RS 4
فهرست منابع معیار شناخته‌شده را نمایش می‌دهد\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-system\fR, \fB\-\-user\fR
.RS 4
پرس‌وجو از منابع معیارهای سراسر سیستم (پیش‌فرض)، یا منابع معیارهای به ازای هر کاربر\&.
.sp
در نسخه 260 اضافه شد\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به یک صفحه‌بند (pager) هدایت نمی‌کند\&.
.RE
.PP
\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
خروجی را در قالب JSON نمایش می‌دهد\&. یکی از مقادیر زیر را می‌پذیرد:
"short"
(برای کوتاه‌ترین خروجی ممکن بدون هیچ‌گونه فضای خالی اضافی یا شکست خط)،
"pretty"
(برای نسخه زیباسازی‌شده همان خروجی، همراه با تورفتگی و شکست خط) یا
"off"
(برای خاموش کردن خروجی JSON، که حالت پیش‌فرض است)\&.
.RE
.PP
\fB\-j\fR
.RS 4
در صورت اجرا در ترمینال معادل
\fB\-\-json=pretty\fR
و در غیر این صورت معادل
\fB\-\-json=short\fR
است\&.
.RE
.PP
\fB\-\-no\-legend\fR
.RS 4
راهنما (legend)، یعنی سرستون‌ها و پاورقی حاوی نکات را چاپ نمی‌کند\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-url=\fR\fB\fIURL\fR\fR
.RS 4
گزارش جمع‌آوری‌شده را به جای نوشتن در خروجی استاندارد، به نشانی مشخص‌شده بارگذاری می‌کند\&.
\fIURL\fR
باید به کارسازی اشاره کند که درخواست‌های POST حاوی بدنه گزارش با قالب JSON را می‌پذیرد\&.
.sp
توجه: نشانی‌های وب
"http://"
و
"https://"
هر دو پشتیبانی می‌شوند، اما
\fIاتصالات از طریق HTTP ساده بدون رمزگذاری برقرار می‌شوند\fR\&. بنابراین، این حالت فقط باید در شرایط خاصی استفاده شود که یکپارچگی و محرمانگی گزارش الزامی نبوده یا از طریق روش‌های دیگر تضمین شده باشد\&. استفاده از
"https://"
توصیه می‌شود\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-key=\fR\fB\fIFILENAME\fR\fR
.RS 4
مسیری به یک فایل کلید SSL با قالب PEM دریافت می‌کند که برای احراز هویت گواهی کلاینت هنگام بارگذاری استفاده می‌شود\&. همچنین می‌تواند روی
"\-"
تنظیم شود تا احراز هویت گواهی کلاینت غیرفعال گردد\&. مقدار پیش‌فرض
/etc/ssl/private/systemd\-report\&.pem
است\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-cert=\fR\fB\fIFILENAME\fR\fR
.RS 4
مسیری به یک فایل گواهی SSL با قالب PEM دریافت می‌کند که برای احراز هویت گواهی کلاینت هنگام بارگذاری استفاده می‌شود\&. مقدار پیش‌فرض
/etc/ssl/certs/systemd\-report\&.pem
است\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-trust=\fR\fB\fIFILENAME\fR\fR\fB|\fR\fB\fBall\fR\fR
.RS 4
مسیری به یک فایل گواهی مرجع گواهی (CA) اس‌اس‌ال با قالب PEM دریافت می‌کند که برای اعتبارسنجی گواهی کارساز استفاده می‌شود، یا رشته لفظی
\fBall\fR
برای غیرفعال کردن کامل بررسی گواهی\&. مقدار پیش‌فرض
/etc/ssl/ca/trusted\&.pem
است\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-network\-timeout=\fR\fB\fISEC\fR\fR
.RS 4
مدت زمان انتظار (تایم‌اوت) برای عملیات بارگذاری شبکه\&. مقداری بر حسب ثانیه (یا در صورت داشتن پسوندهایی مانند
"ms"،
"min"،
"h"
و غیره با سایر واحدهای زمانی) می‌پذیرد؛ برای جزئیات
\fBsystemd.time\fR(7)
را ببینید\&. مقدار پیش‌فرض ۳۰ ثانیه است\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-extra\-header=\fR\fB\fINAME\fR\fR\fB: \fR\fB\fIVALUE\fR\fR
.RS 4
یک هدر HTTP اضافی را به درخواست بارگذاری تزریق می‌کند\&. می‌تواند چندین بار برای افزودن چندین هدر مشخص شود\&. ارسال یک رشته خالی تمام هدرهای اضافه‌شده توسط کاربردهای قبلی
\fB\-\-extra\-header=\fR
را پاک می‌کند\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت، 0 برگردانده می‌شود؛ در غیر این صورت یک کد خطای غیر صفر برگردانده خواهد شد\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1)