'\" t
.TH "SYSTEMD\-JOURNAL\-REMOTE\&.SERVICE" "8" "" "systemd 261.2" "systemd-journal-remote.service"
.\" -----------------------------------------------------------------
.\" * 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-journal-remote.service, systemd-journal-remote.socket, systemd-journal-remote \- دریافت پیام‌های ژورنال از طریق شبکه
.SH "خلاصه دستور (SYNOPSIS)"
.PP
systemd\-journal\-remote\&.service
.PP
systemd\-journal\-remote\&.socket
.HP \w'\fB/usr/lib/systemd/systemd\-journal\-remote\fR\ 'u
\fB/usr/lib/systemd/systemd\-journal\-remote\fR [OPTIONS...] [\-o/\-\-output=\fIDIR\fR|\fIFILE\fR] [SOURCES...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBsystemd\-journal\-remote\fR
ابزاری برای دریافت رویدادهای سریال‌سازی‌شدهٔ ژورنال و ذخیرهٔ آن‌ها در پرونده‌های ژورنال است\&. جریان‌های ورودی در
\m[blue]\fBقالب صدور ژورنال (Journal Export Format)\fR\m[]\&\s-2\u[1]\d\s+2،
یعنی مشابه خروجی
\fBjournalctl \-\-output=export\fR
هستند\&. برای انتقال از طریق شبکه، این جریان سریال‌سازی‌شده معمولاً بر روی یک اتصال HTTPS منتقل می‌شود\&.
.PP
سرویس
systemd\-journal\-remote\&.service
یک سرویس سیستمی است که از
\fBsystemd\-journal\-remote\fR
برای گوش دادن به اتصالات استفاده می‌کند\&.
واحد
systemd\-journal\-remote\&.socket
نشانی شبکه‌ای را که
systemd\-journal\-remote\&.service
روی آن گوش می‌دهد پیکربندی می‌کند\&. به‌طور پیش‌فرض، این پورت 19532 است\&. این‌که چه اتصالاتی پذیرفته شوند و داده‌های دریافتی چگونه ذخیره گردند، می‌تواند از طریق پروندهٔ پیکربندی
\fBjournal-remote.conf\fR(5)
پیکربندی شود\&.
.SH "منابع (SOURCES)"
.PP
منابع می‌توانند «فعال» (active) باشند (که در آن
\fBsystemd\-journal\-remote\fR
داده‌ها را درخواست کرده و دریافت می‌کند)، یا «غیرفعال» (passive) باشند (که در آن
\fBsystemd\-journal\-remote\fR
منتظر یک اتصال می‌ماند و سپس رویدادهای ارسالی از طرف مقابل را دریافت می‌کند)\&.
.PP
\fBsystemd\-journal\-remote\fR
می‌تواند بیش از یک جریان رویداد را هم‌زمان بخواند\&. آن‌ها در پروندهٔ خروجی به‌صورت درهم‌آمیخته (interleaved) ذخیره خواهند شد\&. در مورد اتصالات «فعال»، هر «منبع» یک جریان است، و در مورد اتصالات «غیرفعال»، هر اتصال می‌تواند به یک جریان جداگانه تبدیل شود\&. سوکت‌ها را می‌توان در حالت "accept" (یعنی تنها یک اتصال)، یا حالت "listen" (یعنی چندین اتصال که هرکدام به یک جریان منجر می‌شوند) پیکربندی کرد\&.
.PP
هنگامی که هیچ اتصال دیگری وجود نداشته باشد، و امکان ایجاد اتصال جدیدی هم نباشد (هیچ سوکت شنودکننده‌ای وجود نداشته باشد)، آن‌گاه
\fBsystemd\-journal\-remote\fR
خارج خواهد شد\&.
.PP
منابع فعال را می‌توان به روش‌های زیر مشخص کرد:
.PP
[SOURCES]
.RS 4
هنگامی که
\fB\-\fR
به عنوان یک آرگومان موضعی داده شود، رویدادها از ورودی استاندارد خوانده خواهند شد\&. سایر آرگومان‌های موضعی به عنوان نام پرونده‌ها برای باز کردن و خواندن از آن‌ها در نظر گرفته می‌شوند\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-url=\fR\fB\fIADDRESS\fR\fR
.RS 4
با گزینهٔ
\fB\-\-url=\fR\fB\fIADDRESS\fR\fR،
رویدادها با استفاده از HTTP از
\fIADDRESS\fR
واکشی خواهند شد\&. این نشانی اینترنتی (URL) باید به ریشهٔ یک نمونهٔ راه دور
\fBsystemd-journal-gatewayd\fR(8)
اشاره کند، مانند http://some\&.host:19531 یا https://some\&.host:19531\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-getter=\*(Aq\fR\fB\fIPROG\fR\fR\fB \fR\fB[OPTIONS]\fR\fB\*(Aq\fR
.RS 4
برنامه‌ای که برای واکشی داده‌ها فراخوانی می‌شود\&. جریان رویدادهای ژورنال باید در خروجی استاندارد تولید شود\&.
.sp
مثال‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-getter=\*(Aqcurl "\-HAccept: application/vnd\&.fdo\&.journal" https://some\&.host:19531\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
\-\-getter=\*(Aqwget \-\-header="Accept: application/vnd\&.fdo\&.journal" \-O\- https://some\&.host:19531\*(Aq
.fi
.if n \{\
.RE
.\}
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
منابع غیرفعال را می‌توان به روش‌های زیر مشخص کرد:
.PP
\fB\-\-listen\-raw=\fR\fB\fIADDRESS\fR\fR
.RS 4
\fIADDRESS\fR
باید نشانی مناسبی برای
\fBListenStream=\fR
باشد (مقایسه کنید با
\fBsystemd.socket\fR(5))\&.
\fBsystemd\-journal\-remote\fR
روی این سوکت برای دریافت اتصالات گوش فرا خواهد داد\&. انتظار می‌رود هر اتصال یک جریان از رویدادهای ژورنال باشد\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-listen\-http=\fR\fB\fIADDRESS\fR\fR, \fB\-\-listen\-https=\fR\fB\fIADDRESS\fR\fR
.RS 4
\fIADDRESS\fR
باید یا یک عدد صحیح منفی باشد، که در این صورت به عنوان شماره توصیف‌کننده پرونده (منفی‌شده) تفسیر می‌شود، یا نشانی مناسبی برای
\fBListenStream=\fR
باشد (مقایسه کنید با
\fBsystemd.socket\fR(5))\&.
در حالت نخست، سرور به‌طور پیش‌فرض روی پورت 19532 گوش می‌دهد، و توصیف‌کننده پرونده منطبق باید از طریق
\fI$LISTEN_FDS\fR/\fI$LISTEN_PID\fR
به ارث برسد\&. در حالت دوم، یک سرور HTTP یا HTTPS روی این پورت ایجاد خواهد شد، به ترتیب برای
\fB\-\-listen\-http=\fR
و
\fB\-\-listen\-https=\fR\&.
در حال حاضر، تنها درخواست‌های POST به
/upload
با
"Content\-Type: application/vnd\&.fdo\&.journal"
پشتیبانی می‌شوند\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fI$LISTEN_FDS\fR
.RS 4
\fBsystemd\-journal\-remote\fR
از پروتکل
\fI$LISTEN_FDS\fR/\fI$LISTEN_PID\fR
پشتیبانی می‌کند\&. سوکت‌های بازی که از طریق فعال‌سازی سوکت به ارث رسیده‌اند، مانند آن‌هایی عمل می‌کنند که با
\fB\-\-listen\-raw=\fR
توضیح داده شده در بالا باز شده‌اند، مگر اینکه به عنوان آرگومان در
\fB\-\-listen\-http=\-\fR\fB\fIn\fR\fR
یا
\fB\-\-listen\-https=\-\fR\fB\fIn\fR\fR
در بالا مشخص شده باشند\&. در حالت دوم، یک سرور HTTP یا HTTPS با استفاده از این توصیف‌کننده ایجاد خواهد شد و اتصالات باید از طریق پروتکل HTTP برقرار شوند\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-key=\fR
.RS 4
مسیر یک پرونده کلید خصوصی SSL در قالب PEM را می‌گیرد\&. پیش‌فرض
/etc/ssl/private/journal\-remote\&.pem
است\&. این گزینه می‌تواند با
\fB\-\-listen\-https=\fR
استفاده شود\&. اگر مسیر به یک سوکت جریانی
\fBAF_UNIX\fR
در سامانه پرونده اشاره کند، اتصالی به آن برقرار شده و کلید از آن خوانده می‌شود\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-cert=\fR
.RS 4
مسیر یک پرونده گواهی SSL در قالب PEM را می‌گیرد\&. پیش‌فرض
/etc/ssl/certs/journal\-remote\&.pem
است\&. این گزینه می‌تواند با
\fB\-\-listen\-https=\fR
استفاده شود\&. اگر مسیر به یک سوکت جریانی
\fBAF_UNIX\fR
در سامانه پرونده اشاره کند، اتصالی به آن برقرار شده و گواهی از آن خوانده می‌شود\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-trust=\fR
.RS 4
مسیر یک پرونده گواهی مرجع صدور گواهی (CA) اس‌اس‌ال در قالب PEM، یا
\fBall\fR
را می‌گیرد\&. اگر روی
\fBall\fR
تنظیم شود، اعتبارسنجی گواهی غیرفعال خواهد شد\&. پیش‌فرض
/etc/ssl/ca/trusted\&.pem
است\&. این گزینه می‌تواند با
\fB\-\-listen\-https=\fR
استفاده شود\&. اگر مسیر به یک سوکت جریانی
\fBAF_UNIX\fR
در سامانه پرونده اشاره کند، اتصالی به آن برقرار شده و گواهی از آن خوانده می‌شود\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-gnutls\-log=\fR
.RS 4
فهرستی از دسته‌بندی‌های گزارش‌گیری (logging) ابزار gnutls را که با کاما از هم جدا شده‌اند، می‌گیرد\&. این گزینه می‌تواند با
\fB\-\-listen\-http=\fR
یا
\fB\-\-listen\-https=\fR
استفاده شود\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.SH "مقصدها (SINKS)"
.PP
محل قرارگیری ژورنال خروجی را می‌توان با
\fB\-o\fR
یا
\fB\-\-output=\fR
مشخص کرد\&.
.PP
\fB\-o \fR\fB\fIFILE\fR\fR, \fB\-\-output=\fR\fB\fIFILE\fR\fR
.RS 4
در این پرونده ژورنال می‌نویسد\&. نام پرونده باید با
\&.journal
پایان یابد\&. در صورتی که پرونده وجود نداشته باشد، ایجاد خواهد شد\&. در صورت نیاز (پر شدن پرونده ژورنال، یا آسیب دیدن آن)، پرونده طبق قواعد عادی journald تغییر نام داده شده و پروندهٔ ژورنال جدیدی به جای آن ایجاد خواهد شد\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-o \fR\fB\fIDIR\fR\fR, \fB\-\-output=\fR\fB\fIDIR\fR\fR
.RS 4
پرونده‌های ژورنال را در زیر دایرکتوری
\fIDIR\fR
ایجاد خواهد کرد\&. این دایرکتوری باید وجود داشته باشد\&. در صورت نیاز (بزرگ‌تر شدن اندازه پرونده‌های ژورنال از حد مجاز، یا آسیب دیدن آن‌ها)، پرونده‌های ژورنال طبق قواعد عادی journald بازچرخانی (rotate) خواهند شد\&. نام پرونده‌های زیر
\fIDIR\fR
با استفاده از قواعدی که در ادامه شرح داده شده تولید می‌شود\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
اگر از
\fB\-\-output=\fR
استفاده نشود، دایرکتوری خروجی
/var/log/journal/remote/
استفاده خواهد شد\&. در صورتی که پرونده خروجی مشخص نشده باشد، پرونده‌های ژورنال در زیر دایرکتوری انتخاب‌شده ایجاد می‌شوند\&. نام پرونده‌ها به صورت
remote\-\fIhostname\fR\&.journal
خواهد بود، که در آن بخش
\fIhostname\fR
نام میزبان گریزیافتهٔ (escaped) نقطه پایانی مبدأ اتصال، یا نشانی عددی در صورت عدم امکان تعیین نام میزبان است\&.
.PP
در صورتی که منابع «فعال» از طریق آرگومان‌های موضعی یا گزینهٔ
\fB\-\-getter=\fR
مشخص شده باشند، نام پرونده خروجی باید همواره به‌صورت صریح تعیین شود\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-split\-mode\fR
.RS 4
یکی از مقادیر
\fBnone\fR
یا
\fBhost\fR\&.
برای اولی، تنها از یک پرونده ژورنال خروجی استفاده می‌شود\&. برای دومی، یک پرونده خروجی جداگانه بر اساس نام میزبان نقطه پایانی دیگر اتصال به کار گرفته می‌شود\&.
.sp
در صورتی که منابع «فعال» از طریق آرگومان‌های موضعی یا گزینهٔ
\fB\-\-getter=\fR
داده شوند، نام پرونده خروجی همیشه باید به‌طور صریح مشخص شود و تنها مقدار
\fBnone\fR
مجاز است\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-compress\fR [\fIBOOL\fR]
.RS 4
اگر روی
"yes"
تنظیم شود، داده‌ها در ژورنال با استفاده از XZ فشرده می‌شوند\&. مقدار پیش‌فرض
"yes"
است\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-seal\fR [\fIBOOL\fR]
.RS 4
اگر روی
"yes"
تنظیم شود، داده‌ها در ژورنال به‌طور دوره‌ای با استفاده از Forward Secure Sealing مهروموم (امضا) می‌شوند\&. مقدار پیش‌فرض
"no"
است\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.PP
\fB\-\-max\-use=\fR, \fB\-\-keep\-free=\fR, \fB\-\-max\-file\-size=\fR, \fB\-\-max\-files=\fR
.RS 4
این گزینه‌ها تنظیمات متناظر را در پرونده پیکربندی بازنویسی (override) می‌کنند (ببینید
\fBjournal-remote.conf\fR(5))\&.
برای توضیحات این گزینه‌ها آن صفحه را ببینید\&.
.sp
افزوده‌شده در نسخه 261\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
کپی کردن رویدادهای ژورنال محلی به یک دایرکتوری ژورنال دیگر:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl \-o export | systemd\-journal\-remote \-o /tmp/dir/foo\&.journal \-
.fi
.if n \{\
.RE
.\}
.PP
واکشی تمام رویدادهای موجود از یک نمونهٔ راه دور
\fBsystemd-journal-gatewayd\fR(8)
و ذخیرهٔ آن‌ها در
/var/log/journal/remote/remote\-some\&.host\&.journal:
.sp
.if n \{\
.RS 4
.\}
.nf
systemd\-journal\-remote \-\-url http://some\&.host:19531
.fi
.if n \{\
.RE
.\}
.PP
واکشی رویدادهای راه‌اندازی (boot) فعلی و انتظار برای رویدادهای جدید از یک نمونهٔ راه دور
\fBsystemd-journal-gatewayd\fR(8)
و ذخیرهٔ آن‌ها در
/var/log/journal/remote/remote\-some\&.host\&.journal:
.sp
.if n \{\
.RS 4
.\}
.nf
systemd\-journal\-remote \-\-url http://some\&.host:19531/entries?boot&follow
.fi
.if n \{\
.RE
.\}
.sp
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBjournal-remote.conf\fR(5), \fBjournalctl\fR(1), \fBsystemd-journal-gatewayd.service\fR(8), \fBsystemd-journal-upload.service\fR(8), \fBsystemd-journald.service\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
قالب صدور ژورنال (Journal Export Format)
.RS 4
\%https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-export-format
.RE