'\" t
.TH "JOURNAL\-UPLOAD\&.CONF" "5" "" "systemd 261.2" "journal-upload.conf"
.\" -----------------------------------------------------------------
.\" * 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)"
journal-upload.conf \- فایل پیکربندی ارسال گزارشهای ژورنال به سرور راه دور
.SH "خلاصه دستور (SYNOPSIS)"
.PP
/etc/systemd/journal\-upload\&.conf
.PP
/run/systemd/journal\-upload\&.conf
.PP
/usr/lib/systemd/journal\-upload\&.conf
.PP
/etc/systemd/journal\-upload\&.conf\&.d/*\&.conf
.PP
/run/systemd/journal\-upload\&.conf\&.d/*\&.conf
.PP
/usr/lib/systemd/journal\-upload\&.conf\&.d/*\&.conf
.SH "توضیحات (DESCRIPTION)"
.PP
این فایل‌ها پارامترهای مختلف
\fBsystemd-journal-upload.service\fR(8)
را پیکربندی می‌کنند\&. برای توضیح کلی درباره نحوه نگارش و ساختار، به
\fBsystemd.syntax\fR(7)
مراجعه کنید\&.
.SH "دایرکتوریهای پیکربندی و اولویتبندی (CONFIGURATION DIRECTORIES AND PRECEDENCE)"
.PP
پیکربندی پیش‌فرض در زمان کامپایل تعیین می‌شود، بنابراین پیکربندی تنها زمانی مورد نیاز است که انحراف از آن مقادیر پیش‌فرض لازم باشد\&. فایل پیکربندی اصلی از یکی از دایرکتوری‌های فهرست‌شده به ترتیب اولویت بارگذاری می‌شود و تنها اولین فایل یافت‌شده مورد استفاده قرار می‌گیرد:
/etc/systemd/،
/run/systemd/،
/usr/local/lib/systemd/
\&\s-2\u[1]\d\s+2،
/usr/lib/systemd/\&. نسخه ارائه‌شده توسط توزیع‌کننده (vendor) شامل ورودی‌های کامنت‌شده‌ای است که مقادیر پیش‌فرض را به عنوان راهنمای مدیر سیستم نشان می‌دهد\&. بازنویسی‌های محلی را می‌توان با ایجاد قطعه‌کدهای پیکربندی تکمیلی (drop-in) مطابق توضیحات زیر نیز انجام داد\&. فایل پیکربندی اصلی را نیز می‌توان برای این منظور ویرایش کرد (یا یک رونوشت در
/etc/
اگر در
/usr/
عرضه شده باشد)، با این وجود استفاده از فایل‌های تکمیلی (drop-in) برای پیکربندی محلی نسبت به تغییر فایل پیکربندی اصلی توصیه می‌شود\&.
.PP
علاوه بر فایل پیکربندی اصلی، قطعه‌کدهای پیکربندی تکمیلی (drop-in) از دایرکتوری‌های
/usr/lib/systemd/*\&.conf\&.d/،
/usr/local/lib/systemd/*\&.conf\&.d/
و
/etc/systemd/*\&.conf\&.d/
خوانده می‌شوند\&. این فایل‌های تکمیلی اولویت بالاتری دارند و فایل پیکربندی اصلی را بازنویسی می‌کنند\&. فایل‌های موجود در زیردایرکتوری‌های پیکربندی
*\&.conf\&.d/
صرف‌نظر از اینکه در کدام‌یک از زیردایرکتوری‌ها قرار دارند، بر اساس نام فایل خود به ترتیب واژه‌نگاری (lexicographic) مرتب می‌شوند\&. هنگامی که چندین فایل یک گزینه یکسان را تعیین می‌کنند، برای گزینه‌هایی که فقط یک مقدار منفرد را می‌پذیرند، ورودی موجود در فایلی که آخرین ترتیب را دارد اولویت می‌یابد، و برای گزینه‌هایی که فهرستی از مقادیر را می‌پذیرند، ورودی‌ها به همان ترتیبی که در فایل‌های مرتب‌شده ظاهر می‌شوند جمع‌آوری می‌گردند\&.
.PP
هنگامی که بسته‌ها نیاز به سفارشی‌سازی پیکربندی دارند، می‌توانند فایل‌های تکمیلی را در
/usr/
نصب کنند\&. فایل‌های موجود در
/etc/
برای مدیر سیستم محلی رزرو شده‌اند، که می‌تواند از این منطق برای بازنویسی فایل‌های پیکربندی نصب‌شده توسط بسته‌های توزیع‌کننده استفاده کند\&. برای بازنویسی قطعات تکمیلی بسته، باید از فایل‌های تکمیلی استفاده شود، زیرا فایل پیکربندی اصلی اولویت پایین‌تری دارد\&. توصیه می‌شود نام تمام فایل‌ها در این زیردایرکتوری‌ها با یک عدد دورقمی و یک خط تیره پیشوندگذاری شود تا مرتب‌سازی آن‌ها ساده‌تر گردد\&. این کار همچنین مفهوم اولویت‌های تکمیلی را تعریف می‌کند تا به توزیع‌کنندگان سیستم‌عامل اجازه دهد فایل‌های تکمیلی را در محدوده خاصی پایین‌تر از محدوده مورد استفاده کاربران عرضه کنند\&. این امر خطر بازنویسی تصادفی فایل‌های تکمیلی تعریف‌شده توسط کاربران را با فایل‌های تکمیلی بسته‌ها کاهش می‌دهد\&. توصیه می‌شود از محدوده 10\-40 برای فایل‌های تکمیلی در
/usr/
و از محدوده 60\-90 برای فایل‌های تکمیلی در
/etc/
و
/run/
استفاده شود، تا اطمینان حاصل گردد که فایل‌های تکمیلی محلی و گذرا بر فایل‌های تکمیلی عرضه‌شده توسط توزیع‌کننده سیستم‌عامل اولویت دارند\&.
.PP
برای غیرفعال کردن یک فایل پیکربندی ارائه‌شده توسط توزیع‌کننده، روش توصیه‌شده قرار دادن یک پیوند نمادین (symlink) به
/dev/null
در دایرکتوری پیکربندی در
/etc/
با همان نام فایل پیکربندی توزیع‌کننده است\&.
.SH "گزینهها (OPTIONS)"
.PP
تمام گزینه‌ها در بخش [Upload] پیکربندی می‌شوند:
.PP
\fIURL=\fR
.RS 4
نشانی وب (URL) برای ارسال ورودی‌های ژورنال به آن\&. برای شرح مقادیر ممکن، به توضیح گزینه
\fB\-\-url=\fR
در
\fBsystemd-journal-upload\fR(8)
مراجعه کنید\&. هیچ مقدار پیش‌فرضی وجود ندارد، بنابراین برای انجام ارسال گزارش، این گزینه یا گزینه معادل آن در خط فرمان باید همیشه مشخص شده باشد\&.
.sp
در نگارش 232 اضافه شد\&.
.RE
.PP
\fIServerKeyFile=\fR
.RS 4
کلید SSL در قالب PEM\&.
.sp
در نگارش 232 اضافه شد\&.
.RE
.PP
\fIServerCertificateFile=\fR
.RS 4
گواهی CA اس‌اس‌ال (SSL) در قالب PEM\&.
.sp
در نگارش 232 اضافه شد\&.
.RE
.PP
\fITrustedCertificateFile=\fR
.RS 4
گواهی CA اس‌اس‌ال (SSL)\&.
.sp
در نگارش 232 اضافه شد\&.
.RE
.PP
\fINetworkTimeoutSec=\fR
.RS 4
هنگامی که اتصال شبکه به سرور قطع می‌شود، این گزینه مدت‌زمان انتظار برای برقراری مجدد اتصال را پیکربندی می‌کند\&. اگر سرور برای مدت‌زمان پیکربندی‌شده از طریق شبکه در دسترس نباشد،
\fBsystemd\-journal\-upload\fR
خارج می‌شود\&. مقداری بر حسب ثانیه (یا در سایر واحدهای زمانی اگر با "ms"، "min"، "h" و غیره پسوندگذاری شود) می‌پذیرد\&. برای جزئیات بیشتر، به
\fBsystemd.time\fR(7)
مراجعه کنید\&.
.sp
در نگارش 249 اضافه شد\&.
.RE
.PP
\fICompression=\fR
.RS 4
الگوریتم فشرده‌سازی را که باید قبل از ارسال روی داده‌های گزارش اعمال شود پیکربندی می‌کند\&. فهرستی از الگوریتم‌های فشرده‌سازی جداشده با فاصله، یا
"no"
را می‌پذیرد\&. الگوریتم‌های پشتیبانی‌شده عبارتند از
"zstd"،
"xz"
یا
"lz4"\&. به صورت اختیاری، هر الگوریتم می‌تواند با یک دونقطه (":") و سطح فشرده‌سازی آن دنبال شود، برای مثال
"zstd:4"\&. انتظار می‌رود سطح فشرده‌سازی یک عدد صحیح مثبت باشد\&. هنگامی که
"no"
تعیین شود، هیچ الگوریتم فشرده‌سازی روی داده‌های ارسالی اعمال نخواهد شد\&. این گزینه می‌تواند چندین بار مشخص شود\&. اگر یک رشته خالی اختصاص داده شود، تمام تخصیص‌های قبلی پاک می‌شوند\&. مقدار پیش‌فرض تنظیم‌نشده (unset) است و تمام الگوریتم‌های فشرده‌سازی پشتیبانی‌شده با سطوح فشرده‌سازی پیش‌فرض آن‌ها فهرست می‌شوند\&.
.sp
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
Compression=zstd:4 lz4:2
.fi
.if n \{\
.RE
.\}
.sp
حتی در زمانی که فشرده‌سازی فعال باشد، درخواست‌های اولیه بدون فشرده‌سازی ارسال می‌شوند\&. فشرده‌سازی تنها زمانی اثرگذار می‌شود که
"ForceCompression="
فعال باشد، یا اینکه پاسخ سرور حاوی هدرهای
"Accept\-Encoding"
همراه با فهرستی از الگوریتم‌های فشرده‌سازی باشد که شامل یکی از الگوریتم‌های مشخص‌شده در این گزینه است\&.
.sp
در نگارش 258 اضافه شد\&.
.RE
.PP
\fIForceCompression=\fR
.RS 4
یک مقدار بولی می‌پذیرد، استفاده از فشرده‌سازی را بدون مذاکره بر سر کدگذاری محتوا الزامی می‌کند\&. پیش‌فرض
"false"
است\&.
.sp
در نگارش 258 اضافه شد\&.
.RE
.PP
\fIHeader=\fR
.RS 4
یک هدر HTTP اضافی را برای اضافه شدن به هر درخواست به یک URL مشخص می‌کند\&. یک جفت نام و مقدار هدر جداشده با دونقطه (":") می‌پذیرد، مانند
"Name:Value"\&. نام هدر علاوه بر این می‌تواند شامل نویسه‌های حرفی\-عددی، نمادهای
"_"
و
"\-"
باشد\&. این گزینه ممکن است بیش از یک بار مشخص شود که در این حالت تمام هدرهای فهرست‌شده تنظیم خواهند شد\&. اگر نام هدر یکسانی بیش از یک بار فهرست شود، تمام مقادیر یکتای آن با کاما به یکدیگر متصل می‌شوند\&. تنظیم
\fIHeader=\fR
روی یک رشته خالی تمام تخصیص‌های قبلی را پاک می‌کند\&.
.sp
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
Header=HeaderName: HeaderValue
Header=HeaderName: NewValue
Header=HeaderName: HeaderValue
.fi
.if n \{\
.RE
.\}
.sp
هدر
"HeaderName"
را با مقدار
"HeaderValue, NewValue"
به هر درخواست HTTP اضافه می‌کند\&.
.sp
در نگارش 258 اضافه شد\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd-journal-upload.service\fR(8)، \fBsystemd\fR(1)، \fBsystemd-journald.service\fR(8)
.SH "نکات (NOTES)"
.IP " 1." 4
💣💥🧨💥💥💣 لطفاً توجه داشته باشید که این فایل‌های پیکربندی باید همیشه در دسترس باشند. اگر
/usr/local/
یک پارتیشن جداگانه باشد، ممکن است در مراحل اولیه بوت در دسترس نباشد و نباید برای پیکربندی استفاده شود.