'\" t
.TH "JOURNALCTL" "1" "" "systemd 257.13" "journalctl"
.\" -----------------------------------------------------------------
.\" * 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)"
journalctl \- پرسوجو و مشاهده گزارشها و لاگهای ژورنال systemd
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBjournalctl\fR\ 'u
\fBjournalctl\fR [OPTIONS...] [MATCHES...]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBjournalctl\fR
برای چاپ و مشاهده رکوردهای لاگ ذخیره‌شده در ژورنال توسط
\fBsystemd-journald.service\fR(8)
و
\fBsystemd-journal-remote.service\fR(8)\&
به کار می‌رود\&.
.PP
اگر بدون هیچ پارامتری فراخوانی شود، محتویات ژورنالِ در دسترس برای کاربر فراخواننده را، با شروع از قدیمی‌ترین رکورد جمع‌آوری‌شده نمایش می‌دهد\&.
.PP
اگر یک یا چند آرگومان تطابق (match) داده شود، خروجی بر اساس آن‌ها فیلتر می‌شود\&. ساختار تطابق به قالب
"FIELD=VALUE"
است، برای نمونه
"_SYSTEMD_UNIT=httpd\&.service"،
که به مؤلفه‌های یک رکورد ساختاریافته ژورنال اشاره دارد\&. برای مشاهده فهرستی از فیلدهای شناخته‌شده،
\fBsystemd.journal-fields\fR(7)
را ببینید\&. اگر چندین تطابق مربوط به فیلدهای متفاوت مشخص شوند، رکوردهای لاگ بر اساس همه آن‌ها فیلتر می‌شوند، یعنی خروجی حاصل فقط رکوردهایی را نشان می‌دهد که با تمام تطابق‌های تعیین‌شده از این نوع همخوانی داشته باشند\&. اگر دو تطابق بر روی یک فیلد یکسان اعمال شوند، به‌طور خودکار به‌عنوان گزینه‌های جایگزین در نظر گرفته می‌شوند، یعنی خروجی حاصل رکوردهایی را نشان می‌دهد که با هر یک از تطابق‌های مشخص‌شده برای همان فیلد همخوانی داشته باشند\&. در نهایت، نویسه
"+"
می‌تواند به عنوان یک کلمه مجزا میان سایر عبارت‌ها در خط فرمان قرار گیرد\&. این کار باعث می‌شود تمام تطابق‌های قبل و بعد از آن در یک فصل منطقی (یا به عبارتی OR منطقی) با یکدیگر ترکیب شوند\&.
.PP
همچنین می‌توان با مشخص کردن مسیر مطلق یک فایل به عنوان آرگومان، رکوردها را فیلتر کرد\&. مسیر فایل می‌تواند یک فایل معمولی یا یک پیوند نمادین (symbolic link) باشد و فایل باید در زمان اجرای پرس‌وجو وجود داشته باشد\&. اگر مسیر فایل به یک باینری اجرایی اشاره کند، تطابق
"_EXE="
برای مسیر استانداردشده (canonicalized) باینری به پرس‌وجو افزوده می‌شود\&. اگر مسیر فایل به یک اسکریپت اجرایی اشاره کند، تطابق
"_COMM="
برای نام اسکریپت به پرس‌وجو اضافه می‌شود\&. اگر مسیر فایل به یک نود دستگاه (device node) اشاره کند، تطابق‌های
"_KERNEL_DEVICE="
برای نام هسته دستگاه و برای هر یک از دستگاه‌های والد آن به پرس‌وجو افزوده می‌شود\&. پیوندهای نمادین بازگشایی می‌شوند، نام‌های کرنل تولید می‌گردند، و دستگاه‌های والد بر اساس محیط در زمان پرس‌وجو شناسایی می‌شوند\&. به‌طور کلی، یک نود دستگاه بهترین نماینده برای یک دستگاه واقعی است، زیرا رکوردهای لاگ معمولاً شامل فیلدهایی نیستند که یک دستگاه واقعی را مستقیماً شناسایی کنند\&. برای اینکه رکوردهای لاگ حاصل برای دستگاه واقعی دقیق باشند، بخش‌های مربوطه از محیط در زمان ثبت لاگ، به‌ویژه دستگاه واقعی متناظر با نود دستگاه، باید با شرایط در زمان پرس‌وجو یکسان بوده باشند\&. از آنجا که نودهای دستگاه معمولاً پس از راه‌اندازی مجدد سیستم (reboot) دستگاه متناظر خود را تغییر می‌دهند، مشخص کردن مسیر یک نود دستگاه باعث می‌شود رکوردهای حاصل به موارد مربوط به بوت فعلی محدود شوند\&.
.PP
محدودیت‌های بیشتری را می‌توان با استفاده از گزینه‌های
\fB\-\-boot\fR،
\fB\-\-unit=\fR
و غیره اضافه کرد تا رکوردهایی که نشان داده می‌شوند بیشتر فیلتر شوند (AND منطقی)\&.
.PP
خروجی به‌صورت درهم‌آمیخته از تمام فایل‌های ژورنال در دسترس نمایش داده می‌شود، خواه چرخش‌یافته (rotated) باشند یا در حال حاضر در حال نوشتن، و صرف‌نظر از اینکه به خود سیستم تعلق داشته باشند یا ژورنال‌های قابل دسترس کاربران باشند\&. از گزینه
\fB\-\-header\fR
می‌توان برای شناسایی فایل‌هایی که نشان داده
\fIمی‌شوند\fR
استفاده کرد\&.
.PP
مجموعه فایل‌های ژورنال مورداستفاده را می‌توان با استفاده از گزینه‌های
\fB\-\-user\fR،
\fB\-\-system\fR،
\fB\-\-directory=\fR
و
\fB\-\-file=\fR
تغییر داد؛ به موارد زیر مراجعه کنید\&.
.PP
به تمام کاربران دسترسی به ژورنال‌های خصوصی کاربری‌شان داده شده است\&. با این حال، به‌طور پیش‌فرض، فقط کاربر ریشه (root) و کاربرانی که عضو چند گروه خاص هستند اجازه دسترسی به ژورنال سیستم و ژورنال‌های سایر کاربران را دارند\&. اعضای گروه‌های
"systemd\-journal"،
"adm"
و
"wheel"
می‌توانند تمام فایل‌های ژورنال را بخوانند\&. توجه داشته باشید که دو گروه آخر معمولاً امتیازات و اختیارات بیشتری دارند که توسط توزیع مشخص می‌شود\&. اعضای گروه
"wheel"
اغلب می‌توانند وظایف مدیریتی سیستم را انجام دهند\&.
.PP
خروجی به‌طور پیش‌فرض از طریق
\fBless\fR
صفحه‌بندی می‌شود و خطوط طولانی به اندازه پهنای صفحه بریده («کوتاه») می‌شوند\&. بخش پنهان را می‌توان با استفاده از کلیدهای جهت‌نمای چپ و راست مشاهده کرد\&. صفحه‌بندی را می‌توان غیرفعال کرد؛ به گزینه
\fB\-\-no\-pager\fR
و بخش «محیط (ENVIRONMENT)» در زیر مراجعه کنید\&.
.PP
هنگام ارسال خروجی به tty، خطوط بر اساس اولویت رنگ‌آمیزی می‌شوند: خطوط سطح ERROR و بالاتر با رنگ قرمز؛ خطوط سطح WARNING با رنگ زرد؛ خطوط سطح NOTICE برجسته (highlight)؛ خطوط سطح INFO به‌صورت عادی؛ و خطوط سطح DEBUG با رنگ خاکستری نمایش داده می‌شوند\&.
.PP
برای نوشتن رکوردها
\fIبه درون\fR
ژورنال، می‌توان از چند روش استفاده کرد\&. به‌طور کلی، خروجی واحدهای systemd به‌طور خودکار به ژورنال متصل است؛
\fBsystemd-journald.service\fR(8)
را ببینید\&. علاوه بر این، می‌توان از
\fBsystemd-cat\fR(1)
برای ارسال مستقیم پیام‌ها به ژورنال استفاده کرد\&.
.SH "گزینههای منبع (SOURCE OPTIONS)"
.PP
گزینه‌های زیر مکان خواندن رکوردهای ژورنال را کنترل می‌کنند:
.PP
\fB\-\-system\fR, \fB\-\-user\fR
.RS 4
نمایش پیام‌های سرویس‌های سیستمی و کرنل (با
\fB\-\-system\fR)\&.
نمایش پیام‌های سرویس کاربر جاری (با
\fB\-\-user\fR)\&.
اگر هیچ‌کدام مشخص نشود، تمام پیام‌هایی که کاربر می‌تواند ببیند نشان داده می‌شوند\&.
.sp
گزینه
\fB\-\-user\fR
بر نحوه پردازش آرگومان‌های
\fB\-\-unit=\fR
تأثیر می‌گذارد\&. به
\fB\-\-unit=\fR
مراجعه کنید\&.
.sp
توجه داشته باشید که
\fB\-\-user\fR
تنها زمانی کار می‌کند که ثبت پایدار لاگ‌ها (persistent logging) از طریق تنظیم
\fIStorage=\fR
در
\fBjournald.conf\fR(5)
فعال شده باشد\&.
.sp
افزوده‌شده در نسخه 205\&.
.RE
.PP
\fB\-M\fR, \fB\-\-machine=\fR
.RS 4
نمایش پیام‌های یک کانتینر محلی و در حال اجرا\&. نام یک کانتینر را برای اتصال به آن مشخص کنید\&.
.sp
افزوده‌شده در نسخه 209\&.
.RE
.PP
\fB\-m\fR, \fB\-\-merge\fR
.RS 4
نمایش رکوردها به‌صورت درهم‌آمیخته از تمام ژورنال‌های موجود، از جمله ژورنال‌های راه‌دور (remote)\&.
.sp
افزوده‌شده در نسخه 190\&.
.RE
.PP
\fB\-D \fR\fB\fIDIR\fR\fR, \fB\-\-directory=\fR\fB\fIDIR\fR\fR
.RS 4
مسیر یک دایرکتوری را به عنوان آرگومان می‌گیرد\&. در صورت تعیین، journalctl بر روی دایرکتوری ژورنال مشخص‌شده
\fIDIR\fR
به جای مسیرهای پیش‌فرض زمان اجرا و ژورنال سیستمی عمل خواهد کرد\&.
.sp
افزوده‌شده در نسخه 187\&.
.RE
.PP
\fB\-i \fR\fB\fIGLOB\fR\fR, \fB\-\-file=\fR\fB\fIGLOB\fR\fR
.RS 4
یک الگوی سراسری نام فایل (file glob) را به عنوان آرگومان می‌پذیرد\&. در صورت تعیین، journalctl بر روی فایل‌های ژورنال مشخص‌شده منطبق با
\fIGLOB\fR
به جای مسیرهای پیش‌فرض زمان اجرا و ژورنال سیستمی عمل می‌کند\&. این گزینه می‌تواند چندین بار مشخص شود که در این حالت فایل‌ها به‌طور مناسب درهم‌آمیخته می‌شوند\&.
.sp
افزوده‌شده در نسخه 205\&.
.RE
.PP
\fB\-\-root=\fR\fB\fIROOT\fR\fR
.RS 4
مسیر یک دایرکتوری را به عنوان آرگومان می‌گیرد\&. در صورت تعیین،
\fBjournalctl\fR
به جای دایرکتوری ریشه، روی دایرکتوری‌های ژورنال و سلسله‌مراتب فایل کاتالوگ در زیر دایرکتوری مشخص‌شده عمل خواهد کرد (برای نمونه
\fB\-\-update\-catalog\fR
فایل
\fIROOT\fR/var/lib/systemd/catalog/database
را ایجاد خواهد کرد، و فایل‌های ژورنال زیر
\fIROOT\fR/run/journal/
یا
\fIROOT\fR/var/log/journal/
نمایش داده خواهند شد)\&.
.sp
افزوده‌شده در نسخه 201\&.
.RE
.PP
\fB\-\-image=\fR\fB\fIIMAGE\fR\fR
.RS 4
مسیر یک فایل ایمیج دیسک یا نود دستگاه بلوکی را دریافت می‌کند\&. در صورت تعیین،
\fBjournalctl\fR
روی سیستم‌فایل موجود در ایمیج دیسک مشخص‌شده عمل خواهد کرد\&. این گزینه شبیه به
\fB\-\-root=\fR
است، اما روی سیستم‌فایل‌های ذخیره‌شده در ایمیج‌های دیسک یا دستگاه‌های بلوکی عمل می‌کند و بنابراین روشی آسان برای استخراج داده‌های لاگ از ایمیج‌های دیسک فراهم می‌سازد\&. ایمیج دیسک باید یا فقط حاوی یک سیستم‌فایل باشد یا مجموعه‌ای از سیستم‌فایل‌ها در یک جدول پارتیشن GPT که از
\m[blue]\fBمشخصات پارتیشن‌های قابل کشف (Discoverable Partitions Specification)\fR\m[]\&\s-2\u[1]\d\s+2
پیروی می‌کنند\&. برای اطلاعات بیشتر در مورد ایمیج‌های دیسک پشتیبانی‌شده، سوییچ هم‌نام در
\fBsystemd-nspawn\fR(1)\*(Aq
را ببینید\&.
.sp
افزوده‌شده در نسخه 247\&.
.RE
.PP
\fB\-\-image\-policy=\fR\fB\fIpolicy\fR\fR
.RS 4
یک رشته خط‌مشی ایمیج را مطابق با
\fBsystemd.image-policy\fR(7)
به عنوان آرگومان دریافت می‌کند\&. این خط‌مشی هنگام کار با ایمیج دیسک مشخص‌شده از طریق
\fB\-\-image=\fR
(در بالا) اعمال می‌شود\&. در صورت عدم تعیین، پیش‌فرض خط‌مشی
"*"
است، یعنی تمام سیستم‌فایل‌های شناخته‌شده درون ایمیج استفاده می‌شوند\&.
.RE
.PP
\fB\-\-namespace=\fR\fB\fINAMESPACE\fR\fR
.RS 4
یک رشته شناسه فضای‌نام (namespace) ژورنال را به عنوان آرگومان دریافت می‌کند\&. در صورت عدم تعیین، داده‌های جمع‌آوری‌شده توسط فضای‌نام پیش‌فرض نشان داده می‌شوند\&. در صورت تعیین، داده‌های لاگ مربوط به فضای‌نام مشخص‌شده را نمایش می‌دهد\&. اگر فضای‌نام به صورت
"*"
مشخص شود، داده‌های تمام فضاهای‌نام به‌صورت درهم‌آمیخته نمایش داده می‌شوند\&. اگر شناسه فضای‌نام با
"+"
پیشوند شود، داده‌های فضای‌نام مشخص‌شده و فضای‌نام پیش‌فرض به‌صورت درهم‌آمیخته نمایش داده می‌شوند، اما داده‌های دیگر نمایش نخواهند یافت\&. برای جزئیات در مورد فضاهای‌نام ژورنال،
\fBsystemd-journald.service\fR(8)
را ببینید\&.
.sp
افزوده‌شده در نسخه 245\&.
.RE

.SH "گزینههای فیلترکردن (FILTERING OPTIONS)"
.PP
گزینه‌های زیر نحوه فیلتر کردن رکوردهای ژورنال را کنترل می‌کنند:
.PP
\fB\-S\fR, \fB\-\-since=\fR, \fB\-U\fR, \fB\-\-until=\fR
.RS 4
شروع به نمایش رکوردهایی با تاریخ برابر یا جدیدتر از تاریخ مشخص‌شده، یا به ترتیب برابر یا قدیمی‌تر از تاریخ مشخص‌شده\&. قالب مشخصات تاریخ باید به صورت
"2012\-10\-30 18:17:16"
باشد\&. اگر بخش زمان حذف شود،
"00:00:00"
فرض می‌شود\&. اگر فقط بخش ثانیه حذف شود،
":00"
فرض می‌شود\&. اگر بخش تاریخ حذف شود، روز جاری در نظر گرفته می‌شود\&. همچنین رشته‌های
"yesterday" (دیروز)،
"today" (امروز)،
"tomorrow" (فردا)
شناخته می‌شوند که به ترتیب به 00:00:00 روز قبل از روز جاری، روز جاری، یا روز بعد از روز جاری اشاره دارند\&.
"now" (اکنون)
به زمان فعلی اشاره دارد\&. در نهایت، زمان‌های نسبی را می‌توان با پیشوند
"\-"
یا
"+"
مشخص کرد که به ترتیب به زمان‌های قبل یا بعد از زمان فعلی اشاره دارند\&. برای مشخصات کامل زمان و تاریخ،
\fBsystemd.time\fR(7)
را ببینید\&. توجه داشته باشید که
\fB\-\-output=short\-full\fR
برچسب‌های زمانی را چاپ می‌کند که دقیقاً از همین قالب پیروی می‌کنند\&.
.sp
افزوده‌شده در نسخه 195\&.
.RE
.PP
\fB\-c\fR, \fB\-\-cursor=\fR
.RS 4
شروع نمایش رکوردها از موقعیتی در ژورنال که توسط مکان‌نمای (cursor) ارائه‌شده تعیین شده است\&.
.sp
افزوده‌شده در نسخه 193\&.
.RE
.PP
\fB\-\-after\-cursor=\fR
.RS 4
شروع نمایش رکوردها از موقعیتی در ژورنال
\fIپس از\fR
موقعیت تعیین‌شده توسط مکان‌نمای ارائه‌شده\&. مکان‌نما زمانی نشان داده می‌شود که از گزینه
\fB\-\-show\-cursor\fR
استفاده شود\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fB\-\-cursor\-file=\fR\fB\fIFILE\fR\fR
.RS 4
اگر
\fIFILE\fR
وجود داشته باشد و شامل یک مکان‌نما باشد، نمایش رکوردها را از
\fIبعد از\fR
این موقعیت آغاز می‌کند\&. در غیر این صورت، رکوردها را بر اساس سایر گزینه‌های مشخص‌شده نمایش می‌دهد\&. در پایان، مکان‌نمای آخرین رکورد را در
\fIFILE\fR
می‌نویسد\&. از این گزینه برای خواندن مداوم ژورنال از طریق فراخوانی‌های متوالی
\fBjournalctl\fR
استفاده کنید\&.
.sp
افزوده‌شده در نسخه 242\&.
.RE
.PP
\fB\-b \fR\fB[[\fIID\fR][\fI\(+-offset\fR]|\fBall\fR]\fR, \fB\-\-boot\fR\fB[=[\fIID\fR][\fI\(+-offset\fR]|\fBall\fR]\fR
.RS 4
نمایش پیام‌های مربوط به یک بوت مشخص\&. این گزینه یک تطابق برای
"_BOOT_ID="
اضافه می‌کند\&.
.sp
آرگومان می‌تواند خالی باشد، که در این حالت لاگ‌های مربوط به بوت فعلی نمایش داده می‌شوند\&.
.sp
اگر شناسه بوت حذف شود، یک مقدار مثبت
\fIoffset\fR
بوت‌ها را با شروع از ابتدای ژورنال جستجو می‌کند، و یک
\fIoffset\fR
مساوی یا کمتر از صفر، بوت‌ها را با شروع از انتهای ژورنال جستجو خواهد کرد\&. بنابراین،
\fB1\fR
به معنای اولین بوت یافت‌شده در ژورنال به ترتیب زمانی است،
\fB2\fR
دومین بوت و به همین ترتیب؛ در حالی که
\fB\-0\fR
آخرین بوت،
\fB\-1\fR
بوت قبل از آخرین، و الی آخر است\&. یک
\fIoffset\fR
خالی معادل مشخص کردن
\fB\-0\fR
است، مگر در صورتی که بوت فعلی آخرین بوت نباشد (برای نمونه زمانی که
\fB\-\-directory=\fR
برای بررسی لاگ‌های یک ماشین دیگر مشخص شده باشد)\&.
.sp
اگر شناسه ۳۲ نویسه‌ای
\fIID\fR
مشخص شود، می‌تواند به صورت اختیاری با یک
\fIoffset\fR
دنبال شود که بوت را نسبت به بوت تعیین‌شده با
\fIID\fR
مشخص می‌کند\&. مقادیر منفی به معنای بوت‌های قبل‌تر و مقادیر مثبت به معنای بوت‌های بعدتر هستند\&. اگر
\fIoffset\fR
مشخص نشود، مقدار صفر فرض می‌شود و لاگ‌های بوت مشخص‌شده با
\fIID\fR
نمایش داده می‌شوند\&.
.sp
آرگومان ویژه
\fBall\fR
می‌تواند برای خنثی کردن اثر استفاده قبلی از
\fB\-b\fR
به کار رود\&.
.sp
افزوده‌شده در نسخه 186\&.
.RE
.PP
\fB\-u\fR, \fB\-\-unit=\fR\fB\fIUNIT\fR\fR\fB|\fR\fB\fIPATTERN\fR\fR
.RS 4
نمایش پیام‌ها برای واحد systemd مشخص‌شده
\fIUNIT\fR
(مانند یک واحد سرویس)، یا برای هر یک از واحدهای منطبق با الگوی
\fIPATTERN\fR\&.
اگر یک الگو مشخص شود، فهرستی از نام‌های واحدهای موجود در ژورنال با الگوی داده‌شده مقایسه می‌شود و تمام موارد منطبق به کار گرفته می‌شوند\&. برای هر نام واحد، یک تطابق برای پیام‌های صادرشده از آن واحد ("_SYSTEMD_UNIT=\fIUNIT\fR") همراه با تطابق‌های اضافی برای پیام‌های ناشی از systemd و پیام‌های مربوط به خرابی هسته (coredump) برای آن واحد اضافه می‌شود\&. همچنین یک تطابق برای
"_SYSTEMD_SLICE=\fIUNIT\fR"
اضافه می‌شود، به گونه‌ای که اگر
\fIUNIT\fR
ارائه‌شده یک واحد
\fBsystemd.slice\fR(5)
باشد، تمام لاگ‌های مربوط به فرزندان آن برش (slice) نمایش داده خواهند شد\&.
.sp
همراه با گزینه
\fB\-\-user\fR،
تمام آرگومان‌های
\fB\-\-unit=\fR
به گونه‌ای تبدیل می‌شوند که با پیام‌های کاربر مطابقت یابند، گویی با
\fB\-\-user\-unit=\fR
مشخص شده باشند\&.
.sp
این پارامتر می‌تواند چندین بار تکرار شود\&.
.sp
افزوده‌شده در نسخه 195\&.
.RE
.PP
\fB\-\-user\-unit=\fR
.RS 4
نمایش پیام‌ها برای واحد نشست کاربری مشخص‌شده\&. این گزینه یک تطابق برای پیام‌های دریافتی از واحد ("_SYSTEMD_USER_UNIT="
و
"_UID=")
و تطابق‌های اضافی برای پیام‌های ناشی از systemd نشست و پیام‌های مربوط به coredump برای واحد تعیین‌شده اضافه می‌کند\&. همچنین یک تطابق برای
"_SYSTEMD_USER_SLICE=\fIUNIT\fR"
اضافه می‌شود، به‌طوری‌که اگر
\fIUNIT\fR
ارائه‌شده یک واحد
\fBsystemd.slice\fR(5)
باشد، تمام لاگ‌های فرزندان آن واحد نمایش داده خواهند شد\&.
.sp
این پارامتر می‌تواند چندین بار مشخص شود\&.
.sp
افزوده‌شده در نسخه 198\&.
.RE
.PP
\fB\-I\fR, \fB\-\-invocation=\fR\fB\fIID\fR\fR\fB[\fI\(+-offset\fR]\fR\fB|\fR\fB\fIoffset\fR\fR
.RS 4
نمایش پیام‌ها از یک فراخوانی (invocation) مشخص از یک واحد\&. این گزینه یک تطابق برای فیلدهای
"_SYSTEMD_INVOCATION_ID="،
"OBJECT_SYSTEMD_INVOCATION_ID="،
"INVOCATION_ID="،
"USER_INVOCATION_ID="
اضافه می‌کند\&.
.sp
یک
\fIoffset\fR
مثبت، فراخوانی‌های یک واحد systemd را از ابتدای ژورنال جستجو می‌کند، و یک افست صفر یا منفی، فراخوانی‌ها را با شروع از انتهای ژورنال جستجو خواهد کرد\&. بدین ترتیب،
\fB1\fR
به معنای اولین فراخوانی یافت‌شده در ژورنال به ترتیب زمانی است،
\fB2\fR
دومین مورد و به همین ترتیب؛ در حالی که
\fB0\fR
جدیدترین فراخوانی،
\fB\-1\fR
فراخوانی قبل از جدیدترین، و غیره است\&.
.sp
اگر شناسه ۳۲ نویسه‌ای
\fIID\fR
مشخص شود، می‌تواند به صورت اختیاری با یک
\fI\(+-offset\fR
همراه باشد که فراخوانی را نسبت به مورد داده‌شده با
\fIID\fR
مشخص می‌کند\&. مقادیر منفی به معنای فراخوانی‌های پیشین و مقادیر مثبت به معنای فراخوانی‌های پسین هستند\&. اگر
\fI\(+-offset\fR
مشخص نشود، مقدار صفر در نظر گرفته می‌شود و لاگ‌های فراخوانی تعیین‌شده توسط
\fIID\fR
نشان داده می‌شوند\&.
.sp
گزینه
\fB\-I\fR
معادل
\fB\-\-invocation=0\fR
است و لاگ‌های جدیدترین فراخوانی را نمایش می‌دهد\&.
.sp
هنگامی که یک افست مشخص می‌شود، باید نام واحد با استفاده از گزینه
\fB\-u/\-\-unit=\fR
یا
\fB\-\-user\-unit=\fR
مشخص شده باشد\&.
.sp
هنگامی که همراه با
\fB\-b/\-\-boot=\fR
مشخص شود، فراخوانی‌ها در بوت تعیین‌شده جستجو می‌شوند\&.
.sp
افزوده‌شده در نسخه 257\&.
.RE
.PP
\fB\-t\fR, \fB\-\-identifier=\fR\fB\fISYSLOG_IDENTIFIER\fR\fR
.RS 4
نمایش پیام‌ها برای شناسه syslog مشخص‌شده
\fISYSLOG_IDENTIFIER\fR\&.
.sp
این پارامتر می‌تواند چندین بار مشخص شود\&.
.sp
افزوده‌شده در نسخه 217\&.
.RE
.PP
\fB\-T\fR, \fB\-\-exclude\-identifier=\fR\fB\fISYSLOG_IDENTIFIER\fR\fR
.RS 4
مستثنی کردن پیام‌ها برای شناسه syslog مشخص‌شده
\fISYSLOG_IDENTIFIER\fR\&.
.sp
این پارامتر می‌تواند چندین بار مشخص شود\&.
.sp
افزوده‌شده در نسخه 256\&.
.RE
.PP
\fB\-p\fR, \fB\-\-priority=\fR
.RS 4
فیلتر کردن خروجی بر اساس اولویت پیام یا بازه‌های اولویت\&. یک سطح لاگ عددی یا متنی منفرد (یعنی بین 0/"emerg" و 7/"debug")، یا بازه‌ای از سطوح لاگ عددی/متنی به صورت FROM\&.\&.TO را دریافت می‌کند\&. سطوح لاگ همان سطوح معمول syslog هستند همان‌طور که در
\fBsyslog\fR(3)
مستند شده است، یعنی
"emerg"\ \&(0)،
"alert"\ \&(1)،
"crit"\ \&(2)،
"err"\ \&(3)،
"warning"\ \&(4)،
"notice"\ \&(5)،
"info"\ \&(6)،
"debug"\ \&(7)\&.
اگر یک سطح لاگ منفرد مشخص شود، تمام پیام‌های دارای این سطح لاگ یا سطح لاگ پایین‌تر (و بنابراین مهم‌تر) نمایش داده می‌شوند\&. اگر یک بازه مشخص شود، تمام پیام‌های درون بازه، شامل هر دو مقدار ابتدا و انتهای بازه نشان داده خواهند شد\&. این گزینه تطابق‌های
"PRIORITY="
را برای اولویت‌های مشخص‌شده اضافه می‌کند\&.
.sp
افزوده‌شده در نسخه 188\&.
.RE
.PP
\fB\-\-facility=\fR
.RS 4
فیلتر کردن خروجی بر اساس بخش (facility) سیستم syslog\&. فهرستی جداشده با کاما از اعداد یا نام‌های بخش‌ها را دریافت می‌کند\&. این نام‌ها همان بخش‌های معمول syslog هستند که در
\fBsyslog\fR(3)
مستند شده است\&. از
\fB\-\-facility=help\fR
می‌توان برای نمایش فهرستی از نام‌های شناخته‌شده facility و خروج استفاده کرد\&.
.sp
افزوده‌شده در نسخه 245\&.
.RE
.PP
\fB\-g\fR, \fB\-\-grep=\fR
.RS 4
فیلتر کردن خروجی به رکوردهایی که در آن‌ها فیلد
\fIMESSAGE=\fR
با عبارت باقاعده (regular expression) مشخص‌شده همخوانی دارد\&. عبارات باقاعده سازگار با PERL به کار می‌روند؛ برای شرح مفصل قواعد نگارشی،
\fBpcre2pattern\fR(3)
را ببینید\&.
.sp
اگر الگو تماماً با حروف کوچک باشد، انطباق بدون حساسیت به حروف بزرگ و کوچک (case insensitive) انجام می‌شود\&. در غیر این صورت، انطباق حساس به حروف است\&. این رفتار را می‌توان با استفاده از گزینه
\fB\-\-case\-sensitive\fR
لغو کرد؛ به بخش زیر مراجعه فرمایید\&.
.sp
هنگامی که با
\fB\-\-lines=\fR
(بدون پیشوند
"+")
به کار رود، گزینه
\fB\-\-reverse\fR
به‌طور ضمنی فعال می‌شود\&.
.sp
افزوده‌شده در نسخه 237\&.
.RE
.PP
\fB\-\-case\-sensitive\fR\fB[=BOOLEAN]\fR
.RS 4
تنظیم تطابق الگو به صورت حساس یا غیرحساس به حروف بزرگ و کوچک\&.
.sp
افزوده‌شده در نسخه 237\&.
.RE
.PP
\fB\-k\fR, \fB\-\-dmesg\fR
.RS 4
نمایش تنها پیام‌های هسته (کرنل)\&. این گزینه متضمن
\fB\-b\fR
است و تطابق
"_TRANSPORT=kernel"
را اضافه می‌کند\&.
.sp
افزوده‌شده در نسخه 205\&.
.RE

.SH "گزینههای خروجی (OUTPUT OPTIONS)"
.PP
گزینه‌های زیر نحوه چاپ و نمایش رکوردهای ژورنال را کنترل می‌کنند:
.PP
\fB\-o\fR, \fB\-\-output=\fR
.RS 4
قالب‌بندی رکوردهای ژورنال نمایش‌داده‌شده را کنترل می‌کند\&. یکی از گزینه‌های زیر را می‌پذیرد:
.PP
\fBshort\fR
.RS 4
حالت پیش‌فرض است و خروجی تولید می‌کند که تا حد زیادی با قالب‌بندی فایل‌های سنتی syslog یکسان است و یک خط را برای هر رکورد ژورنال نشان می‌دهد\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBshort\-full\fR
.RS 4
بسیار شبیه است، اما برچسب‌های زمانی را در قالبی نشان می‌دهد که گزینه‌های
\fB\-\-since=\fR
و
\fB\-\-until=\fR
می‌پذیرند\&. بر خلاف اطلاعات برچسب زمانی که در حالت خروجی
\fBshort\fR
نمایش می‌یابد، این حالت شامل اطلاعات روز هفته، سال و منطقه زمانی در خروجی بوده و مستقل از محلی‌سازی (locale) سیستم است\&.
.sp
افزوده‌شده در نسخه 232\&.
.RE
.PP
\fBshort\-iso\fR
.RS 4
بسیار شبیه است، اما برچسب‌های زمانی را در نمایه
\m[blue]\fBRFC 3339\fR\m[]\&\s-2\u[2]\d\s+2
از استاندارد ISO 8601 نشان می‌دهد\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBshort\-iso\-precise\fR
.RS 4
همانند
\fBshort\-iso\fR
است اما دقت کامل را تا سطح میکروثانیه شامل می‌شود\&.
.sp
افزوده‌شده در نسخه 234\&.
.RE
.PP
\fBshort\-precise\fR
.RS 4
بسیار شبیه است، اما برچسب‌های زمانی کلاسیک syslog را با دقت کامل تا میکروثانیه نشان می‌دهد\&.
.sp
افزوده‌شده در نسخه 207\&.
.RE
.PP
\fBshort\-monotonic\fR
.RS 4
بسیار شبیه است، اما برچسب‌های زمانی یکنواخت (monotonic) را به جای برچسب زمانی ساعت دیواری (wallclock) نمایش می‌دهد\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBshort\-delta\fR
.RS 4
همانند
\fBshort\-monotonic\fR
است اما اختلاف زمانی با رکورد پیشین را نیز شامل می‌شود\&. اختلاف زمانی‌هایی که ممکن است غیرقابل اتکا باشند با علامت
"*"
مشخص می‌شوند\&.
.sp
افزوده‌شده در نسخه 252\&.
.RE
.PP
\fBshort\-unix\fR
.RS 4
بسیار شبیه است، اما ثانیه‌های سپری‌شده از ۱ ژانویه ۱۹۷۰ بر حسب UTC را به جای برچسب زمانی ساعت دیواری نمایش می‌دهد («زمان یونیکس»)\&. زمان با دقت میکروثانیه نشان داده می‌شود\&.
.sp
افزوده‌شده در نسخه 230\&.
.RE
.PP
\fBverbose\fR
.RS 4
آیتم‌های رکورد را با ساختار کامل و همراه با تمام فیلدها نشان می‌دهد\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBexport\fR
.RS 4
ژورنال را به یک جریان باینری (اما عمدتاً متنی) سریال‌سازی می‌کند که برای پشتیبان‌گیری و انتقال در شبکه مناسب است (برای اطلاعات بیشتر
\m[blue]\fBJournal Export Format\fR\m[]\&\s-2\u[3]\d\s+2
را ببینید)\&. برای وارد کردن مجدد جریان باینری به فرمت بومی journald از
\fBsystemd-journal-remote\fR(8)
استفاده کنید\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBjson\fR
.RS 4
رکوردها را به عنوان اشیاء JSON قالب‌بندی می‌کند که با نویسه‌های خط جدید (newline) از یکدیگر جدا شده‌اند (برای اطلاعات بیشتر
\m[blue]\fBJournal JSON Format\fR\m[]\&\s-2\u[4]\d\s+2
را ببینید)\&. مقادیر فیلدها به‌طور کلی به عنوان رشته‌های JSON کدگذاری می‌شوند، با سه استثنا:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
فیلدهای بزرگتر از ۴۰۹۶ بایت به عنوان مقادیر
\fBnull\fR
کدگذاری می‌شوند\&. (این رفتار را می‌توان با فرستادن
\fB\-\-all\fR
غیرفعال کرد، اما توجه داشته باشید که ممکن است اشیاء بسیار طولانی JSON تخصیص یابند\&.)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
رکوردهای ژورنال اجازه فیلدهای غیرمنحصربه‌فرد را در یک رکورد لاگ می‌دهند\&. JSON وجود فیلدهای غیرمنحصربه‌فرد را درون یک شیء مجاز نمی‌داند\&. به همین دلیل، در صورت مواجهه با یک فیلد غیرمنحصربه‌فرد، یک آرایه JSON به عنوان مقدار فیلد استفاده می‌شود که تمام مقادیر آن فیلد را به عنوان عناصر خود فهرست می‌کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
فیلدهایی که شامل بایت‌های غیرقابل چاپ یا غیر UTF-8 هستند، به عنوان آرایه‌هایی کدگذاری می‌شوند که حاوی بایت‌های خام بوده و به صورت اعداد بدون علامت قالب‌بندی شده‌اند\&.
.RE
.sp
توجه داشته باشید که این کدگذاری برگشت‌پذیر است (به استثنای محدودیت اندازه)\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBjson\-pretty\fR
.RS 4
رکوردها را به عنوان ساختارهای داده JSON قالب‌بندی می‌کند، اما آن‌ها را در چندین خط مرتب می‌سازد تا برای انسان خواناتر باشند\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBjson\-sse\fR
.RS 4
رکوردها را به عنوان ساختارهای داده JSON قالب‌بندی می‌کند، اما آن‌ها را در قالبی مناسب برای
\m[blue]\fBServer\-Sent Events\fR\m[]\&\s-2\u[5]\d\s+2
بسته‌بندی می‌کند\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBjson\-seq\fR
.RS 4
رکوردها را به عنوان ساختارهای داده JSON قالب‌بندی می‌کند، اما بر اساس
\m[blue]\fBJavaScript Object Notation (JSON) Text Sequences\fR\m[]\&\s-2\u[6]\d\s+2
("application/json\-seq")،
نویسه ASCII جداکننده رکورد (0x1E) را به عنوان پیشوند و نویسه ASCII خط جدید (0x0A) را به عنوان پسوند به آن‌ها اضافه می‌کند\&.
.sp
افزوده‌شده در نسخه 240\&.
.RE
.PP
\fBcat\fR
.RS 4
خروجی بسیار مختصری تولید می‌کند که فقط پیام واقعی هر رکورد ژورنال را بدون هیچ متاداده‌ای، حتی بدون برچسب زمانی، نشان می‌دهد\&. در صورت ترکیب با گزینه
\fB\-\-output\-fields=\fR،
به جای پیام، فیلدهای فهرست‌شده را برای هر رکورد لاگ در خروجی نمایش می‌دهد\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.PP
\fBwith\-unit\fR
.RS 4
مشابه
\fBshort\-full\fR
است، اما به جای شناسه سنتی syslog، نام واحد و واحد کاربر را به عنوان پیشوند قرار می‌دهد\&. این گزینه هنگام استفاده از نمونه‌های مبتنی بر الگو (templated instances) بسیار مفید است، چرا که آرگومان‌ها را در نام واحدها می‌گنجاند\&.
.sp
افزوده‌شده در نسخه 239\&.
.RE
.RE
.PP
\fB\-\-truncate\-newline\fR
.RS 4
کوتاه کردن هر پیام لاگ در اولین نویسه خط جدید در خروجی، به طوری که فقط خط اول هر پیام نمایش داده شود\&.
.sp
افزوده‌شده در نسخه 254\&.
.RE
.PP
\fB\-\-output\-fields=\fR
.RS 4
فهرستی جداشده با کاما از فیلدهایی که باید در خروجی گنجانده شوند\&. این گزینه فقط برای حالت‌های خروجی اثر دارد که معمولاً تمام فیلدها را نشان می‌دهند (\fBverbose\fR،
\fBexport\fR،
\fBjson\fR،
\fBjson\-pretty\fR،
\fBjson\-sse\fR
و
\fBjson\-seq\fR)،
و همچنین بر روی
\fBcat\fR\&.
برای حالت‌های اول، فیلدهای
"__CURSOR"،
"__REALTIME_TIMESTAMP"،
"__MONOTONIC_TIMESTAMP"
و
"_BOOT_ID"
همیشه چاپ می‌شوند\&.
.sp
افزوده‌شده در نسخه 236\&.
.RE
.PP
\fB\-n\fR, \fB\-\-lines=\fR
.RS 4
نمایش جدیدترین رویدادهای ژورنال و محدود کردن تعداد رویدادهای نشان‌داده‌شده\&. آرگومان یک عدد صحیح مثبت یا
"all"
برای غیرفعال کردن محدودیت است\&. علاوه بر این، اگر عدد با پیشوند
"+"
همراه باشد، قدیمی‌ترین رویدادهای ژورنال به جای آن استفاده می‌شوند\&. مقدار پیش‌فرض در صورت عدم تعیین آرگومان، ۱۰ است\&.
.sp
اگر از
\fB\-\-follow\fR
استفاده شود، این گزینه به‌طور ضمنی فعال می‌گردد\&. هنگامی که پیشوند
"+"
نداشته باشد و با
\fB\-\-grep=\fR
استفاده شود، گزینه
\fB\-\-reverse\fR
به‌طور ضمنی اعمال خواهد شد\&.
.RE
.PP
\fB\-r\fR, \fB\-\-reverse\fR
.RS 4
معکوس کردن خروجی به گونه‌ای که جدیدترین رکوردها ابتدا نمایش داده شوند\&.
.sp
افزوده‌شده در نسخه 198\&.
.RE
.PP
\fB\-\-show\-cursor\fR
.RS 4
مکان‌نما پس از آخرین رکورد و بعد از دو خط تیره نشان داده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
\-\- cursor: s=0639\&...
.fi
.if n \{\
.RE
.\}
.sp
قالب مکان‌نما اختصاصی است و ممکن است تغییر کند\&.
.sp
افزوده‌شده در نسخه 209\&.
.RE
.PP
\fB\-\-utc\fR
.RS 4
نمایش زمان بر حسب زمان هماهنگ جهانی (UTC)\&.
.sp
افزوده‌شده در نسخه 217\&.
.RE
.PP
\fB\-x\fR, \fB\-\-catalog\fR
.RS 4
تکمیل خطوط لاگ با متون توضیحی از کاتالوگ پیام‌ها\&. این گزینه متن‌های راهنمای توضیحی را در صورت موجود بودن به پیام‌های لاگ در خروجی اضافه می‌کند\&. این متن‌های راهنمای کوتاه، زمینه یک خطا یا رویداد لاگ، راه‌حل‌های احتمالی، و همچنین ارجاعاتی به تالارهای گفتگو، مستندات توسعه‌دهندگان و سایر راهنماهای مربوطه را شرح می‌دهند\&. توجه داشته باشید که متن‌های راهنما برای تمام پیام‌ها در دسترس نیستند، بلکه فقط برای پیام‌های منتخب وجود دارند\&. برای اطلاعات بیشتر در مورد کاتالوگ پیام‌ها،
\m[blue]\fBJournal Message Catalogs\fR\m[]\&\s-2\u[7]\d\s+2
را ببینید\&.
.sp
نکته: هنگام پیوست کردن خروجی
\fBjournalctl\fR
به گزارش‌های باگ، لطفاً از
\fB\-x\fR
استفاده
\fIنکنید\fR\&.
.sp
افزوده‌شده در نسخه 196\&.
.RE
.PP
\fB\-\-no\-hostname\fR
.RS 4
عدم نمایش فیلد نام هاست (hostname) در پیام‌های لاگ\&. این سوییچ فقط بر خانواده حالت‌های خروجی
\fBshort\fR
تأثیر دارد (به بالا مراجعه کنید)\&.
.sp
نکته: این گزینه رخدادهای نام میزبان را از خود رکوردهای لاگ حذف نمی‌کند، بنابراین مانع از مشاهده نام هاست در درون لاگ‌ها نمی‌شود\&.
.sp
افزوده‌شده در نسخه 230\&.
.RE
.PP
\fB\-\-no\-full\fR, \fB\-\-full\fR, \fB\-l\fR
.RS 4
خلاصه‌سازی فیلدها با علامت بیضی (...) هنگامی که در ستون‌های موجود جا نمی‌شوند\&. پیش‌فرض نمایش فیلدها به صورت کامل است، که به آن‌ها اجازه می‌دهد شکسته شوند یا در صورت استفاده از پیجر، توسط پیجر بریده شوند\&.
.sp
گزینه‌های قدیمی
\fB\-l\fR/\fB\-\-full\fR
دیگر کارایی ندارند، مگر برای خنثی کردن اثر
\fB\-\-no\-full\fR\&.
.sp
افزوده‌شده در نسخه 196\&.
.RE
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
نمایش تمام فیلدها به صورت کامل، حتی اگر شامل نویسه‌های غیرقابل چاپ باشند یا بسیار طولانی باشند\&. به‌طور پیش‌فرض، فیلدهای حاوی نویسه‌های غیرقابل چاپ به صورت "blob data" خلاصه می‌شوند\&. (توجه داشته باشید که ابزار پیجر ممکن است دوباره نویسه‌های غیرقابل چاپ را اسکیپ کند\&.)
.RE
.PP
\fB\-f\fR, \fB\-\-follow\fR
.RS 4
نمایش فقط جدیدترین رکوردهای ژورنال، و چاپ مداوم رکوردهای جدید هم‌زمان با اضافه شدن آن‌ها به ژورنال\&.
.RE
.PP
\fB\-\-no\-tail\fR
.RS 4
نمایش تمام خطوط خروجی ذخیره‌شده، حتی در حالت دنبال‌کردن (follow)\&. اثر گزینه
\fB\-\-lines=\fR
را خنثی می‌کند\&.
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
تمام پیام‌های اطلاعاتی (مانند "\-\- Journal begins at \&..."، "\-\- Reboot \-\-") و هرگونه پیام هشدار در مورد ژورنال‌های سیستمی غیرقابل دسترس را هنگام اجرا توسط یک کاربر عادی سرکوب می‌کند\&.
.RE

.SH "گزینههای کنترل پیجر (PAGER CONTROL OPTIONS)"
.PP
گزینه‌های زیر پشتیبانی از صفحه‌بندی (pager) را کنترل می‌کنند:
.PP
\fB\-\-no\-pager\fR
.RS 4
خروجی را به درون یک پیجر لوله‌کشی (pipe) نکند\&.
.RE
.PP
\fB\-e\fR, \fB\-\-pager\-end\fR
.RS 4
در ابزار پیجر ضمنی، بلافاصله به انتهای ژورنال پرش کند\&. این گزینه به‌طور ضمنی
\fB\-n1000\fR
را فعال می‌کند تا اطمینان حاصل شود که پیجر لاگ‌هایی با اندازه نامحدود را در بافر نگه نمی‌دارد\&. این رفتار را می‌توان با یک
\fB\-n\fR
صریح با مقدار عددی دیگری لغو کرد، در حالی که
\fB\-nall\fR
این سقف محدودیت را غیرفعال خواهد کرد\&. توجه داشته باشید که این گزینه فقط برای پیجر
\fBless\fR(1)
پشتیبانی می‌شود\&.
.sp
افزوده‌شده در نسخه 198\&.
.RE
.SH "گزینه‌های FSS (FORWARD SECURE SEALING (FSS) OPTIONS)"
.PP
گزینه‌های زیر می‌توانند همراه با دستور
\fB\-\-setup\-keys\fR
که در زیر شرح داده شده است استفاده شوند:
.PP
\fB\-\-interval=\fR
.RS 4
بازه تغییر کلید مهروموم (sealing key) را هنگام تولید یک جفت‌کلید FSS با
\fB\-\-setup\-keys\fR
مشخص می‌کند\&. بازه‌های کوتاه‌تر مصرف پردازنده (CPU) را افزایش می‌دهند اما بازه زمانی دستکاری‌های غیرقابل شناسایی در ژورنال را کوتاه‌تر می‌کنند\&. مقدار پیش‌فرض 15min است\&.
.sp
افزوده‌شده در نسخه 189\&.
.RE
.PP
\fB\-\-verify\-key=\fR
.RS 4
کلید اعتبارسنجی FSS را برای استفاده در عملیات
\fB\-\-verify\fR
مشخص می‌کند\&.
.sp
افزوده‌شده در نسخه 189\&.
.RE
.PP
\fB\-\-force\fR
.RS 4
هنگامی که
\fB\-\-setup\-keys\fR
داده شود و مهروموم امن رو به جلو (FSS) از قبل پیکربندی شده باشد، کلیدهای FSS را بازتولید می‌کند\&.
.sp
افزوده‌شده در نسخه 206\&.
.RE
.SH "دستورات (COMMANDS)"
.PP
دستورات زیر شناخته می‌شوند\&. در صورت عدم تعیین هیچ‌کدام، حالت پیش‌فرض نمایش رکوردهای ژورنال است:
.PP
\fB\-N\fR, \fB\-\-fields\fR
.RS 4
چاپ تمام نام‌های فیلدهایی که در حال حاضر در تمام رکوردهای ژورنال استفاده شده‌اند\&.
.sp
افزوده‌شده در نسخه 229\&.
.RE
.PP
\fB\-F\fR, \fB\-\-field=\fR
.RS 4
چاپ تمام مقادیر داده‌ای ممکنی که فیلد مشخص‌شده می‌تواند در تمام رکوردهای ژورنال به خود بگیرد\&.
.sp
افزوده‌شده در نسخه 195\&.
.RE
.PP
\fB\-\-list\-boots\fR
.RS 4
نمایش فهرستی جدولی از شماره‌های بوت (نسبت به بوت فعلی)، شناسه‌های آن‌ها، و برچسب‌های زمانی اولین و آخرین پیام مربوط به آن بوت\&. هنگامی که همراه با گزینه
\fB\-n/\-\-lines=\fR\fB[+]\fR\fB\fIN\fR\fR
مشخص شود، فقط اولین موارد (هنگامی که عدد دارای پیشوند
"+")
یا آخرین موارد (بدون پیشوند) به تعداد
\fIN\fR
رکورد نمایش داده می‌شوند\&. هنگامی که با
\fB\-r/\-\-reverse\fR
مشخص شود، فهرست به ترتیب معکوس نشان داده خواهد شد\&.
.sp
افزوده‌شده در نسخه 209\&.
.RE
.PP
\fB\-\-list\-invocations\fR
.RS 4
فهرست کردن شناسه‌های فراخوانی (invocation IDs) یک واحد\&. به نام واحد با
\fB\-u/\-\-unit=\fR
یا
\fB\-\-user\-unit=\fR
نیاز دارد\&. فهرستی جدولی از شماره‌های فراخوانی (نسبت به فراخوانی فعلی یا آخرین)، شناسه‌های آن‌ها، و برچسب‌های زمانی اولین و آخرین پیام مربوط به آن فراخوانی را نشان می‌دهد\&. هنگامی که
\fB\-b/\-boot\fR
مشخص شود، فراخوانی‌ها در بوت مربوطه نشان داده می‌شوند\&. هنگامی که همراه با گزینه
\fB\-n/\-\-lines=\fR\fB[+]\fR\fB\fIN\fR\fR
مشخص شود، فقط اولین موارد (هنگامی که عدد دارای پیشوند
"+")
یا آخرین موارد (بدون پیشوند) به تعداد
\fIN\fR
رکورد نشان داده می‌شوند\&. هنگامی که با
\fB\-r/\-\-reverse\fR
مشخص شود، فهرست به ترتیب معکوس نمایش داده خواهد شد\&.
.sp
افزوده‌شده در نسخه 257\&.
.RE
.PP
\fB\-\-disk\-usage\fR
.RS 4
نمایش میزان مصرف دیسک فعلی توسط تمام فایل‌های ژورنال\&. این گزینه مجموع مصرف دیسک تمام فایل‌های ژورنال بایگانی‌شده و فعال را نشان می‌دهد\&.
.sp
افزوده‌شده در نسخه 190\&.
.RE
.PP
\fB\-\-vacuum\-size=\fR, \fB\-\-vacuum\-time=\fR, \fB\-\-vacuum\-files=\fR
.RS 4
گزینه
\fB\-\-vacuum\-size=\fR
قدیمی‌ترین فایل‌های ژورنال بایگانی‌شده را حذف می‌کند تا زمانی که فضای دیسک مصرفی آن‌ها به زیر اندازه مشخص‌شده کاهش یابد\&. پسوندهای معمول
"K"،
"M"،
"G"
و
"T"
(در مبنای ۱۰۲۴) را می‌پذیرد\&.
.sp
گزینه
\fB\-\-vacuum\-time=\fR
فایل‌های ژورنال بایگانی‌شده قدیمی‌تر از بازه زمانی مشخص‌شده را حذف می‌کند\&. پسوندهای معمول
"s"
(پیش‌فرض)،
"m"،
"h"،
"days"،
"weeks"،
"months"
و
"years"
را می‌پذیرد؛ برای جزئیات
\fBsystemd.time\fR(7)
را ببینید\&.
.sp
گزینه
\fB\-\-vacuum\-files=\fR
تنها تعداد مشخص‌شده از فایل‌های ژورنال مجزا را باقی می‌گذارد\&.
.sp
توجه داشته باشید که اجرای
\fB\-\-vacuum\-size=\fR
فقط یک اثر غیرمستقیم بر خروجی نمایش‌داده‌شده توسط
\fB\-\-disk\-usage\fR
دارد، زیرا دومی شامل فایل‌های ژورنال فعال نیز می‌شود، در حالی که عملیات پاکسازی (vacuuming) فقط روی فایل‌های ژورنال بایگانی‌شده عمل می‌کند\&. به همین ترتیب،
\fB\-\-vacuum\-files=\fR
ممکن است واقعاً تعداد فایل‌های ژورنال را به زیر عدد تعیین‌شده کاهش ندهد، چرا که فایل‌های ژورنال فعال را حذف نمی‌کند\&.
.sp
گزینه‌های
\fB\-\-vacuum\-size=\fR،
\fB\-\-vacuum\-time=\fR
و
\fB\-\-vacuum\-files=\fR
را می‌توان در یک فراخوانی واحد ترکیب کرد تا هر ترکیبی از محدودیت‌های اندازه، زمان و تعداد فایل‌ها بر روی فایل‌های ژورنال بایگانی‌شده اعمال شود\&. تعیین هر یک از این سه پارامتر به صورت صفر معادل عدم اعمال آن محدودیت خاص است و بنابراین زائد خواهد بود\&.
.sp
این سه سوییچ را می‌توان با
\fB\-\-rotate\fR
نیز در یک دستور ترکیب کرد\&. در این حالت، ابتدا تمام فایل‌های فعال چرخانده (rotate) می‌شوند و عملیات پاکسازی درخواستی بلافاصله پس از آن اجرا می‌شود\&. عمل چرخش این اثر را دارد که تمام فایل‌های فعال کنونی بایگانی می‌شوند (و احتمالاً فایل‌های ژورنال خالی جدیدی به عنوان جایگزین باز می‌شوند)، و بنابراین عملیات پاکسازی بیشترین تأثیر را خواهد داشت زیرا می‌تواند تمام داده‌های لاگ نوشته‌شده تا این لحظه را در نظر بگیرد\&.
.sp
افزوده‌شده در نسخه 218\&.
.RE
.PP
\fB\-\-verify\fR
.RS 4
بررسی فایل ژورنال برای سازگاری داخلی\&. اگر فایل با FSS فعال تولید شده باشد و کلید اعتبارسنجی FSS با
\fB\-\-verify\-key=\fR
مشخص شده باشد، اصالت و صحت فایل ژورنال اعتبارسنجی می‌شود\&.
.sp
افزوده‌شده در نسخه 189\&.
.RE
.PP
\fB\-\-sync\fR
.RS 4
از دیمن ژورنال می‌خواهد تمام داده‌های ژورنال را که هنوز نوشته نشده‌اند روی سیستم‌فایل زیرین بنویسد و تمام ژورنال‌ها را همگام‌سازی (synchronize) کند\&. این فراخوانی تا زمانی که عملیات همگام‌سازی کامل نشود بازنمی‌گردد\&. این دستور تضمین می‌کند که هر پیام لاگی که پیش از فراخوانی آن نوشته شده است، در زمان بازگشت دستور با اطمینان روی دیسک ذخیره شده باشد\&.
.sp
افزوده‌شده در نسخه 228\&.
.RE
.PP
\fB\-\-relinquish\-var\fR
.RS 4
از دیمن ژورنال عملیات معکوس
\fB\-\-flush\fR
را درخواست می‌کند: در صورت درخواست، دیمن داده‌های لاگ بعدی را در
/run/log/journal/
می‌نویسد و نوشتن در
/var/log/journal/
را متوقف می‌کند\&. فراخوانی متعاقب
\fB\-\-flush\fR
باعث می‌شود خروجی لاگ دوباره به
/var/log/journal/
تغییر یابد؛ به توضیحات بالا مراجعه کنید\&.
.sp
افزوده‌شده در نسخه 243\&.
.RE
.PP
\fB\-\-smart\-relinquish\-var\fR
.RS 4
مشابه
\fB\-\-relinquish\-var\fR،
اما اگر سیستم‌فایل ریشه و
/var/log/journal/
روی یک نقطه اتصال (mount point) یکسان قرار داشته باشند، هیچ عملیاتی انجام نمی‌دهد\&. این عملیات در حین خاموش شدن سیستم (shutdown) استفاده می‌شود تا دیمن ژورنال نوشتن داده‌ها در
/var/log/journal/
را در صورتی که آن پوشه روی یک نقطه اتصال باشد که باید unmount شود، متوقف کند\&.
.sp
افزوده‌شده در نسخه 243\&.
.RE
.PP
\fB\-\-flush\fR
.RS 4
از دیمن ژورنال می‌خواهد در صورتی که فضای ذخیره‌سازی پایدار فعال باشد، هرگونه داده لاگ ذخیره‌شده در
/run/log/journal/
را به
/var/log/journal/
منتقل و تخلیه (flush) کند\&. این فراخوانی تا زمان تکمیل عملیات بازنمی‌گردد\&. توجه داشته باشید که این فراخوانی بدون اثر جانبی تکرارپذیر (idempotent) است: داده‌ها در طول زمان اجرای سیستم فقط یک بار از
/run/log/journal/
به
/var/log/journal/
تخلیه می‌شوند (البته
\fB\-\-relinquish\-var\fR
در زیر را ببینید)، و اگر این اتفاق قبلاً رخ داده باشد، این دستور بدون اجرای هیچ عملیاتی به‌طور پاک خارج می‌شود\&. این دستور به‌طور موثری تضمین می‌کند که در زمان بازگشت، تمام داده‌ها به
/var/log/journal/
تخلیه شده باشند\&.
.sp
افزوده‌شده در نسخه 217\&.
.RE
.PP
\fB\-\-rotate\fR
.RS 4
از دیمن ژورنال می‌خواهد فایل‌های ژورنال را بچرخاند (rotate کند)\&. این فراخوانی تا زمان تکمیل عملیات چرخش بازنمی‌گردد\&. عمل چرخش فایل‌های ژورنال این اثر را دارد که تمام فایل‌های ژورنال فعال فعلی به عنوان بایگانی‌شده علامت‌گذاری شده و تغییر نام می‌یابند، به گونه‌ای که در آینده هرگز در آن‌ها چیزی نوشته نخواهد شد\&. سپس فایل‌های ژورنال جدید (خالی) به جای آن‌ها ایجاد می‌شوند\&. این عملیات ممکن است با
\fB\-\-vacuum\-size=\fR،
\fB\-\-vacuum\-time=\fR
و
\fB\-\-vacuum\-file=\fR
در یک دستور واحد ترکیب شود؛ به بالا مراجعه کنید\&.
.sp
افزوده‌شده در نسخه 227\&.
.RE
.PP
\fB\-\-header\fR
.RS 4
به جای نمایش محتویات ژورنال، اطلاعات سربرگ (header) داخلی فیلدهای ژورنالِ مورداسترسی را نمایش می‌دهد\&.
.sp
این گزینه به‌ویژه هنگام تلاش برای شناسایی رکوردهای نامرتب ژورنال مفید است، همان‌طور که برای مثال زمانی رخ می‌دهد که ماشین با زمان سیستمی نادرست بوت شده باشد\&.
.sp
افزوده‌شده در نسخه 187\&.
.RE
.PP
\fB\-\-list\-catalog \fR\fB[\fI128\-bit\-ID\&...\fR]\fR
.RS 4
محتویات کاتالوگ پیام‌ها را به صورت جدولی از شناسه‌های پیام، به علاوه رشته‌های توصیف کوتاه آن‌ها فهرست می‌کند\&.
.sp
اگر هر گونه
\fI128\-bit\-ID\fR
مشخص شود، فقط آن رکوردها نشان داده می‌شوند\&.
.sp
افزوده‌شده در نسخه 196\&.
.RE
.PP
\fB\-\-dump\-catalog \fR\fB[\fI128\-bit\-ID\&...\fR]\fR
.RS 4
محتویات کاتالوگ پیام را نشان می‌دهد، به طوری که رکوردها با یک خط شامل دو خط تیره و شناسه از یکدیگر جدا می‌شوند (قالب آن همانند فایل‌های
\&.catalog
است)\&.
.sp
اگر هر گونه
\fI128\-bit\-ID\fR
مشخص شود، فقط آن رکوردها نشان داده می‌شوند\&.
.sp
افزوده‌شده در نسخه 199\&.
.RE
.PP
\fB\-\-update\-catalog\fR
.RS 4
شاخص (index) کاتالوگ پیام‌ها را به‌روزرسانی می‌کند\&. این دستور باید هر بار که فایل‌های کاتالوگ جدیدی نصب، حذف یا به‌روزرسانی می‌شوند اجرا گردد تا شاخص باینری کاتالوگ مجدداً بازسازی شود\&.
.sp
افزوده‌شده در نسخه 196\&.
.RE
.PP
\fB\-\-setup\-keys\fR
.RS 4
به جای نمایش محتویات ژورنال، یک جفت‌کلید جدید برای مهروموم امن روبه‌جلو (FSS) تولید می‌کند\&. این کار یک کلید مهروموم (sealing key) و یک کلید اعتبارسنجی (verification key) ایجاد خواهد کرد\&. کلید مهروموم در دایرکتوری داده‌های ژورنال ذخیره می‌شود و باید بر روی میزبان باقی بماند\&. کلید اعتبارسنجی باید در مکانی خارج از سیستم ذخیره شود\&. برای اطلاعات بیشتر درباره Forward Secure Sealing و پیوندی به یک مقاله علمی داوری‌شده که نظریه رمزنگاری زیربنایی آن را شرح می‌دهد، به گزینه
\fBSeal=\fR
در
\fBjournald.conf\fR(5)
مراجعه فرمایید\&.
.sp
افزوده‌شده در نسخه 189\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
یک رشته کوتاه نسخه را چاپ کرده و خارج می‌شود\&.
.RE

.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت، 0 بازگردانده می‌شود؛ در غیر این صورت، یک کد شکست غیرصفر بازگردانده خواهد شد\&.
.SH "محیط (ENVIRONMENT)"
.PP
\fI$SYSTEMD_LOG_LEVEL\fR
.RS 4
حداکثر سطح لاگ پیام‌های ارسالی (پیام‌های با سطح لاگ بالاتر، یعنی پیام‌های با اهمیت کمتر، سرکوب خواهند شد)\&. فهرستی جداشده با کاما از مقادیر را می‌پذیرد\&. یک مقدار می‌تواند یکی از موارد زیر باشد (به ترتیب کاهش اهمیت):
\fBemerg\fR،
\fBalert\fR،
\fBcrit\fR،
\fBerr\fR،
\fBwarning\fR،
\fBnotice\fR،
\fBinfo\fR،
\fBdebug\fR،
یا یک عدد صحیح در بازه 0\&...7\&. برای اطلاعات بیشتر
\fBsyslog\fR(3)
را ببینید\&. هر مقدار می‌تواند به صورت اختیاری با یکی از پیشوندهای
\fBconsole\fR،
\fBsyslog\fR،
\fBkmsg\fR
یا
\fBjournal\fR
به همراه یک دونقطه بیاید تا حداکثر سطح لاگ را برای آن مقصد لاگ خاص تعیین کند (برای نمونه
\fBSYSTEMD_LOG_LEVEL=debug,console:info\fR
مشخص می‌کند که لاگ‌گیری در سطح debug باشد، مگر در هنگام لاگ‌گیری روی کنسول که باید در سطح info باشد)\&. توجه داشته باشید که حداکثر سطح لاگ سراسری نسبت به هر سطح لاگِ حداکثرِ تفکیک‌شده بر اساس مقصد، اولویت دارد\&.
.RE
.PP
\fI$SYSTEMD_LOG_COLOR\fR
.RS 4
یک مقدار بولی\&. در صورت true بودن، پیام‌های نوشته‌شده بر روی tty با توجه به اولویت رنگ‌آمیزی می‌شوند\&.
.sp
این تنظیم تنها زمانی مفید است که پیام‌ها مستقیماً در ترمینال نوشته شوند، زیرا
\fBjournalctl\fR(1)
و سایر ابزارهایی که لاگ‌ها را نمایش می‌دهند، خودشان پیام‌ها را بر اساس سطح لاگ رنگ‌آمیزی می‌کنند\&.
.RE
.PP
\fI$SYSTEMD_LOG_TIME\fR
.RS 4
یک مقدار بولی\&. در صورت true بودن، پیام‌های لاگ کنسول با یک برچسب زمانی همراه می‌شوند\&.
.sp
این تنظیم تنها زمانی مفید است که پیام‌ها مستقیماً در ترمینال یا یک فایل نوشته شوند، زیرا
\fBjournalctl\fR(1)
و سایر ابزارهایی که لاگ‌ها را نمایش می‌دهند، خودشان برچسب‌های زمانی را بر اساس فراداده رکوردها اضافه می‌کنند\&.
.RE
.PP
\fI$SYSTEMD_LOG_LOCATION\fR
.RS 4
یک مقدار بولی\&. در صورت true بودن، نام فایل و شماره خط در کد منبع که پیام از آن صادر شده است، به عنوان پیشوند به پیام اضافه می‌شود\&.
.sp
توجه داشته باشید که مکان لاگ در هر حال اغلب به عنوان فراداده به رکوردهای ژورنال متصل می‌شود\&. با این حال، گنجاندن مستقیم آن در متن پیام می‌تواند هنگام اشکال‌زدایی (debugging) برنامه‌ها بسیار کارآمد باشد\&.
.RE
.PP
\fI$SYSTEMD_LOG_TID\fR
.RS 4
یک مقدار بولی\&. در صورت true بودن، شناسه عددی ترد جاری (TID) به عنوان پیشوند به پیام اضافه می‌شود\&.
.sp
توجه داشته باشید که این اطلاعات در هر حال به عنوان فراداده به رکوردهای ژورنال متصل است\&. با این وجود، گنجاندن مستقیم آن در متن پیام می‌تواند هنگام اشکال‌زدایی برنامه‌ها مفید باشد\&.
.RE
.PP
\fI$SYSTEMD_LOG_TARGET\fR
.RS 4
مقصد پیام‌های لاگ\&. یکی از مقادیر زیر:
\fBconsole\fR
(ثبت لاگ در tty متصل)،
\fBconsole\-prefixed\fR
(ثبت در tty متصل اما همراه با پیشوندهایی که سطح لاگ و "facility" را کدگذاری می‌کنند؛
\fBsyslog\fR(3)
را ببینید)،
\fBkmsg\fR
(ثبت در بافر چرخشی لاگ کرنل)،
\fBjournal\fR
(ثبت در ژورنال)،
\fBjournal\-or\-kmsg\fR
(ثبت در ژورنال در صورت در دسترس بودن، و در غیر این صورت در kmsg)،
\fBauto\fR
(تعیین خودکار مقصد لاگ مناسب؛ مقدار پیش‌فرض)،
\fBnull\fR
(غیرفعال کردن خروجی لاگ)\&.
.RE
.PP
\fI$SYSTEMD_LOG_RATELIMIT_KMSG\fR
.RS 4
تعیین اینکه آیا kmsg محدودسازی نرخ (ratelimit) شود یا خیر\&. یک مقدار بولی می‌پذیرد\&. پیش‌فرض
"true"
است\&. در صورت غیرفعال بودن، systemd پیام‌های نوشته‌شده در kmsg را محدودسازی نرخ نخواهد کرد\&.
.RE
.PP
\fI$SYSTEMD_PAGER\fR, \fI$PAGER\fR
.RS 4
پیجری که در صورت عدم ارائه
\fB\-\-no\-pager\fR
استفاده می‌شود\&. در صورت تنظیم بودن
\fI$SYSTEMD_PAGER\fR
از آن استفاده می‌شود؛ در غیر این صورت
\fI$PAGER\fR
به کار می‌رود\&. اگر هیچ‌یک از
\fI$SYSTEMD_PAGER\fR
یا
\fI$PAGER\fR
تنظیم نشده باشند، مجموعه‌ای از پیجرهای شناخته‌شده به نوبت امتحان می‌شوند، از جمله
\fBless\fR(1)
و
\fBmore\fR(1)،
تا زمانی که یکی پیدا شود\&. اگر هیچ پیجری یافت نشود، هیچ پیجری فراخوانی نخواهد شد\&. تنظیم این متغیرهای محیطی روی یک رشته خالی یا مقدار
"cat"
معادل ارسال
\fB\-\-no\-pager\fR
است\&.
.sp
نکته: اگر
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد،
\fI$SYSTEMD_PAGER\fR
و
\fI$PAGER\fR
فقط می‌توانند برای غیرفعال کردن پیجر (با
"cat"
یا
"")
استفاده شوند، و در غیر این صورت نادیده گرفته می‌شوند\&.
.RE
.PP
\fI$SYSTEMD_LESS\fR
.RS 4
بازنویسی گزینه‌های ارسالی به
\fBless\fR
(به‌طور پیش‌فرض
"FRSXMK")\&.
.sp
کاربران ممکن است بخواهند به‌ویژه دو گزینه را تغییر دهند:
.PP
\fBK\fR
.RS 4
این گزینه به پیجر دستور می‌دهد هنگام فشرده شدن
Ctrl+C
بلافاصله خارج شود\&. برای اینکه به
\fBless\fR
اجازه داده شود خودش
Ctrl+C
را مدیریت کند تا به اعلان دستور پیجر بازگردد، این گزینه را لغو کنید\&.
.sp
اگر مقدار
\fI$SYSTEMD_LESS\fR
شامل
"K"
نباشد، و پیجر فراخوانی‌شده
\fBless\fR
باشد، کلیدهای
Ctrl+C
توسط برنامه اجرایی نادیده گرفته می‌شود و باید توسط پیجر مدیریت شود\&.
.RE
.PP
\fBX\fR
.RS 4
این گزینه به پیجر دستور می‌دهد تا رشته‌های مقداردهی اولیه و پایانی termcap را به ترمینال ارسال نکند\&. این گزینه به‌طور پیش‌فرض تنظیم شده است تا اجازه دهد خروجی دستور حتی پس از خروج از پیجر در ترمینال قابل مشاهده باقی بماند\&. با این وجود، این کار مانع از عملکرد برخی قابلیت‌های پیجر می‌شود؛ به‌ویژه خروجی صفحه‌بندی‌شده را نمی‌توان با ماوس اسکرول کرد\&.
.RE
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESS\fR
هیچ تأثیری بر فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.sp
برای مباحث بیشتر،
\fBless\fR(1)
را ببینید\&.
.RE
.PP
\fI$SYSTEMD_LESSCHARSET\fR
.RS 4
بازنویسی مجموعه نویسه‌های (charset) ارسالی به
\fBless\fR
(به‌طور پیش‌فرض
"utf\-8"،
اگر ترمینال فراخواننده سازگار با UTF-8 تشخیص داده شود)\&.
.sp
توجه داشته باشید که تنظیم متغیر محیطی معمولی
\fI$LESSCHARSET\fR
هیچ تأثیری بر فراخوانی‌های
\fBless\fR
توسط ابزارهای systemd ندارد\&.
.RE
.PP
\fI$SYSTEMD_PAGERSECURE\fR
.RS 4
دستورات رایج پیجر مانند
\fBless\fR(1)،
علاوه بر «صفحه‌بندی»، یعنی پیمایش در خروجی، از باز کردن فایل‌ها یا نوشتن درون سایر فایل‌ها و اجرای دستورات دلخواه پوسته (shell) پشتیبانی می‌کنند\&. هنگامی که دستورات با امتیازات و اختیارات بالا فراخوانی می‌شوند، برای نمونه تحت
\fBsudo\fR(8)
یا
\fBpkexec\fR(1)،
پیجر تبدیل به یک مرز امنیتی (security boundary) می‌شود\&. باید دقت شود که تنها برنامه‌هایی با قابلیت‌های اکیداً محدود به عنوان پیجر استفاده شوند، و ویژگی‌های تعاملی ناخواسته مانند باز کردن یا ایجاد فایل‌های جدید یا راه‌اندازی زیرپردازش‌ها مجاز نباشند\&. «حالت امن» (secure mode) برای پیجر ممکن است همان‌طور که در زیر شرح داده شده فعال شود،
\fIاگر پیجر از آن پشتیبانی کند\fR
(بیشتر پیجرها به گونه‌ای نوشته نشده‌اند که این موضوع را در نظر بگیرند)\&. توصیه می‌شود هنگام اجازه دادن به کاربران غیرقابل اعتماد برای اجرای دستورات با اختیارات بالا، یا صریحاً «حالت امن» را فعال کنید یا پیجر را با استفاده از
\fB\-\-no\-pager\fR
یا
\fIPAGER=cat\fR
کاملاً غیرفعال سازید\&.
.sp
این گزینه یک آرگومان بولی می‌پذیرد\&. هنگامی که روی true تنظیم شود، «حالت امن» پیجر فعال می‌گردد\&. در «حالت امن»،
\fBLESSSECURE=1\fR
هنگام فراخوانی پیجر تنظیم خواهد شد، که به پیجر دستور می‌دهد دستوراتی را که فایل‌های جدیدی باز می‌کنند یا می‌سازند یا زیرپردازش‌های جدید راه می‌اندازند غیرفعال کند\&. در حال حاضر فقط
\fBless\fR(1)
شناخته شده است که این متغیر را درک کرده و «حالت امن» را پیاده‌سازی می‌کند\&.
.sp
هنگامی که روی false تنظیم شود، هیچ محدودیتی بر روی پیجر اعمال نمی‌گردد\&. تنظیم
\fISYSTEMD_PAGERSECURE=0\fR
یا حذف نکردن آن از محیط به ارث رسیده ممکن است به کاربر اجازه اجرای دستورات دلخواه را بدهد\&.
.sp
هنگامی که
\fI$SYSTEMD_PAGERSECURE\fR
تنظیم نشده باشد، ابزارهای systemd تلاش می‌کنند به‌طور خودکار تشخیص دهند که آیا «حالت امن» باید فعال شود یا خیر و آیا پیجر از آن پشتیبانی می‌کند یا خیر\&. اگر UID موثر (effective UID) با مالک نشست لاگین یکسان نباشد (به
\fBgeteuid\fR(2)
و
\fBsd_pid_get_owner_uid\fR(3)
مراجعه کنید)، یا هنگام اجرا تحت
\fBsudo\fR(8)
یا ابزارهای مشابه (زمانی که
\fI$SUDO_UID\fR
تنظیم شده باشد
\&\s-2\u[8]\d\s+2)،
«حالت امن» فعال می‌شود\&. در این حالت‌ها،
\fISYSTEMD_PAGERSECURE=1\fR
تنظیم خواهد شد و پیجرهایی که شناخته نشده‌اند «حالت امن» را پیاده‌سازی می‌کنند اصلاً استفاده نخواهند شد\&. توجه داشته باشید که این تشخیص خودکار فقط رایج‌ترین سازوکارهای ارتقای اختیارات را پوشش می‌دهد و برای راحتی کار در نظر گرفته شده است\&. توصیه می‌شود صریحاً
\fI$SYSTEMD_PAGERSECURE\fR
را تنظیم کرده یا پیجر را غیرفعال کنید\&.
.sp
توجه داشته باشید که اگر قرار است متغیرهای
\fI$SYSTEMD_PAGER\fR
یا
\fI$PAGER\fR
رعایت شوند (به جز برای غیرفعال کردن پیجر)، باید
\fI$SYSTEMD_PAGERSECURE\fR
نیز تنظیم شده باشد\&.
.RE
.PP
\fI$SYSTEMD_COLORS\fR
.RS 4
یک آرگومان بولی دریافت می‌کند\&. هنگامی که true باشد،
\fBsystemd\fR
و ابزارهای مربوطه از رنگ‌ها در خروجی خود استفاده خواهند کرد، در غیر این صورت خروجی تک‌رنگ (monochrome) خواهد بود\&. علاوه بر این، متغیر می‌تواند یکی از مقادیر ویژه
"16"
یا
"256"
را بگیرد تا استفاده از رنگ‌ها را به ترتیب به ۱۶ یا ۲۵۶ رنگ پایه ANSI محدود کند\&. این را می‌توان برای لغو تصمیم‌گیری خودکار بر اساس
\fI$TERM\fR
و آنچه کنسول به آن متصل است، مشخص کرد\&.
.RE
.PP
\fI$SYSTEMD_URLIFY\fR
.RS 4
مقدار باید یک مقدار بولی باشد\&. کنترل می‌کند که آیا برای شبیه‌سازهای ترمینالی که از این قابلیت پشتیبانی می‌کنند، پیوندهای قابل کلیک در خروجی ایجاد شوند یا خیر\&. این را می‌توان برای لغو تصمیمی که
\fBsystemd\fR
بر اساس
\fI$TERM\fR
و شرایط دیگر اتخاذ می‌کند، مشخص کرد\&.
.RE
.SH "مثالها (EXAMPLES)"
.PP
بدون هیچ آرگومانی، تمام لاگ‌های جمع‌آوری‌شده به‌صورت فیلترنشده نمایش داده می‌شوند:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl
.fi
.if n \{\
.RE
.\}
.PP
با تعیین یک تطابق، تمام رکوردهای دارای فیلدی منطبق با آن عبارت نمایش داده می‌شوند:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl _SYSTEMD_UNIT=avahi\-daemon\&.service
journalctl _SYSTEMD_CGROUP=/user\&.slice/user\-42\&.slice/session\-c1\&.scope
.fi
.if n \{\
.RE
.\}
.PP
اگر دو فیلد متفاوت مطابقت داده شوند، فقط رکوردهایی نشان داده می‌شوند که هم‌زمان با هر دو عبارت همخوانی داشته باشند:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl _SYSTEMD_UNIT=avahi\-daemon\&.service _PID=28097
.fi
.if n \{\
.RE
.\}
.PP
اگر دو تطابق به فیلد یکسانی اشاره کنند، تمام رکوردهایی که با هر یک از عبارت‌ها همخوانی دارند نمایش داده می‌شوند:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl _SYSTEMD_UNIT=avahi\-daemon\&.service _SYSTEMD_UNIT=dbus\&.service
.fi
.if n \{\
.RE
.\}
.PP
اگر از جداکننده
"+"
استفاده شود، دو عبارت می‌توانند در یک OR منطقی با یکدیگر ترکیب شوند\&. دستور زیر تمام پیام‌های فرایند سرویس Avahi با PID برابر ۲۸۰۹۷ به همراه تمام پیام‌های سرویس D\-Bus (از هر یک از فرایندهای آن) را نشان می‌دهد:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl _SYSTEMD_UNIT=avahi\-daemon\&.service _PID=28097 + _SYSTEMD_UNIT=dbus\&.service
.fi
.if n \{\
.RE
.\}
.PP
برای نمایش تمام فیلدهای صادرشده
\fIتوسط\fR
یک واحد و
\fIدرباره\fR
آن واحد، باید از گزینه
\fB\-u\fR/\fB\-\-unit=\fR
استفاده شود\&. دستور
\fBjournalctl \-u \fR\fB\fIname\fR\fR
به یک فیلتر پیچیده مشابه زیر بسط می‌یابد:
.sp
.if n \{\
.RS 4
.\}
.nf
_SYSTEMD_UNIT=\fIname\fR\&.service
  + UNIT=\fIname\fR\&.service _PID=1
  + OBJECT_SYSTEMD_UNIT=\fIname\fR\&.service _UID=0
  + COREDUMP_UNIT=\fIname\fR\&.service _UID=0 MESSAGE_ID=fc2e22bc6ee647b6b90729ab34a250b1
.fi
.if n \{\
.RE
.\}
.sp
(برای شرح این الگوها،
\fBsystemd.journal-fields\fR(7)
را ببینید)\&.
.PP
نمایش تمام لاگ‌های تولیدشده توسط فایل اجرایی D\-Bus:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl /usr/bin/dbus\-daemon
.fi
.if n \{\
.RE
.\}
.PP
نمایش تمام لاگ‌های هسته (کرنل) از بوت پیشین:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl \-k \-b \-1
.fi
.if n \{\
.RE
.\}
.PP
نمایش زنده لاگ‌ها از سرویس سیستمی
apache\&.service:
.sp
.if n \{\
.RS 4
.\}
.nf
journalctl \-f \-u apache
.fi
.if n \{\
.RE
.\}
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-cat\fR(1), \fBsystemd-journald.service\fR(8), \fBsystemctl\fR(1), \fBcoredumpctl\fR(1), \fBsystemd.journal-fields\fR(7), \fBjournald.conf\fR(5), \fBsystemd.time\fR(7), \fBsystemd-journal-remote.service\fR(8), \fBsystemd-journal-upload.service\fR(8)
.SH "یادداشتها (NOTES)"
.IP " 1." 4
Discoverable Partitions Specification
.RS 4
\%https://uapi-group.org/specifications/specs/discoverable_partitions_specification
.RE
.IP " 2." 4
RFC 3339
.RS 4
\%https://tools.ietf.org/html/rfc3339
.RE
.IP " 3." 4
Journal Export Format
.RS 4
\%https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-export-format
.RE
.IP " 4." 4
Journal JSON Format
.RS 4
\%https://systemd.io/JOURNAL_EXPORT_FORMATS#journal-json-format
.RE
.IP " 5." 4
Server-Sent Events
.RS 4
\%https://developer.mozilla.org/en-US/docs/Server-sent_events/Using_server-sent_events
.RE
.IP " 6." 4
JavaScript Object Notation (JSON) Text Sequences
.RS 4
\%https://tools.ietf.org/html/rfc7464
.RE
.IP " 7." 4
Journal Message Catalogs
.RS 4
\%https://systemd.io/CATALOG
.RE
.IP " 8." 4
توصیه می‌شود سایر ابزارها نیز متغیر
\fI$SUDO_UID\fR
را بر حسب مورد تنظیم و بررسی کرده و با آن به عنوان یک رابط استاندارد مشترک رفتار کنند\&.