'\" t
.TH "SYSTEMD\-JOURNAL\-GATEWAYD\&.SERVICE" "8" "" "systemd 261.2" "systemd-journal-gatewayd.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-gatewayd.service, systemd-journal-gatewayd.socket, systemd-journal-gatewayd \- سرور HTTP برای رویدادهای ژورنال
.SH "خلاصه دستور (SYNOPSIS)"
.PP
systemd\-journal\-gatewayd\&.service
.PP
systemd\-journal\-gatewayd\&.socket
.HP \w'\fB/usr/lib/systemd/systemd\-journal\-gatewayd\fR\ 'u
\fB/usr/lib/systemd/systemd\-journal\-gatewayd\fR [OPTIONS...]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-journal\-gatewayd\fR
رویدادهای ژورنال را روی شبکه ارائه می‌دهد\&. کلاینت‌ها باید با استفاده از HTTP متصل شوند\&. سرور به‌طور پیش‌فرض روی پورت 19531 گوش می‌دهد\&. اگر
\fB\-\-cert=\fR
مشخص شده باشد، سرور انتظار اتصالات HTTPS را دارد\&.
.PP
این برنامه توسط
\fBsystemd\fR(1)
راه‌اندازی می‌شود و انتظار دارد یک سوکت منفرد دریافت کند\&. برای شروع سرویس از
\fBsystemctl start systemd\-journal\-gatewayd\&.socket\fR
و برای راه‌اندازی خودکار آن در زمان بوت از
\fBsystemctl enable systemd\-journal\-gatewayd\&.socket\fR
استفاده کنید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی می‌شوند:
.PP
\fB\-\-cert=\fR
.RS 4
مسیر یک فایل یا سوکت جریانی (stream socket) از نوع
\fBAF_UNIX\fR
را برای خواندن گواهی سرور مشخص می‌کند\&. گواهی باید در قالب PEM باشد\&. این گزینه
\fBsystemd\-journal\-gatewayd\fR
را به حالت HTTPS تغییر می‌دهد و باید همراه با
\fB\-\-key=\fR
استفاده شود\&.
.sp
اضافه‌شده در نسخهٔ 198\&.
.RE
.PP
\fB\-\-key=\fR
.RS 4
مسیر یک فایل یا سوکت جریانی
\fBAF_UNIX\fR
را برای خواندن کلید خصوصی سرور متناظر با گواهی مشخص‌شده با
\fB\-\-cert=\fR
تعیین می‌کند\&. کلید باید در قالب PEM باشد\&.
.sp
اضافه‌شده در نسخهٔ 198\&.
.RE
.PP
\fB\-\-trust=\fR
.RS 4
مسیر یک فایل یا سوکت جریانی
\fBAF_UNIX\fR
را برای خواندن گواهی مرجع صدور گواهی (CA) تعیین می‌کند\&. گواهی باید در قالب PEM باشد\&.
.sp
اضافه‌شده در نسخهٔ 236\&.
.RE
.PP
\fB\-\-system\fR, \fB\-\-user\fR
.RS 4
ورودی‌های ارائه‌شده را به ورودی‌های سرویس‌های سیستمی و هسته، یا به ورودی‌های سرویس‌های کاربر فعلی محدود می‌کند\&. این گزینه‌ها معنایی مشابه با گزینه‌های
\fB\-\-system\fR
و
\fB\-\-user\fR
در
\fBjournalctl\fR(1)
دارند\&. اگر هیچ‌کدام مشخص نشوند، تمام ورودی‌های دردسترس ارائه می‌شوند\&.
.sp
اضافه‌شده در نسخهٔ 249\&.
.RE
.PP
\fB\-m\fR, \fB\-\-merge\fR
.RS 4
ورودی‌ها را به صورت درهم‌آمیخته (interleaved) از تمام ژورنال‌های دردسترس، شامل سایر ماشین‌ها، ارائه می‌دهد\&. این گزینه معنایی مشابه با گزینهٔ
\fB\-\-merge\fR
در
\fBjournalctl\fR(1)
دارد\&.
.sp
اضافه‌شده در نسخهٔ 249\&.
.RE
.PP
\fB\-D \fR\fB\fIDIR\fR\fR, \fB\-\-directory=\fR\fB\fIDIR\fR\fR
.RS 4
یک مسیر دایرکتوری را به عنوان آرگومان می‌گیرد\&. در صورت تعیین،
\fBsystemd\-journal\-gatewayd\fR
به جای مسیرهای پیش‌فرض ژورنال سیستمی و زمان اجرا، دایرکتوری ژورنال مشخص‌شدهٔ
\fIDIR\fR
را ارائه خواهد داد\&.
.sp
اضافه‌شده در نسخهٔ 232\&.
.RE
.PP
\fB\-\-file=\fR\fB\fIGLOB\fR\fR
.RS 4
یک الگوی فایل (file glob) را به عنوان آرگومان می‌گیرد\&. ورودی‌ها را از فایل‌های ژورنال مشخص‌شده منطبق با
\fIGLOB\fR
به جای مسیرهای پیش‌فرض ژورنال سیستمی و زمان اجرا ارائه می‌دهد\&. این گزینه می‌تواند چندین بار مشخص شود که در این صورت فایل‌ها به شکل مناسبی درهم‌آمیخته خواهند شد\&. این گزینه معنایی مشابه با گزینهٔ
\fB\-\-file=\fR
در
\fBjournalctl\fR(1)
دارد\&.
.sp
اضافه‌شده در نسخهٔ 249\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشتهٔ نسخهٔ کوتاه چاپ کرده و خارج می‌شود\&.
.RE
.SH "نشانی‌های وب پشتیبانی‌شده (SUPPORTED URLS)"
.PP
نشانی‌های وب زیر شناخته می‌شوند:
.PP
/boots
.RS 4
یک پاسخ json\-seq (مطابق RFC 7464) شامل اشیاء JSON بازمی‌گرداند که هرکدام شامل شمارهٔ بوت، شناسهٔ آن و برچسب‌های زمانی اولین و آخرین پیام است\&. بوت‌ها به ترتیبی بازگردانده می‌شوند که آخرین بوت در ابتدا قرار می‌گیرد و از همان ساختار (schema) دستور
\fBjournalctl \-\-list\-boots \-\-output json\fR
استفاده می‌کنند\&.
.sp
اضافه‌شده در نسخهٔ 258\&.
.RE
.PP
/browse
.RS 4
مرور تعاملی (Interactive browsing)\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.PP
/entries[?option1&option2=value\&...]
.RS 4
دریافت رویدادها در قالب‌های گوناگون\&.
.sp
بخش
\fBAccept:\fR
از سرآیند HTTP قالب را تعیین می‌کند\&. مقادیر پشتیبانی‌شده در زیر شرح داده شده‌اند\&.
.sp
بخش
\fBRange:\fR
از سرآیند HTTP محدودهٔ رویدادهای بازگردانده‌شده را تعیین می‌کند\&. مقادیر پشتیبانی‌شده در زیر شرح داده شده‌اند\&.
.sp
می‌توان از پارامترهای GET برای تغییر رویدادهای بازگردانده‌شده استفاده کرد\&. پارامترهای پشتیبانی‌شده در زیر شرح داده شده‌اند\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.PP
/machine
.RS 4
یک ساختار JSON در توصیف ماشین بازمی‌گرداند\&.
.sp
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
{ "machine_id" : "8cf7ed9d451ea194b77a9f118f3dc446",
  "boot_id" : "3d3c9efaf556496a9b04259ee35df7f7",
  "hostname" : "fedora",
  "os_pretty_name" : "Fedora 19 (Rawhide)",
  "virtualization" : "kvm",
  \&...}
.fi
.if n \{\
.RE
.\}
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.PP
/fields/\fIFIELD_NAME\fR
.RS 4
فهرستی از مقادیر این فیلد موجود در لاگ‌ها را بازمی‌گرداند\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.SH "سرآیند ACCEPT (ACCEPT HEADER)"
.PP
\fBAccept: \fR\fB\fIformat\fR\fR
.PP
قالب‌های شناخته‌شده:
.PP
\fBtext/plain\fR
.RS 4
حالت پیش‌فرض\&. خروجی متنی ساده شبیه به syslog، یک خط برای هر ورودی ژورنال (مانند
\fBjournalctl \-\-output short\fR)\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.PP
\fBapplication/json\fR
.RS 4
ورودی‌ها به عنوان ساختارهای دادهٔ JSON، یک مورد در هر خط قالب‌بندی می‌شوند (مانند
\fBjournalctl \-\-output json\fR)\&. برای اطلاعات بیشتر
\m[blue]\fBقالب JSON ژورنال (Journal JSON Format)\fR\m[]\&\s-2\u[1]\d\s+2
را ببینید\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.PP
\fBtext/event\-stream\fR
.RS 4
ورودی‌ها به عنوان ساختارهای دادهٔ JSON، بسته‌بندی‌شده در قالبی مناسب برای
\m[blue]\fBرویدادهای ارسالی از سرور (Server\-Sent Events)\fR\m[]\&\s-2\u[2]\d\s+2
قالب‌بندی می‌شوند (مانند
\fBjournalctl \-\-output json\-sse\fR)\&.
.sp
اضافه‌شده در نسخهٔ 229\&.
.RE
.PP
\fBapplication/vnd\&.fdo\&.journal\fR
.RS 4
ورودی‌ها در یک جریان باینری (اما عمدتاً متنی) که برای پشتیبان‌گیری و انتقال روی شبکه مناسب است سریال‌سازی می‌شوند (مانند
\fBjournalctl \-\-output export\fR)\&. برای اطلاعات بیشتر
\m[blue]\fBقالب صدور ژورنال (Journal Export Format)\fR\m[]\&\s-2\u[3]\d\s+2
را ببینید\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.SH "سرآیند RANGE (RANGE HEADER)"
.PP
\fBRange: entries=[\fR\fB\fIcursor\fR\fR\fB][[:\fR\fB\fInum_skip\fR\fR\fB]:[\fR\fB\fInum_entries\fR\fR\fB]]\fR
.PP
\fBRange: realtime=[\fR\fB\fIsince\fR\fR\fB]:[\fR\fB\fIuntil\fR\fR\fB][[:\fR\fB\fInum_skip\fR\fR\fB]:\fR\fB\fInum_entries\fR\fR\fB]\fR
.PP
که در آن
\fIcursor\fR
یک رشتهٔ مکان‌نما (cursor) است و به‌طور پیش‌فرض به اولین ورودی اشاره دارد،
\fIsince\fR
و
\fIuntil\fR
برچسب‌های زمانی هستند (ثانیه‌ها از مبدا زمانی 1970\-01\-01 00:00:00 UTC)،
\fInum_skip\fR
یک عدد صحیح است،
\fInum_entries\fR
یک عدد صحیح بدون علامت است\&.
.PP
محدوده (Range) به‌طور پیش‌فرض شامل تمام رویدادهای موجود است\&.
.PP
اگر
\fInum_skip\fR
منفی باشد و هیچ
\fIcursor\fR
مشخص نشده باشد، آخرین ورودی نقطهٔ مرجع خواهد بود\&.
.SH "پارامترهای GET در URL (URL GET PARAMETERS)"
.PP
پارامترهای زیر می‌توانند به عنوان بخشی از نشانی وب (URL) استفاده شوند:
.PP
follow
.RS 4
منتظر رویدادهای جدید می‌ماند (مانند
\fBjournalctl \-\-follow\fR؛ تعداد رویدادهای بازگردانده‌شده نامحدود است، مگر اینکه
\fInum_entries\fR
در سرآیند
\fIRange\fR
مشخص شده باشد)\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.PP
discrete
.RS 4
بررسی می‌کند که آیا مکان‌نمای (cursor) مشخص‌شده به ورودی‌ای در ژورنال ارجاع دارد یا خیر\&. فقط همین ورودی را بازمی‌گرداند\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.PP
boot
.RS 4
رویدادها را به بوت جاری سیستم محدود می‌کند (مانند
\fBjournalctl \-b\fR)\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.PP
\fIKEY\fR=\fImatch\fR
.RS 4
تطبیق فیلدهای ژورنال\&.
\fBsystemd.journal-fields\fR(7)
را ببینید\&.
.sp
اضافه‌شده در نسخهٔ 197\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
دریافت رویدادهای این بوت از ژورنال محلی در
\m[blue]\fBقالب صدور ژورنال (Journal Export Format)\fR\m[]\&\s-2\u[3]\d\s+2:
.sp
.if n \{\
.RS 4
.\}
.nf
curl \-\-silent \-H\*(AqAccept: application/vnd\&.fdo\&.journal\*(Aq \e
       \*(Aqhttp://localhost:19531/entries?boot\*(Aq
.fi
.if n \{\
.RE
.\}
.PP
شنود رویدادهای تخلیه حافظه (core dump):
.sp
.if n \{\
.RS 4
.\}
.nf
curl \*(Aqhttp://localhost:19531/entries?follow&MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1\*(Aq
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBjournalctl\fR(1), \fBsystemd.journal-fields\fR(7), \fBsystemd-journald.service\fR(8), \fBsystemd-journal-remote.service\fR(8), \fBsystemd-journal-upload.service\fR(8)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
قالب JSON ژورنال (Journal JSON Format)
.RS 4
\%https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-json-format
.RE
.IP " 2." 4
رویدادهای ارسالی از سرور (Server-Sent Events)
.RS 4
\%https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events
.RE
.IP " 3." 4
قالب صدور ژورنال (Journal Export Format)
.RS 4
\%https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-export-format
.RE