.\" Copyright 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included in
.\" all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
.\" THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
.\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
.\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
.\" SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall not
.\" be used in advertising or otherwise to promote the sale, use or other
.\" dealing in this Software without prior written authorization from the
.\" The Open Group.
.\"
.\"
.TH XCONSOLE 1 2023-02-05 "xconsole 1.1.1" "X Version 11"
.SH "نام (NAME)"
xconsole \- پایش پیام‌های کنسول سیستم با X
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.ta 8n
\fBxconsole\fP [-\fItoolkitoption\fP ...] [\fB-file\fP \fIfile-name\fP]
         [\fB-notify\fP|\fB-nonotify\fP] [\fB-daemon\fP] [\fB-verbose\fP]
         [\fB-exitOnFail\fP] [\fB-stripNonprint\fP] [\fB-saveLines\fP \fIcount\fP]
\fBxconsole -help\fP
\fBxconsole -version\fP
.fi
.SH "توضیحات (DESCRIPTION)"
برنامهٔ
.B xconsole
پیام‌هایی را که معمولاً به /dev/console ارسال می‌شوند نمایش می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
برنامهٔ
.B Xconsole
تمام گزینه‌های خط فرمان استاندارد X Toolkit را به همراه گزینه‌های اضافی فهرست‌شده در زیر می‌پذیرد:
.TP 8
.B \-file \fIfile-name\fP
برای پایش دستگاهی دیگر، از این گزینه برای مشخص کردن نام دستگاه استفاده کنید.
این گزینه روی فایل‌های معمولی کار نمی‌کند، زیرا آن‌ها همیشه آماده خوانده شدن هستند.
.TP 8
.BR \-notify " | " \-nonotify
هنگامی که داده‌های جدیدی از کنسول دریافت می‌شود و گزینهٔ notify فعال باشد،
عبارت \(lq *\(rq به انتهای نام آیکون برنامه اضافه می‌شود تا حتی در صورت کمینه‌شدن (iconified) برنامه نیز قابل تشخیص باشد.
گزینهٔ
.B \-notify
حالت پیش‌فرض است.
.TP 8
.B \-daemon
این گزینه باعث می‌شود
.B xconsole
با استفاده از fork/exit خود را در پس‌زمینه قرار دهد.
.TP 8
.B \-verbose
در صورت تنظیم، این گزینه
.B xconsole
را هدایت می‌کند تا پیامی اطلاع‌رسان را در سطر اول بافر متن نمایش دهد.
.TP 8
.B \-exitOnFail
در صورت تنظیم، این گزینه به
.B xconsole
دستور می‌دهد تا در صورت عدم توانایی در بازهدایت خروجی کنسول، خارج شود.
.TP 8
.B \-stripNonprint
در صورت تنظیم، این گزینه
.B xconsole
را هدایت می‌کند تا هیچ نویسهٔ غیرقابل چاپی بر اساس locale جاری را در خروجی نمایش‌داده‌شده درج نکند.
.TP 8
.B \-saveLines \fIcount\fP
در صورت تنظیم،
.B xconsole
به‌جای افزایش نامحدود اندازهٔ بافر متنی، تنها
.I count
خط از تاریخچهٔ پیام‌ها را نگه می‌دارد
(مقدار صفر برای
.I count
\- که پیش‌فرض است - به این معنی در نظر گرفته می‌شود که هیچ محدودیتی روی تاریخچه اعمال نشود).
.TP 8
.B \-help
این گزینه مشخص می‌کند که \fBxconsole\fP باید پیام راهنمای نحوهٔ استفاده را چاپ کرده و خارج شود.
.TP 8
.B \-version
این گزینه مشخص می‌کند که \fBxconsole\fP باید نسخهٔ خود را چاپ کرده و خارج شود.
.SH "پیش‌فرض‌های X (X DEFAULTS)"
این برنامه از ویجت
.I Athena Text
استفاده می‌کند؛ برای کنترل آن به مستندات
.I Athena Widget Set
مراجعه کنید.
.PP
.B Xconsole
در غیر این صورت منابعی هم‌نام با گزینه‌های خط فرمان
(بدون خط تیرهٔ ابتدایی)
را می‌پذیرد.
\(lqfile\(rq از نوع رشته (string)، \(lqsaveLines\(rq از نوع عدد صحیح (integer)
و گزینه‌های باقی‌مانده از نوع بولی (boolean) هستند.
.SH "ویجت‌ها (WIDGETS)"
به‌منظور مشخص کردن منابع، دانستن سلسله‌مراتب ویجت‌هایی که \fBxconsole\fR را تشکیل می‌دهند مفید است.
در ساختار زیر، تورفتگی نشان‌دهندهٔ ساختار سلسله‌مراتبی است.
ابتدا نام کلاس ویجت آورده شده و به دنبال آن نام نمونهٔ (instance) ویجت می‌آید.
.sp
.nf
XConsole  xconsole
     XConsole  text
.fi
.sp
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای به‌دست آوردن میزبان (host) و شمارهٔ نمایش پیش‌فرض.
.TP 8
.B XENVIRONMENT
برای به‌دست آوردن نام یک فایل منبع که جایگزین منابع سراسری ذخیره‌شده در ویژگی RESOURCE_MANAGER می‌شود.
.SH "فایل‌ها (FILES)"
.TP
.B /usr/share/X11/app-defaults/XConsole
منابع مورد نیاز را مشخص می‌کند
.SH "همچنین ببینید (SEE ALSO)"
.BR xrdb (1),
.BR X (7),
ویجت Athena Text
.SH "نویسندگان (AUTHORS)"
Keith Packard (MIT X Consortium)