.\"
.TH XLOAD 1 2023-02-11 "xload 1.2.2" "X Version 11"
.SH "نام (NAME)"
xload \- نمایشگر میانگین بار سیستم برای سامانه X
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBxload\fP [\fI\-toolkitoption\fP ...] [\fB\-scale\fP \fIinteger\fP] [\fB\-update\fP \fIseconds\fP]
      [\fB\-hl\fP \fIcolor\fP | \fB\-highlight\fP \fIcolor\fP] [\fB\-remote\fP \fIhost\fP]
      [\fB\-jumpscroll\fP \fIpixels\fP] [\fB\-label\fP \fIstring\fP] [\fB\-nolabel\fP] [\fB\-lights\fP]
      [\fB\-help\fP|\fB\-version\fP]
.fi
.SH "توضیحات (DESCRIPTION)"
برنامه
.B xload
یک نمودار ستونی (هیستوگرام) از میانگین بار سیستم را نمایش می‌دهد که به‌صورت دوره‌ای به‌روزرسانی می‌شود.
.SH "گزینه‌ها (OPTIONS)"
برنامه
.B xload
تمام گزینه‌های خط فرمان استاندارد X Toolkit را می‌پذیرد (ببینید
.BR X (7)).
ترتیب گزینه‌ها اهمیتی ندارد.
.B xload
همچنین گزینه‌های زیر را به عنوان گزینه‌های تکمیلی می‌پذیرد:
.TP 8
\fB\-hl\fP \fIcolor\fP یا \fB\-highlight\fP \fIcolor\fP
این گزینه رنگ خطوط مقیاس و درجه‌بندی را مشخص می‌کند.
.TP 8
.B \-jumpscroll \fIpixels\fP
تعداد پیکسل‌هایی که با رسیدن نمودار به لبه راست پنجره، نمودار به سمت چپ رانده (scroll) می‌شود.
مقدار پیش‌فرض نصف عرض پنجره فعلی است.
با قرار دادن این مقدار روی 1، پیمایش نرم حاصل می‌شود.
.TP 8
.B \-label \fIstring\fP
رشته‌ای که باید در برچسب بالای نمودار میانگین بار قرار گیرد.
.TP 8
.B \-nolabel
در صورت تعیین این گزینه خط فرمان، هیچ برچسبی در بالای نمودار بار نمایش داده نخواهد شد.
.TP 8
.B \-lights
در صورت فعال بودن، این گزینه باعث می‌شود
.B xload
میانگین بار فعلی را با استفاده از ال‌ای‌دی‌های صفحه‌کلید نمایش دهد؛
به ازای میانگین بار \fIn\fP، برنامه xload تعداد \fIn\fP ال‌ای‌دی نخست صفحه‌کلید را روشن می‌کند.
این گزینه نمایش گرافیکی معمول روی صفحه را خاموش می‌کند.
.TP 8
.B \-scale \fIinteger\fP
این گزینه حداقل تعداد تقسیمات مدرج در هیستوگرام را مشخص می‌کند،
به‌طوری که هر تقسیم نشان‌دهنده یک واحد میانگین بار است.
اگر بار سیستم از این عدد بیشتر شود، \fBxload\fP تقسیمات بیشتری ایجاد می‌کند،
اما هیچ‌گاه از این عدد کمتر استفاده نخواهد کرد.
مقدار پیش‌فرض 1 است.
.TP 8
.B \-update \fIseconds\fP
این گزینه بازه زمانی بر حسب ثانیه را برای به‌روزرسانی صفحه توسط \fBxload\fP
مشخص می‌کند.
حداقل زمان مجاز بین به‌روزرسانی‌ها 1 ثانیه است.
مقدار پیش‌فرض 10 است.
.TP 8
.B \-remote \fIhost\fP
این گزینه به \fBxload\fP دستور می‌دهد که بار میزبان \fIhost\fP را به جای
\fIlocalhost\fP نمایش دهد.
\fBXload\fP اطلاعات را از پایگاه داده \fBrwhod\fP دریافت می‌کند و بنابراین
مستلزم اجرای \fBrwhod\fP در هر دو مبدأ \fIlocalhost\fP و مقصد \fIhost\fP است.
.TP 8
.B \-help
این گزینه مشخص می‌کند که \fBxload\fP باید پیام راهنمای نحوه استفاده را چاپ کرده و خارج شود.
.TP 8
.B \-version
این گزینه مشخص می‌کند که \fBxload\fP باید اطلاعات نسخه را چاپ کرده و خارج شود.
.SH "منابع (RESOURCES)"
علاوه بر منابع موجود برای تک‌تک ویجت‌های به‌کاررفته توسط
\fBxload\fP، یک منبع نیز توسط خود برنامه تعریف شده است.
.TP 8
.B showLabel (\fPclass \fIBoolean\fB)
اگر False باشد، هیچ برچسبی نمایش داده نخواهد شد.
.SH "ویجت‌ها (WIDGETS)"
برای تعیین منابع، دانستن سلسله‌مراتب ویجت‌هایی که \fBxload\fR را تشکیل می‌دهند مفید است.
در ساختار زیر، تورفتگی نشان‌دهنده ساختار سلسله‌مراتبی است.
ابتدا نام کلاس ویجت و سپس نام نمونه (instance) آن آمده است.
.sp
.nf
XLoad  xload
        Paned  paned
                Label  label
                StripChart  load
.fi
.sp
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای دریافت میزبان پیش‌فرض و شماره صفحه نمایش.
.TP 8
.B XENVIRONMENT
برای دریافت نام فایل منبعی که اولویتی بالاتر از منابع سراسری ذخیره‌شده
در ویژگی RESOURCE_MANAGER دارد.
.SH "فایل‌ها (FILES)"
.TP
.I /usr/share/X11/app-defaults/XLoad
منابع مورد نیاز را مشخص می‌کند.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR xrdb (1),
.BR mem (4),
Athena StripChart Widget.
.SH "گزارش باگ‌ها (BUGS)"
در بسترهای قدیمی‌تر، این برنامه ممکن است به دسترسی باز کردن و خواندن
فایل ویژه سیستمی \fB/dev/kmem\fP نیاز داشته باشد. سیستم‌هایی که دسترسی عمومی
به این فایل را مجاز نمی‌دانند، ممکن است نیاز داشته باشند که \fBxload\fP به همان گروه
\fB/dev/kmem\fP تعلق داشته باشد و پرچم دسترسی \fIset group id\fP برای آن فعال گردد.
.PP
خواندن میانگین بار سیستم ماهیتاً غیرقابل‌حمل (non-portable) است.
بنابراین، روتین مورد استفاده برای خواندن آن (get_load.c)
باید برای هر سیستم‌عامل جدید پورت شود.
.SH "نویسندگان (AUTHORS)"
K. Shane Hartman (MIT-LCS) و Stuart A. Malone (MIT-LCS)؛
.br
با افزودن ویژگی‌ها توسط Jim Gettys (MIT-Athena)، Bob Scheifler (MIT-LCS)،
Tony Della Fera (MIT-Athena) و Chris Peterson (MIT-LCS).