'\" t
.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "conky" "1" "2026\-09\-04" ""
.SH "نام (NAME)"
conky \- مانیتور سیستم برای سامانه X
.SH "خلاصه دستور (SYNOPSIS)"
\f[B]conky\f[R] [ \f[I]options\f[R] ]
.SH "توضیحات (DESCRIPTION)"
برنامه Conky یک مانیتور سیستم برای سامانه X است که در ابتدا بر پایه torsmo توسعه یافته بود.
از زمان پیدایش خود، Conky تغییرات قابل‌توجهی نسبت به نسخه پیشین خود داشته، در حالی که سادگی و قابلیت پیکربندی خود را حفظ کرده است.
برنامه Conky می‌تواند تقریباً هر چیزی را چه روی میزکار اصلی (root desktop) و چه در پنجره اختصاصی خود نمایش دهد.
برنامه Conky نه‌تنها دارای اشیاء داخلی فراوانی است، بلکه می‌تواند تقریباً هر نوع اطلاعاتی را با استفاده از اسکریپت‌ها و برنامه‌های خارجی دیگر نیز نمایش دهد.
.PP
برنامه Conky دارای بیش از ۲۵۰ شیء داخلی است، شامل پشتیبانی از انبوهی از آمارهای سیستم‌عامل (تنها به عنوان نمونه: uname، زمان فعالیت یا uptime، مصرف پردازنده، مصرف حافظه، مصرف دیسک، آمار پردازش‌ها مشابه \(dqtop\(dq و پایش شبکه)، پشتیبانی داخلی از پروتکل‌های IMAP و POP3، پشتیبانی داخلی از بسیاری از پخش‌کننده‌های موسیقی محبوب (مانند MPD، XMMS2، Audacious) و موارد بسیار دیگر.
برنامه Conky می‌تواند این اطلاعات را به صورت متن یا با استفاده از نوار پیشرفت‌های ساده و ابزارک‌های نموداری با قلم‌ها و رنگ‌های گوناگون نمایش دهد.
.PP
ما همیشه به دنبال مشارکت و کمک هستیم؛ چه در زمینه گزارش باگ‌ها، چه نگارش وصله‌ها (patches) یا نوشتن مستندات.
لطفاً برای گزارش باگ‌ها، درخواست ویژگی‌های جدید و ارسال وصله‌ها از امکانات گیت‌هاب (GitHub) استفاده کنید.
.PP
از علاقه و توجه شما به Conky سپاسگزاریم.
.SH "کامپایل (COMPILING)"
برای کاربرانی که برنامه را از سورس‌کد روی یک توزیع باینری کامپایل می‌کنند، مطمئن شوید که کتابخانه‌های توسعه X را نصب کرده‌اید (مگر اینکه ساخت خود را بدون X11 پیکربندی کنید).
این بسته معمولاً برای کتابخانه‌های X11 به نام \(dqlibx11\-dev\(dq یا \(dqxorg\-x11\-dev\(dq است، و قالبی مشابه با پسوند \(dq\-dev\(dq برای سایر کتابخانه‌های مورد نیاز دارد (بسته به گزینه‌های ساخت شما).
با بررسی خطاهایی که هنگام اجرای \(gacmake\(aq دریافت می‌کنید، می‌توانید ببینید چه بسته‌های اضافی دیگری را باید نصب کنید.
ساده‌ترین روش برای مشاهده گزینه‌های ساخت موجود، اجرای \(gaccmake\(aq یا \(gacmake\-gui\(aq از درون درخت سورس‌کد است؛ اما هنگام غیرفعال کردن برخی قابلیت‌ها احتیاط کنید، زیرا ممکن است عملکردهای مورد نظر خود را از دست بدهید.
برای نمونه، با غیرفعال بودن BUILD_MATH خطایی دریافت نخواهید کرد، اما نمودارهای لگاریتمی به نمودارهای معمولی تبدیل می‌شوند و درجه‌ها خط شاخص خود را از دست می‌دهند.
.PP
برنامه Conky (مدت‌هاست) در مخازن بیشتر توزیع‌های محبوب در دسترس است.
در اینجا چند دستورالعمل نصب برای برخی توزیع‌ها آمده است:
.PP
کاربران Gentoo \-\- برنامه Conky در سیستم پورتج (Portage) گنتو قرار دارد...
برای نصب کافی است دستور \(dqemerge app\-admin/conky\(dq را اجرا کنید.
.PP
کاربران دبیان و موارد مشابه \-\- برنامه Conky باید در مخازن شما موجود باشد و با اجرای \(dqaptitude install conky\(dq قابل نصب است.
.PP
نمونه‌ای برای کامپایل و اجرای Conky با مؤلفه‌های پیش‌فرض (توجه داشته باشید که برخی از گزینه‌های ساخت ممکن است برای سیستم شما متفاوت باشند):
.TP
\f[B]cmake\f[R] \f[B]\-D CMAKE_INSTALL_PREFIX:string=/usr .\f[R]
.TP
\f[B]make\f[R]
.TP
\f[B]make install\f[R] \f[B]# اختیاری\f[R]
.TP
\f[B]src/conky\f[R]
.PP
سازگاری Conky با استانداردهای C99 C و C++0x C++ آزمایش شده است، با این حال به جز با کامپایلر gcc با مورد دیگری تست نشده و تضمینی برای کارکرد با سایر کامپایلرها وجود ندارد.
.PP
نکته: سعی کنید به جای استفاده صرف از \(gacmake\(aq، برنامه Conky را با \(gaccmake\(aq یا \(gacmake\-gui\(aq پیکربندی نمایید.
.SH "نکات قابل توجه (YOU SHOULD KNOW)"
برنامه Conky عموماً از نظر مصرف منابع بسیار بهینه عمل می‌کند.
با این حال، هرچه وظایف بیشتری بر دوش Conky بگذارید، منابع بیشتری نیز مصرف خواهد کرد.
.PP
یک راه ساده برای اجبار Conky به بارگذاری مجدد فایل
\f[I]\(ti/.config/conky/conky.conf\f[R]:
دستور \(dqkillall \-SIGUSR1 conky\(dq است.
این کار شما را از زحمت متوقف کردن و اجرای مجدد برنامه بی‌نیاز می‌کند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان بر تنظیمات مشخص‌شده در فایل پیکربندی اولویت دارند و آن‌ها را بازنویسی می‌کنند.
.TP
\f[B]\-a | \-\-alignment=\f[R] \f[B]ALIGNMENT\f[R]
تراز متن روی صفحه، {top,bottom,middle}_{left,right,middle} یا none.
همچنین می‌تواند با حروف ابتدایی موقعیت به صورت مخفف مشخص شود، مثلاً tr برای top_right.
تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
.TP
\f[B]\-b | \-\-double\-buffer\f[R]
استفاده از بافر دوگانه (double buffering) برای حذف پرش و چشمک‌زدن تصویر (\(dqflicker\(dq).
تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
.TP
\f[B]\-c | \-\-config=\f[R] \f[B]FILE\f[R]
فایل پیکربندی که باید به جای \f[I]\(ti/.config/conky/conky.conf\f[R] بارگذاری شود.
.TP
\f[B]\-C | \-\-print\-config\f[R]
چاپ پیکربندی پیش‌فرض داخلی در خروجی استاندارد (stdout).
برای اطلاعات بیشتر، بخش EXAMPLES (مثال‌ها) را نیز ببینید.
تنها با فعال بودن فلگ ساخت BUILD_BUILTIN_CONFIG در دسترس است.
.TP
\f[B]\-d | \-\-daemonize\f[R]
تبدیل Conky به دیمن (انشعاب به پس‌زمینه).
.TP
\f[B]\-D | \-\-debug\f[R]
افزایش خروجی اشکال‌زدایی؛ برای نمونه \-DD برای اشکال‌زدایی بیشتر.
.TP
\f[B]\-f | \-\-font=\f[R] \f[B]FONT\f[R]
قلم مورد استفاده.
تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
.TP
\f[B]\-h | \-\-help\f[R]
راهنمای خط فرمان را چاپ می‌کند و خارج می‌شود.
.TP
\f[B]\-i\f[R] \f[B]COUNT\f[R]
تعداد دفعات به‌روزرسانی Conky (و سپس خروج از برنامه).
.TP
\f[B]\-o | \-\-own\-window\f[R]
ایجاد یک پنجره اختصاصی برای رسم و نمایش.
تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
.TP
\f[B]\-p | \-\-pause=\f[R] \f[B]SECONDS\f[R]
مدت زمان مکث/انتظار (به ثانیه) پیش از شروع به کار واقعی Conky.
.TP
\f[B]\-q | \-\-quiet\f[R]
اجرای Conky در «حالت بی‌صدا» (\(aqquiet mode\(aq؛ به معنی عدم نمایش خروجی).
.TP
\f[B]\-t | \-\-text=\f[R] \f[B]TEXT\f[R]
متن برای رندر شدن؛ به خاطر داشته باشید که باید از نقل‌قول تکی (کوتاسیون) استفاده کنید، مانند \-t \(aq $uptime \(aq.
.TP
\f[B]\-u | \-\-interval=\f[R] \f[B]SECONDS\f[R]
فاصله زمانی به‌روزرسانی (به ثانیه).
.TP
\f[B]\-U | \-\-unique\f[R]
اگر فرآیند دیگری از Conky از قبل در حال اجرا باشد، Conky شروع نخواهد شد.
فقط برای Linux، FreeBSD، NetBSD، OpenBSD و Haiku پیاده‌سازی شده است.
.TP
\f[B]\-v | \-V | \-\-version\f[R]
اطلاعات نسخه، اطلاعات ساخت و اطلاعات عمومی را چاپ می‌کند.
پس از چاپ خارج می‌شود.
.TP
\f[B]\-w | \-\-window\-id=\f[R] \f[B]WIN_ID\f[R]
شناسه پنجره (Window id) برای رسم روی آن.
تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
.TP
\f[B]\-x\f[R] \f[B]X_COORDINATE\f[R]
موقعیت افقی (مختصات X).
.TP
\f[B]\-X | \-\-display=\f[R] \f[B]DISPLAY\f[R]
نمایشگر X11 مورد استفاده.
تنها با فعال بودن فلگ ساخت BUILD_X11 در دسترس است.
.TP
\f[B]\-y\f[R] \f[B]Y_COORDINATE\f[R]
موقعیت عمودی (مختصات Y).
.SH "تنظیمات پیکربندی (CONFIGURATION SETTINGS)"
این فهرست گزینه‌های پیکربندی سراسری Conky است.
این گزینه‌ها در بخش \f[CR]conky.config\f[R] فایل پیکربندی شما، پیش از \f[CR]conky.text\f[R] قرار می‌گیرند.
.PP
محل پیش‌فرض فایل پیکربندی
\f[CR]\(ti/.config/conky/conky.conf\f[R] یا
\f[CR]${sysconfdir}/conky/conky.conf\f[R] است.
در اکثر سیستم‌ها، \f[CR]$sysconfdir\f[R] برابر با \f[CR]/etc\f[R] است، و می‌توانید نمونه فایل پیکربندی را در \f[CR]/etc/conky/conky.conf\f[R] پیدا کنید.
.PP
شاید مایل باشید فایل پیکربندی پیش‌فرض را به
\f[CR]\(ti/.config/conky/conky.conf\f[R] رونوشت کرده و آن را در آنجا ویرایش کنید.
پیکربندی‌های ارائه‌شده توسط کاربران را می‌توانید در نشانی زیر بیابید:
https://github.com/brndnmtthws/conky/wiki/Configs
.PP
آرگومان‌های اختیاری معمولاً با پرانتز مشخص می‌شوند، برای نمونه
\f[CR](optional)\f[R].
.TP
\f[B]alignment\f[R]
تراز روی صفحه.
می‌تواند \f[CR]none\f[R] یا یکی از موارد زیر باشد:
.RS
.PP
.TS
tab(@);
lw(22.4n) cw(24.3n) rw(23.3n).
T{
\f[CR]top_left\f[R] (یا \f[CR]tl\f[R])
T}@T{
\f[CR]top_middle\f[R] (یا \f[CR]tm\f[R])
T}@T{
\f[CR]top_right\f[R] (یا \f[CR]tr\f[R])
T}
T{
\f[CR]middle_left\f[R] (یا \f[CR]ml\f[R])
T}@T{
\f[CR]middle_middle\f[R] (یا \f[CR]mm\f[R])
T}@T{
\f[CR]middle_right\f[R] (یا \f[CR]mr\f[R])
T}
T{
\f[CR]bottom_left\f[R] (یا \f[CR]bl\f[R])
T}@T{
\f[CR]bottom_middle\f[R] (یا \f[CR]bm\f[R])
T}@T{
\f[CR]bottom_right\f[R] (یا \f[CR]br\f[R])
T}
.TE
.PP
برای پنجره‌های \f[CR]panel\f[R] و \f[CR]dock\f[R]، ممکن است استفاده از یکی از نام‌های مستعار زیر مفیدتر باشد:
.PP
.TS
tab(@);
c c.
T{
Alias
T}@T{
Value
T}
_
T{
\f[CR]top\f[R]
T}@T{
\f[CR]top_middle\f[R]
T}
T{
\f[CR]left\f[R]
T}@T{
\f[CR]middle_left\f[R]
T}
T{
\f[CR]right\f[R]
T}@T{
\f[CR]middle_right\f[R]
T}
T{
\f[CR]bottom\f[R]
T}@T{
\f[CR]bottom_middle\f[R]
T}
T{
\f[CR]center\f[R]
T}@T{
\f[CR]middle_middle\f[R]
T}
.TE
.PP
همچنین تنظیمات \f[CR]gap_x\f[R] و \f[CR]gap_y\f[R] را ببینید.
.RE
.TP
\f[B]append_file\f[R]
پیوست کردن فایلی که به عنوان آرگومان داده شده است.
.TP
\f[B]background\f[R]
مقدار بولی (Boolean).
اگر true باشد، Conky هنگام شروع به کار در پس‌زمینه منشعب (fork) می‌شود.
.TP
\f[B]border_inner_margin\f[R]
حاشیه درونی کادر به پیکسل (فاصله بین کادر و متن).
.TP
\f[B]border_outer_margin\f[R]
حاشیه بیرونی کادر به پیکسل (فاصله بین کادر و لبه پنجره).
.TP
\f[B]border_width\f[R]
عرض کادر به پیکسل.
.TP
\f[B]colorN\f[R]
تعریف اولیه یک رنگ برای استفاده در بخش‌های \f[CR]conky.text\f[R].
به جای \f[CR]N\f[R] رقمی بین 0 تا 9 (شامل خود آن‌ها) قرار دهید.
هنگام مشخص کردن مقدار رنگ در مبنای شانزده (hex)، علامت \f[CR]#\f[R] ابتدای آن را حذف کنید.
.TP
\f[B]console_bar_fill\f[R]
نویسه‌ای برای پر کردن نوارهای کنسول.
.RS
.PP
پیش‌فرض: #
.RE
.TP
\f[B]console_bar_unfill\f[R]
نویسه‌ای برای بخش خالی نوارهای کنسول.
.RS
.PP
پیش‌فرض: .
.RE
.TP
\f[B]console_graph_ticks\f[R]
فهرستی از رشته‌ها (جداشده با کاما) برای استفاده به عنوان میله‌های نموداری که در کنسول یا شل رندر می‌شود.
نخستین مورد فهرست برای حداقل ارتفاع میله و آخرین مورد برای حداکثر ارتفاع استفاده می‌شود، به عنوان مثال \f[CR]\(dq,_,=,#\(dq\f[R].
.TP
\f[B]cpu_avg_samples\f[R]
تعداد نمونه‌ها برای میانگین‌گیری در پایش پردازنده (CPU).
.TP
\f[B]default_bar_height\f[R]
تعیین ارتفاع پیش‌فرض برای نوارها.
.RS
.PP
پیش‌فرض: 6
.RE
.TP
\f[B]default_bar_width\f[R]
تعیین عرض پیش‌فرض برای نوارها.
در صورت عدم تعیین، مقدار پیش‌فرض 0 است که باعث می‌شود نوار به اندازه عرض پنجره Conky گسترش یابد.
اگر out_to_console = true تنظیم شود، مقدار پیش‌فرض برای نسخه متنی نوار برابر با 10 خواهد بود.
.TP
\f[B]default_color\f[R]
رنگ پیش‌فرض متن و کادر.
.TP
\f[B]default_gauge_height\f[R]
تعیین ارتفاع پیش‌فرض برای درجه‌ها (gauges).
.RS
.PP
پیش‌فرض: 25
.RE
.TP
\f[B]default_gauge_width\f[R]
تعیین عرض پیش‌فرض برای درجه‌ها (gauges).
.RS
.PP
پیش‌فرض: 40
.RE
.TP
\f[B]default_graph_height\f[R]
تعیین ارتفاع پیش‌فرض برای نمودارها.
.RS
.PP
پیش‌فرض: 25
.RE
.TP
\f[B]default_graph_width\f[R]
تعیین عرض پیش‌فرض برای نمودارها.
در صورت عدم تعیین، مقدار پیش‌فرض 0 است که باعث می‌شود نمودار به اندازه عرض پنجره Conky گسترش یابد.
اگر out_to_console = true تنظیم شود، نسخه متنی نمودار عملاً هیچ عرضی نخواهد داشت و لازم است یک مقدار پیش‌فرض مناسب تعیین کنید یا ارتفاع و عرض هر نمودار را به صورت جداگانه تنظیم نمایید.
.TP
\f[B]default_outline_color\f[R]
رنگ خط دور (outline) پیش‌فرض.
.TP
\f[B]default_shade_color\f[R]
رنگ سایه پیش‌فرض و رنگ سایه کادر.
.TP
\f[B]detect_battery\f[R]
یک یا چند باتری برای بررسی جهت استفاده از update_interval_on_battery (جداشده با کاما).
.RS
.PP
پیش‌فرض: BAT0
.RE
.TP
\f[B]disable_auto_reload\f[R]
فعال‌سازی این گزینه قابلیت بارگذاری خودکار پیکربندی مبتنی بر inotify را غیرفعال می‌کند.
.TP
\f[B]diskio_avg_samples\f[R]
تعداد نمونه‌ها برای میانگین‌گیری در پایش ورودی/خروجی (I/O) دیسک.
.TP
\f[B]display\f[R]
مشخص کردن نمایشگر X برای اتصال به آن.
.TP
\f[B]double_buffer\f[R]
استفاده از افزونه Xdbe؟
(حذف چشمک‌زدن تصویر) به شدت توصیه می‌شود همراه با این گزینه از پنجره اختصاصی (own window) استفاده کنید تا بافر دوگانه بیش از حد بزرگ نشود.
.TP
\f[B]draw_blended\f[R]
بولی؛ آیا هنگام رندر تصویر رسم‌شده ترکیب رنگ (blend) انجام شود؟
برخی تصاویر به نادرستی ترکیب می‌شوند و کانال آلفا را در حالت‌های بصری ARGB خراب می‌کنند.
این گزینه با غیرفعال کردن ترکیب، یک راهکار جایگزین ممکن ارائه می‌دهد.
.RS
.PP
پیش‌فرض: True
.RE
.TP
\f[B]draw_borders\f[R]
رسم کادر در اطراف متن.
.TP
\f[B]draw_graph_borders\f[R]
رسم کادر در اطراف نمودارها.
.TP
\f[B]draw_outline\f[R]
رسم خطوط دور (outlines).
.TP
\f[B]draw_shades\f[R]
رسم سایه‌ها.
.TP
\f[B]extra_newline\f[R]
قرار دادن یک خط جدید اضافی در انتها هنگام نوشتن در خروجی استاندارد؛ برای نوشتن در wiboxهای مدیر پنجره awesome مفید است.
.TP
\f[B]font\f[R]
نام قلم در سامانه X؛ می‌توان از ابزار xfontsel برای انتخاب یک قلم مناسب استفاده کرد.
.TP
\f[B]fontN\f[R]
پیش‌تعریف قلمی که در بخش‌های conky.text استفاده می‌شود.
مقدار N را با عددی بین 0 تا 9 (شامل هر دو) جایگزین کنید.
از همان قالبی که برای متغیر font به کار می‌رود استفاده نمایید.
.TP
\f[B]forced_redraw\f[R]
مقدار بولی؛ در صورت تنظیم روی true، هنگام تعویض فضای کاری (میزکار)، Conky همه چیز را از نو بازطراحی می‌کند.
این امر ممکن است در برخی از مدیرهای پنجره باعث تاخیر یا پرش تصویر شود.
.TP
\f[B]format_human_readable\f[R]
در صورت فعال بودن، مقادیری که بر حسب بایت هستند در قالبی خوانا برای انسان نمایش داده می‌شوند (مانند KiB، MiB و غیره).
در صورت غیرفعال بودن، به جای آن تعداد بایت‌ها چاپ می‌شود.
.TP
\f[B]gap_x\f[R]
فاصله (بر حسب پیکسل) بین حاشیه راست یا چپ صفحه نمایش؛ معادل ارسال
\-x
در خط فرمان، مانند
\f[CR]gap_x 10\f[R].
برای سایر موارد مرتبط با موقعیت، به
\f[CR]alignment\f[R]
مراجعه کنید.
.TP
\f[B]gap_y\f[R]
فاصله (بر حسب پیکسل) بین حاشیه بالا یا پایین صفحه نمایش؛ معادل ارسال
\-y
در خط فرمان، مانند
\f[CR]gap_y 10\f[R].
برای سایر موارد مرتبط با موقعیت، به
\f[CR]alignment\f[R]
مراجعه کنید.
.TP
\f[B]github_token\f[R]
مشخص کردن توکن API برای اعلان‌های گیت‌هاب (GitHub).
.RS
.PP
یک توکن API در نشانی زیر ایجاد کنید:
https://github.com/settings/tokens/new?scopes=notifications&description=conky
.RE
.TP
\f[B]graph_gradient_mode\f[R] \f[B](rgb|hcl|hsv)\f[R]
فضای رنگی مورد استفاده برای درون‌یابی را تغییر می‌دهد.
آرگومان‌ها شامل hcl، hsv و rgb (پیش‌فرض) هستند.
.RS
.PP
پیش‌فرض: rgb
.RE
.TP
\f[B]hddtemp_host\f[R]
نام میزبان برای اتصال به اشیاء hddtemp.
.RS
.PP
پیش‌فرض: 127.0.0.1
.RE
.TP
\f[B]hddtemp_port\f[R]
پورت مورد استفاده برای اتصالات hddtemp.
.RS
.PP
پیش‌فرض: 7634
.RE
.TP
\f[B]http_port\f[R]
پورت شنود برای اتصالات HTTP.
مقدار پیش‌فرض 10080 است، اما توسط Firefox و Chrome مسدود شده است، بنابراین بهتر است حتماً آن را تغییر دهید.
.RS
.PP
پیش‌فرض: 10080
.RE
.TP
\f[B]http_refresh\f[R]
هنگامی که این گزینه تنظیم شود، صفحه تولید شده با out_to_http به طور خودکار در هر بازه زمانی تازه‌سازی خواهد شد.
.TP
\f[B]if_up_strictness\f[R]
میزان سخت‌گیری if_up هنگام بررسی فعال بودن یک رابط شبکه چقدر باشد؟
مقدار می‌تواند یکی از گزینه‌های
\f[CR]up\f[R]
(پیش‌فرض)،
\f[CR]link\f[R]
یا
\f[CR]address\f[R]
باشد؛ برای بررسی این‌که رابط شبکه صرفاً بالا (up) است، بالا بوده و پیوند (link) برقرار است، یا بالا بوده، پیوند دارد و یک آدرس IP به آن تخصیص یافته است.
.RS
.PP
پیش‌فرض: up
.RE
.TP
\f[B]imap\f[R] \f[B]host user pass [`\-i interval (in seconds)'] [\(lq\-f `folder'\(rq] [`\-p port'] [\(lq\-e `command'\(rq] [`\-r retries']\f[R]
سرور پیش‌فرض سراسری IMAP.
پورت پیش‌فرض 143، پوشه پیش‌فرض `INBOX`، بازه زمانی پیش‌فرض 5 دقیقه، و تعداد تلاش مجدد پیش‌فرض قبل از انصراف 5 است.
اگر گذرواژه به صورت \(cq*\(cq وارد شود، هنگام شروع Conky از شما خواسته می‌شود گذرواژه را وارد نمایید.
.TP
\f[B]imlib_cache_flush_interval\f[R]
بازه زمانی (بر حسب ثانیه) برای تخلیه حافظه موقت (کش) Imlib2.
.TP
\f[B]imlib_cache_size\f[R]
اندازه حافظه موقت (کش) تصویر Imlib2 بر حسب بایت.
اگر از متغیر $image زیاد استفاده می‌کنید، این مقدار را افزایش دهید.
برای غیرفعال کردن کش تصویر، مقدار را روی 0 قرار دهید.
.RS
.PP
پیش‌فرض: 4194304
.RE
.TP
\f[B]lowercase\f[R]
مقدار بولی؛ در صورت تنظیم روی true، متن با حروف کوچک نمایش داده می‌شود.
.TP
\f[B]lua_draw_hook_post\f[R] \f[B]function_name [`function arguments']\f[R]
این تابع، در صورت تعریف، در هر تکرار پس از رسم روی پنجره توسط Conky فراخوانی خواهد شد.
به خروجی گرافیکی (X11 یا Wayland) نیاز دارد.
هر تعداد آرگومان اختیاری را می‌پذیرد.
از این قلاب برای رسم موارد روی چیزهایی که Conky رسم می‌کند استفاده کنید.
برنامه Conky پیشوند `conky_` را در ابتدای function_name قرار می‌دهد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود، مگر اینکه خودتان `conky_` را در ابتدای آن قرار داده باشید.
برای به دست آوردن سطح رسم جاری، از
\f[CR]conky_surface()\f[R]
درون این قلاب استفاده کنید.
.TP
\f[B]lua_draw_hook_pre\f[R] \f[B]function_name [`function arguments']\f[R]
این تابع، در صورت تعریف، در هر تکرار پیش از رسم روی پنجره توسط Conky فراخوانی خواهد شد.
به خروجی گرافیکی (X11 یا Wayland) نیاز دارد.
هر تعداد آرگومان اختیاری را می‌پذیرد.
از این قلاب برای رسم موارد روی چیزهایی که Conky رسم می‌کند استفاده کنید.
برنامه Conky پیشوند `conky_` را در ابتدای function_name قرار می‌دهد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود، مگر اینکه خودتان `conky_` را در ابتدای آن قرار داده باشید.
برای به دست آوردن سطح رسم جاری، از
\f[CR]conky_surface()\f[R]
درون این قلاب استفاده کنید.
.TP
\f[B]lua_load\f[R]
فهرستی از مسیرهای اسکریپت Lua که در زمان راه‌اندازی بارگذاری می‌شوند تا توابع Lua را برای سایر قلاب‌ها فراهم کنند.
فایل‌های فهرست‌شده قبل از `lua_startup_hook` بارگذاری (اجرا) می‌شوند و می‌توانند (اگرچه نباید) کدهایی را در دامنه سراسری (global scope) اجرا کنند.
.RS
.PP
مسیرها با `;` (نقطه‌ویرگول) از هم جدا می‌شوند و می‌توانند به صورت نسبی به مسیر فایل پیکربندی یا مطلق باشند.
.PP
مسیرها پیش‌تر با \(cq \(cq (فاصله) جدا می‌شدند؛ این عملکرد در صورتی که `;` پیدا نشود هنوز پشتیبانی می‌شود، اما منسوخ شده است و در نسخه‌های بعدی حذف خواهد شد.
مسیرهای خالی نادیده گرفته می‌شوند، بنابراین `./example file.lua;` معتبر است.
.RE
.TP
\f[B]lua_mouse_hook\f[R] \f[B]function_name\f[R]
این تابع، در صورت تعریف، با دریافت رویدادهای ماوس از X یا Wayland توسط Conky فراخوانی خواهد شد.
جدولی حاوی اطلاعات رویداد به عنوان آرگومان اول به این تابع ارسال می‌شود.
از این قلاب برای تشخیص ورودی ماوس و پاسخ به آن استفاده نمایید.
برنامه Conky نیازمند آن است که در تعریف تابع پیشوند `conky_` وجود داشته باشد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود.
.TP
\f[B]lua_shutdown_hook\f[R] \f[B]function_name [`function arguments']\f[R]
این تابع، در صورت تعریف، هنگام خاموش شدن Conky یا هنگام بارگذاری مجدد پیکربندی فراخوانی خواهد شد.
از این قلاب برای پاکسازی منابع استفاده کنید، مانند آزادسازی حافظه‌ای که توسط کتابخانه‌های خارجی از طریق Lua تخصیص داده شده است.
برنامه Conky پیشوند `conky_` را در ابتدای function_name قرار می‌دهد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود، مگر اینکه خودتان `conky_` را در ابتدای آن قرار داده باشید.
.TP
\f[B]lua_startup_hook\f[R] \f[B]function_name [`function arguments']\f[R]
این تابع، در صورت تعریف، در زمان راه‌اندازی Conky یا هنگام بارگذاری مجدد پیکربندی فراخوانی خواهد شد.
از این قلاب برای مقداردهی اولیه مقادیر یا برای هر برنامه‌ای که فقط یک‌بار باید اجرا شود استفاده کنید.
برنامه Conky پیشوند `conky_` را در ابتدای function_name قرار می‌دهد تا از فراخوانی تصادفی تابع اشتباه جلوگیری شود، مگر اینکه خودتان `conky_` را در ابتدای آن قرار داده باشید.
.TP
\f[B]mail_spool\f[R]
اسپول ایمیل (Mail spool) برای بررسی ایمیل‌ها.
.TP
\f[B]max_port_monitor_connections\f[R]
به هر ناظر پورت اجازه می‌دهد حداکثر این تعداد اتصال را ردیابی کند.
.RS
.PP
پیش‌فرض: 256
.RE
.TP
\f[B]max_text_width\f[R] \f[B]integer_number\f[R]
هنگامی که یک خط در خروجی شامل `width` کاراکتر باشد و هنوز به انتها نرسیده باشد، کاراکتر بعدی در یک خط جدید آغاز خواهد شد.
اگر می‌خواهید مطمئن شوید که خطوط شکسته نمی‌شوند، `width` را روی 0 تنظیم کنید.
.TP
\f[B]max_user_text\f[R] \f[B]integer_number\f[R]
حداکثر اندازه بافر متن کاربر بر حسب بایت، یعنی متن درون بخش conky.text در فایل پیکربندی.
.RS
.PP
پیش‌فرض: 16384
.RE
.TP
\f[B]maximum_width\f[R] \f[B]integer_number\f[R]
حداکثر عرض پنجره.
.TP
\f[B]minimum_height\f[R] \f[B]integer_number\f[R]
حداقل ارتفاع پنجره.
.TP
\f[B]minimum_width\f[R] \f[B]integer_number\f[R]
حداقل عرض پنجره.
.TP
\f[B]mpd_host\f[R]
میزبان سرور MPD.
.TP
\f[B]mpd_password\f[R]
گذرواژه سرور MPD.
.TP
\f[B]mpd_port\f[R]
پورت سرور MPD.
.TP
\f[B]music_player_interval\f[R]
بازه زمانی به‌روزرسانی رشته (thread) پخش‌کننده موسیقی.
.RS
.PP
پیش‌فرض: update interval
.RE
.TP
\f[B]mysql_db\f[R]
پایگاه‌داده MySQL برای استفاده.
.RS
.PP
پیش‌فرض: mysql
.RE
.TP
\f[B]mysql_host\f[R]
میزبان سرور MySQL.
.RS
.PP
پیش‌فرض: localhost
.RE
.TP
\f[B]mysql_password\f[R]
گذرواژه کاربر MySQL.
آن را بین کاراکترهای \(dq قرار دهید.
در صورتی که تنظیم نشود، هیچ گذرواژه‌ای استفاده نخواهد شد.
.TP
\f[B]mysql_port\f[R]
پورت سرور MySQL.
.TP
\f[B]mysql_user\f[R]
نام کاربری MySQL برای استفاده هنگام اتصال به سرور.
به طور پیش‌فرض نام کاربری شما خواهد بود.
.TP
\f[B]net_avg_samples\f[R]
تعداد نمونه‌ها برای میانگین‌گیری داده‌های شبکه.
.TP
\f[B]no_buffers\f[R]
کسر بافرهای (سیستم‌فایل) از حافظه مصرفی.
.TP
\f[B]nvidia_display\f[R]
نمایشگری که متغیر nvidia از آن استفاده خواهد کرد.
.RS
.PP
پیش‌فرض: $DISPLAY
.RE
.TP
\f[B]out_to_console\f[R]
چاپ متن در خروجی استاندارد (stdout).
.TP
\f[B]out_to_http\f[R]
به conky اجازه می‌دهد به عنوان یک سرور کوچک http عمل کرده و متن خود را ارائه دهد.
.TP
\f[B]out_to_ncurses\f[R]
چاپ متن در کنسول، اما با استفاده از ncurses تا conky بتواند متن به‌روزرسانی جدید را روی متن قبلی چاپ کند.
(در آینده قابلیت‌های مفیدتری را فراهم خواهد کرد).
.TP
\f[B]out_to_stderr\f[R]
چاپ متن در خطای استاندارد (stderr).
.TP
\f[B]out_to_wayland\f[R]
باز کردن یک پنجره Wayland برای نمایش خروجی.
.TP
\f[B]out_to_x\f[R]
هنگامی که روی no تنظیم شود، هیچ خروجی‌ای در سامانه پنجره X وجود نخواهد داشت (هنگامی مفید است که از مواردی مانند out_to_console نیز استفاده می‌کنید).
اگر آن را روی no تنظیم می‌کنید، مطمئن شوید که پیش از تمام تنظیمات مرتبط با X قرار گرفته باشد (برای اطمینان، آن را در اولین خط فایل پیکربندی خود قرار دهید).
.RS
.PP
پیش‌فرض: True
.RE
.TP
\f[B]override_utf8_locale\f[R]
اجبار به استفاده از UTF8.
به XFT نیاز دارد.
.TP
\f[B]overwrite_file\f[R]
بازنویسی فایلی که به عنوان آرگومان داده شده است.
.TP
\f[B]own_window\f[R]
مقدار بولی؛ رسم conky در پنجره اختصاصی خود به جای رسم روی پنجره ریشه (root window).
.TP
\f[B]own_window_class\f[R]
تنظیم دستی نام WM_CLASS.
.RS
.PP
پیش‌فرض: Conky
.RE
.TP
\f[B]own_window_colour\f[R] \f[B]color\f[R]
تنظیم رنگ پس‌زمینه پنجره.
یک مقدار هگزادسیمال همراه با آلفای اختیاری می‌پذیرد (مانند
\f[CR]\(aq#fff\(aq\f[R]،
\f[CR]\(aq#8000\(aq\f[R]،
\f[CR]\(aq#8fff\(aq\f[R])،
یا یک نام معتبر RGB (مشاهده کنید:
\f[CR]/usr/lib/X11/rgb.txt\f[R]).
.RS
.PP
کانال آلفا میزان کدر بودن پس‌زمینه را کنترل می‌کند.
به عنوان مثال،
\f[CR]\(aq#0000\(aq\f[R]
کاملاً شفاف و
\f[CR]\(aq#f000\(aq\f[R]
سیاه کاملاً کدر است.
پس‌زمینه‌های نیمه‌شفاف در X11 به یک کامپوزیتور نیاز دارند.
.PP
پیش‌فرض: black
.RE
.TP
\f[B]own_window_hints\f[R] \f[B]hint(,hint)\f[R]*
اگر
\f[CR]own_window\f[R]
تنظیم شده باشد، در X11 می‌توانید راهنماهای مدیر پنجره (hints) را که با کاما از هم جدا شده‌اند مشخص کنید تا بر نحوه نمایش Conky تأثیر بگذارند.
.RS
موارد زیر برخی از نشانه‌های استاندارد مشخصات مدیر پنجره هستند:
.IP \(bu 2
\f[CR]above\f[R]
نشان می‌دهد که conky باید بالاتر از اکثر پنجره‌ها قرار گیرد.
.IP \(bu 2
\f[CR]below\f[R]
نشان می‌دهد که conky باید پایین‌تر از اکثر پنجره‌ها قرار گیرد.
.IP \(bu 2
\f[CR]skip_pager\f[R]
نشان می‌دهد که conky نباید در پیجر (Pager) گنجانده شود.
\f[B]به طور ضمنی اعمال می‌شود اگر\f[R]
\f[CR]own_window_type\f[R]
برابر `dock` یا `panel` باشد.
.IP \(bu 2
\f[CR]skip_taskbar\f[R]
نشان می‌دهد که conky نباید در نوار وظیفه (taskbar) گنجانده شود.
\f[B]به طور ضمنی اعمال می‌شود اگر\f[R]
\f[CR]own_window_type\f[R]
برابر `dock` یا `panel` باشد.
.IP \(bu 2
\f[CR]sticky\f[R]
نشان می‌دهد که مدیر پنجره باید موقعیت conky را بر روی صفحه نمایش ثابت نگه دارد، حتی زمانی که دسکتاپ مجازی پیمایش می‌شود.
.IP \(bu 2
\f[CR]undecorated\f[R]
نشان می‌دهد که conky نباید هیچ تزیینات پنجره‌ای (مانند نوار عنوان) داشته باشد.
\f[B]به طور ضمنی اعمال می‌شود اگر\f[R]
\f[CR]own_window_type\f[R]
برابر `dock` یا `panel` باشد.
نکات:
.IP \(bu 2
از تنظیم
\f[CR]own_window_type=\(aqdesktop\(aq\f[R]
به عنوان روشی دیگر برای اعمال ضمنی بسیاری از این راهنماها استفاده کنید.
.IP \(bu 2
اگر از
\f[CR]own_window_type=\(aqoverride\(aq\f[R]
استفاده کنید، راهنماهای مدیر پنجره هیچ معنایی نخواهند داشت و نادیده گرفته می‌شوند.
.RE
.TP
\f[B]own_window_title\f[R]
امکان تغییر و بازنویسی نام پنجره conky را فراهم می‌کند.
.RS
.PP
پیش‌فرض: conky ()
.RE
.TP
\f[B]own_window_type\f[R] \f[B](normal|desktop|dock|panel|utility|override)\f[R]
نوع پنجره‌ای را که conky به صورت آن نمایش داده می‌شود مشخص می‌کند.
در X11 این مورد نیازمند تنظیم
\f[CR]own_window\f[R]
است؛ در Wayland لایه wlr\-layer\-shell را که سطح روی آن سوار می‌شود انتخاب می‌کند (و برای
\f[CR]dock\f[R]/\f[CR]panel\f[R]،
اینکه آیا فضای صفحه نمایش را از طریق یک ناحیه انحصاری رزرو کند یا خیر).
انواع موجود:
.RS
.IP \(bu 2
حالت
\f[CR]normal\f[R]
باعث می‌شود conky به عنوان یک پنجره معمولی نمایش داده شود.
این حالت می‌تواند با استفاده از تنظیم
\f[CR]own_window_hints\f[R]
پیکربندی شود.
.IP \(bu 2
پنجره‌های
\f[CR]desktop\f[R]
پنجره‌های ویژه‌ای هستند که هیچ تزیینات پنجره‌ای ندارند، همیشه روی میزکار قابل مشاهده هستند، در پیجر یا نوار وظیفه ظاهر نمی‌شوند و در تمام فضاهای کاری چسبنده هستند.
بسیاری از محیط‌های رومیزی شامل پنجره‌های
\f[CR]desktop\f[R]
برای پس‌زمینه، آیکون‌ها و منوی میزکار هستند، در این موارد شاید بهتر باشد از
\f[CR]normal\f[R]
یا یکی از گزینه‌های زیر استفاده کنید، زیرا با کلیک روی آنها ممکن است روی conky را بپوشانند.
.IP \(bu 2
پنجره‌های
\f[CR]dock\f[R]
روی لبه‌های صفحه نمایش قرار می‌گیرند.
آن‌ها از اکثر جهات مشابه
\f[CR]desktop\f[R]
هستند، اما بالاتر از پنجره‌های
\f[CR]desktop\f[R]
و پایین‌تر از پنجره‌های
\f[CR]normal\f[R]
رسم می‌شوند.
برنامه Conky حاشیه‌های رزرو (struts) برای این نوع پنجره تعریف نمی‌کند، اما برخی از مدیران پنجره ممکن است همچنان به طور ضمنی از قرار دادن پنجره‌ها روی آن خودداری کنند.
.IP \(bu 2
پنجره‌های
\f[CR]panel\f[R]
مشابه پنجره‌های
\f[CR]dock\f[R]
هستند، اما علاوه بر آن، فضایی را نیز
\f[I]در امتداد لبه محیط کاری\f[R]
(مانند نوارهای وظیفه) رزرو می‌کنند و مانع از هم‌پوشانی پنجره‌های تمام‌صفحه با آنها می‌شوند.
لبه بر اساس موقعیت و اندازه نهایی conky و ابعاد محیط کاری انتخاب می‌شود تا اطمینان حاصل شود که پنجره‌های معمولی بیشترین فضای آزاد را در دسترس دارند.
برای مدیران پنجره‌ای که صفحه‌های کاملاً پوشانده‌شده را از ناحیه رزروشده جدا می‌کنند، لبه بر اساس تنظیم
\f[CR]alignment\f[R]
انتخاب خواهد شد.
در Wayland لبه رزروشده همواره از
\f[CR]alignment\f[R]
مشتق می‌شود؛ تراز کاملاً مرکزی (\f[CR]mm\f[R]) هیچ لبه‌ای برای رزرو ندارد، بنابراین از مقداری تراز شده با لبه استفاده کنید (مانند
\f[CR]tm\f[R]،
\f[CR]bm\f[R]،
\f[CR]ml\f[R]،
\f[CR]mr\f[R]).
.IP \(bu 2
پنجره‌های
\f[CR]utility\f[R]
پنجره‌های کاربردی ماندگار هستند (مانند جعبه‌ابزار یا پالت).
آن‌ها بالاتر از سایر پنجره‌ها (در همان گروه) ظاهر می‌شوند، اما در غیر این صورت رفتاری بسیار شبیه به پنجره‌های
\f[CR]normal\f[R]
دارند.
.IP \(bu 2
پنجره‌های
\f[CR]override\f[R]
مستقیماً روی پنجره ریشه (پس‌زمینه میزکار) کشیده می‌شوند و تحت کنترل مدیر پنجره نیستند.
این پنجره‌ها در محیط‌های رومیزی که آیکون‌های دسکتاپ را از طریق پنل‌ها یا پنجره‌های سفارشی رسم می‌کنند کار نمی‌کنند، زیرا آن‌ها روی conky را می‌پوشانند.
گزینه‌های
\f[CR]own_window_hints\f[R]
برای پنجره‌های
\f[CR]override\f[R]
نادیده گرفته می‌شوند.
پس‌زمینه‌های نیمه‌شفاف با پنجره‌های
\f[CR]override\f[R]
کار نمی‌کنند، زیرا کامپوزیتورها معمولاً پنجره‌های override\-redirect را ترکیب نمی‌کنند.
شفافیت کامل (آلفای 0) ممکن است از طریق شبه‌شفافیت (pseudo\-transparency) کار کند.
.PP
برای سوار کردن conky روی پنجره ریشه،
\f[CR]own_window\f[R]
را روی
\f[CR]false\f[R]
تنظیم نمایید.
.PP
پیش‌فرض: normal
.RE
.TP
\f[B]pad_percents\f[R]
تکمیل درصدها تا این تعداد رقم اعشار (0 = بدون اعشار).
.TP
\f[B]pop3\f[R] \f[B]host user pass [`\-i interval (in seconds)'] [`\-p port'] [\(lq\-e `command'\(rq] [`\-r retries']\f[R]
سرور پیش‌فرض سراسری POP3.
آرگومان‌ها عبارتند از:
\f[CR]host user pass [\-i interval (in seconds)] [\-p port] [\-e \(aqcommand\(aq] [\-r retries]\f[R].
پورت پیش‌فرض 110، بازه زمانی پیش‌فرض 5 دقیقه، و تعداد پیش‌فرض تلاش مجدد قبل از انصراف 5 است.
اگر گذرواژه به صورت \(cq*\(cq وارد شود، هنگام شروع Conky از شما خواسته می‌شود گذرواژه را وارد کنید.
.TP
\f[B]short_units\f[R]
واحدها را به یک کاراکتر کوتاه می‌کند (مانند kiB\->k، GiB\->G و غیره).
.TP
\f[B]show_graph_range\f[R]
محدوده زمانی پوشش داده شده توسط نمودار را نشان می‌دهد.
.TP
\f[B]show_graph_scale\f[R]
حداکثر مقدار را در نمودارهای مقیاس‌بندی‌شده نشان می‌دهد.
.TP
\f[B]stippled_borders\f[R]
نقطه‌چین یا خط‌چین بودن حاشیه بر حسب پیکسل.
.TP
\f[B]temperature_unit\f[R]
واحد خروجی مورد نظر برای تمام اشیایی که دما را نمایش می‌دهند.
پارامترها یا
\f[CR]fahrenheit\f[R]
یا
\f[CR]celsius\f[R]
هستند.
.RS
.PP
پیش‌فرض: celsius
.RE
.TP
\f[B]templateN\f[R]
تعریف یک الگو برای استفاده بعدی در بخش‌های conky.text.
مقدار N را با رقمی بین 0 تا 9 (شامل هر دو) جایگزین کنید.
مقدار این متغیر درون محتویات داخل conky.text در موقعیت مربوطه درج می‌شود، اما قبل از اینکه برخی جایگزینی‌ها اعمال شوند:
.RS
.IP \(bu 2
\f[CR]\(rs\(rsn\f[R] \-> خط جدید (newline)
.IP \(bu 2
\f[CR]\(rs\(rs\f[R] \-> بک‌اسلش (backslash)
.IP \(bu 2
\f[CR]\(rs\(rs\f[R] \-> فاصله (space)
.IP \(bu 2
\f[CR]\(rs\(rsN\f[R] \-> آرگومان N الگو (شروع از 1)
.RE
.TP
\f[B]text_buffer_size\f[R] \f[B]integer_number\f[R]
اندازه بافر استاندارد متن بر حسب بایت.
این بافر برای متن‌های واسط مانند خطوط جداگانه، خروجی متغیرهای $exec و متغیرهای مختلف دیگر استفاده می‌شود.
افزایش اندازه این بافر می‌تواند عملکرد Conky را به شدت کاهش دهد، اما امکان نمایش متن بیشتری را برای هر متغیر فراهم می‌کند.
اندازه این بافر نمی‌تواند از مقدار پیش‌فرض 256 بایت کوچکتر باشد.
.RS
.PP
پیش‌فرض: 256
.RE
.TP
\f[B]times_in_seconds\f[R]
در صورت تنظیم روی true، متغیرهایی که زمان را در خروجی می‌آورند عددی را نشان می‌دهند که نمایانگر ثانیه است.
این گزینه بر متغیرهای $time، $tztime و $utime تأثیری ندارد.
.TP
\f[B]top_cpu_separate\f[R]
در صورت تنظیم روی true، مقدار cpu در دستور top میزان مصرف توان یک پردازنده را نشان می‌دهد.
در صورت تنظیم روی false، مقدار cpu در top مجموع مصرف توان تمام پردازنده‌ها را با هم نشان می‌دهد.
.TP
\f[B]top_name_verbose\f[R]
در صورت تنظیم روی true، مقدار top name کل خط فرمان هر پردازش را شامل آرگومان‌ها (در صورت امکان) نشان می‌دهد.
در غیر این صورت، تنها نام پایه (basename) نمایش داده می‌شود.
.RS
.PP
پیش‌فرض: false
.RE
.TP
\f[B]top_name_width\f[R]
عرض مقدار $top name بر حسب کاراکتر.
.RS
.PP
پیش‌فرض: 15
.RE
.TP
\f[B]total_run_times\f[R]
تعداد کل دفعاتی که Conky قبل از خروج به‌روزرسانی می‌شود.
مقدار صفر باعث می‌شود Conky برای همیشه اجرا شود.
.TP
\f[B]units_spacer\f[R]
رشته‌ای که باید بین مقادیر و واحدها قرار گیرد.
.RS
.PP
پیش‌فرض: \(cq\(cq (رشته خالی)
.RE
.TP
\f[B]update_interval\f[R] \f[B]seconds\f[R]
بازه زمانی به‌روزرسانی.
.TP
\f[B]update_interval_on_battery\f[R] \f[B]seconds\f[R]
بازه زمانی به‌روزرسانی هنگام کار با توان باتری.
.TP
\f[B]uppercase\f[R]
مقدار بولی؛ در صورت تنظیم روی true، متن با حروف بزرگ نمایش داده می‌شود.
.TP
\f[B]use_spacer\f[R]
افزودن فاصله در اطراف اشیای خاص برای جلوگیری از جابجا کردن سایر موارد توسط آن‌ها.
می‌تواند
\f[CR]none\f[R]
(پیش‌فرض)،
\f[CR]left\f[R]
یا
\f[CR]right\f[R]
باشد.
مقادیر قدیمی true/false منسوخ شده‌اند و به ترتیب به صورت پیش‌فرض به right/none تبدیل می‌شوند.
توجه داشته باشید که این گزینه فقط در صورتی کمک می‌کند که از قلم دارای عرض ثابت (مانند Bitstream Vera Sans Mono) استفاده کنید.
.RS
.PP
پیش‌فرض: none
.RE
.TP
\f[B]use_xft\f[R]
استفاده از Xft (قلم‌های دارای هموارسازی خطوط یا anti\-aliased و امکانات مرتبط).
.TP
\f[B]xftalpha\f[R]
کانال آلفای قلم Xft.
باید مقداری بین 0 و 1 یا برابر با آن‌ها باشد.
.TP
\f[B]xinerama_head\f[R]
مشخص کردن نمایشگر (head) در Xinerama.
.SH "اشیای سیستمی و متغیرها (OBJECTS/VARIABLES)"
برای پیکربندی مواردی که Conky نمایش می‌دهد، باید متغیرهایی را در بخش
\f[CR]conky.text\f[R]
از پیکربندی خود تعیین کنید.
در این بخش فهرستی از متغیرهای موجود ارائه شده است.
ممکن است کارکرد برخی از آن‌ها مستلزم فعال بودن گزینه‌های ساخت در زمان کامپایل باشد.
.PP
رنگ‌ها با استفاده از
\f[CR]XParseColor()\f[R]
پردازش می‌شوند.
فهرستی از رنگ‌های نام‌گذاری‌شده ممکن است در
\f[CR]/usr/share/X11/rgb.txt\f[R]
موجود باشد.
همچنین می‌توان رنگ‌ها را در قالب هگزادسیمال
\f[CR]#rrggbb\f[R]
مشخص کرد.
.PP
برخی از اشیا ممکن است ریسه‌هایی (threads) ایجاد کنند، و گاهی اوقات این ریسه‌ها تا زمان پایان کار Conky از بین نمی‌روند.
هیچ راهی برای بستن یا پاکسازی ریسه‌ها در زمان اجرای Conky وجود ندارد.
به‌عنوان مثال، اگر از متغیر MPD استفاده کنید، ریسهٔ مربوط به MPD تا زمان خروج Conky به اجرای خود ادامه خواهد داد.
برخی اشیای چندریسمانی از یکی از پارامترها به‌عنوان یک
\f[CR]key\f[R]
(کلید) استفاده می‌کنند تا فقط یک ریسهٔ مرتبط در حال اجرا باشد (برای نمونه، اشیای $curl و $rss برای هر URI یک ریسه اجرا می‌کنند).
.PP
آرگومان‌های اختیاری معمولاً با پرانتز مشخص می‌شوند، به‌عنوان مثال
\f[CR](optional)\f[R].
.TP
\f[B]acpiacadapter\f[R] \f[B](adapter)\f[R]
وضعیت آداپتور برق متناوب (AC) در ACPI.
در لینوکس، گزینه adapter زیرپوشه‌ای از
\f[CR]/sys/class/power_supply\f[R]
را مشخص می‌کند که حاوی اطلاعات وضعیت است.
اگر آرگومانی داده نشود، مقادیر
\f[CR]AC\f[R]
و
\f[CR]ADP1\f[R]
را امتحان می‌کند.
سیستم‌های غیرلینوکسی آن را نادیده می‌گیرند.
.TP
\f[B]acpifan\f[R]
وضعیت فن ACPI.
.TP
\f[B]acpitemp\f[R]
دمای ACPI به درجه سلسیوس (سانتی‌گراد).
.TP
\f[B]addr\f[R] \f[B](interface)\f[R]
آدرس IP برای یک رابط شبکه، یا عبارت \(lqNo Address\(rq در صورتی که هیچ آدرسی تخصیص نیافته باشد.
.TP
\f[B]addrs\f[R] \f[B](interface)\f[R]
آدرس‌های IP برای یک رابط شبکه (اگر فقط یکی باشد، مانند addr عمل می‌کند).
تنها در لینوکس.
.TP
\f[B]adt746xcpu\f[R]
دمای پردازنده (CPU) از ماژول therm_adt746x.
.TP
\f[B]adt746xfan\f[R]
سرعت فن از ماژول therm_adt746x.
.TP
\f[B]alignc\f[R] \f[B](num)\f[R]
تراز کردن متن در مرکز (وسط‌چین).
.TP
\f[B]alignr\f[R] \f[B](num)\f[R]
راست‌چین کردن متن، با فاصله N.
.TP
\f[B]apcupsd\f[R] \f[B]host port\f[R]
برقراری اتصال با دیمن apcupsd.
چیزی چاپ نمی‌کند.
.RS
.PP
پیش‌فرض: localhost:3551
.RE
.TP
\f[B]apcupsd_cable\f[R]
نوع اتصال UPS را چاپ می‌کند.
.TP
\f[B]apcupsd_charge\f[R]
ظرفیت فعلی باتری بر حسب درصد.
.TP
\f[B]apcupsd_lastxfer\f[R]
علت آخرین انتقال از برق شبکه به باتری.
.TP
\f[B]apcupsd_linev\f[R]
ولتاژ اسمی ورودی.
.TP
\f[B]apcupsd_load\f[R]
بار فعلی بر حسب درصد.
.TP
\f[B]apcupsd_loadbar\f[R]
نواری که بار فعلی را نمایش می‌دهد.
.TP
\f[B]apcupsd_loadgauge\f[R] \f[B](height),(width)\f[R]
نشانگری (گیج) که بار فعلی را نمایش می‌دهد.
.TP
\f[B]apcupsd_loadgraph\f[R] \f[B](height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
نمودار تاریخچهٔ بار فعلی.
.TP
\f[B]apcupsd_model\f[R]
مدل UPS را چاپ می‌کند.
.TP
\f[B]apcupsd_name\f[R]
نام تعریف‌شده توسط کاربر برای UPS را چاپ می‌کند.
.TP
\f[B]apcupsd_status\f[R]
وضعیت فعلی را چاپ می‌کند (on\-line، on\-battery).
.TP
\f[B]apcupsd_temp\f[R]
دمای داخلی فعلی.
.TP
\f[B]apcupsd_timeleft\f[R]
زمان باقی‌مانده برای کارکرد با باتری.
.TP
\f[B]apcupsd_upsmode\f[R]
حالت کاری UPS را چاپ می‌کند (مثلاً standalone).
.TP
\f[B]apm_adapter\f[R]
نمایش وضعیت آداپتور برق متناوب در APM.
تنها در FreeBSD و OpenBSD.
.TP
\f[B]apm_battery_life\f[R]
نمایش درصد شارژ باقی‌مانده باتری در APM.
تنها در FreeBSD و OpenBSD.
.TP
\f[B]apm_battery_time\f[R]
نمایش زمان باقی‌مانده باتری در APM به صورت hh:mm:ss یا \(lqunknown\(rq در صورتی که آداپتور برق متصل (online) یا در حال شارژ باشد.
تنها در FreeBSD و OpenBSD.
.TP
\f[B]audacious_bar\f[R] \f[B](height),(width)\f[R]
نوار پیشرفت.
.TP
\f[B]audacious_bitrate\f[R]
بیت‌ریت (نرخ بیت) قطعهٔ فعلی.
.TP
\f[B]audacious_channels\f[R]
تعداد کانال‌های صوتی قطعهٔ فعلی.
.TP
\f[B]audacious_filename\f[R]
مسیر کامل و نام فایل قطعهٔ فعلی.
.TP
\f[B]audacious_frequency\f[R]
فرکانس نمونه‌برداری قطعهٔ فعلی.
.TP
\f[B]audacious_length\f[R]
مدت زمان کل قطعهٔ فعلی به صورت MM:SS.
.TP
\f[B]audacious_length_seconds\f[R]
مدت زمان کل قطعهٔ فعلی بر حسب ثانیه.
.TP
\f[B]audacious_main_volume\f[R]
میزان صدای فعلی گزارش‌شده توسط Audacious.
.TP
\f[B]audacious_playlist_length\f[R]
تعداد آهنگ‌ها در فهرست پخش (playlist).
.TP
\f[B]audacious_playlist_position\f[R]
موقعیت قطعهٔ فعلی در فهرست پخش.
.TP
\f[B]audacious_position\f[R]
موقعیت زمانی قطعهٔ فعلی (MM:SS).
.TP
\f[B]audacious_position_seconds\f[R]
موقعیت زمانی قطعهٔ فعلی بر حسب ثانیه.
.TP
\f[B]audacious_status\f[R]
وضعیت پخش‌کننده (Playing/Paused/Stopped/Not running).
.TP
\f[B]audacious_title\f[R] \f[B](max length)\f[R]
عنوان قطعهٔ فعلی به همراه تعیین اختیاری حداکثر طول رشته.
.TP
\f[B]battery\f[R] \f[B](num)\f[R]
وضعیت باتری و درصد ظرفیت باقی‌مانده برای باتری ACPI یا APM.
شمارهٔ باتری ACPI می‌تواند به عنوان یک آرگومان مشخص شود.
.RS
.PP
پیش‌فرض: BAT0
.RE
.TP
\f[B]battery_bar\f[R] \f[B](height),(width) (num)\f[R]
درصد باقی‌مانده باتری ACPI در قالب یک نوار.
شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود (از
\f[CR]all\f[R]
برای دریافت میانگین درصد باقی‌مانده تمام باتری‌ها استفاده کنید).
.RS
.PP
پیش‌فرض: BAT0
.RE
.TP
\f[B]battery_percent\f[R] \f[B](num)\f[R]
درصد باقی‌مانده برای باتری ACPI.
شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود (از
\f[CR]all\f[R]
برای دریافت میانگین درصد باقی‌مانده تمام باتری‌ها استفاده کنید).
.RS
.PP
پیش‌فرض: BAT0
.RE
.TP
\f[B]battery_power_draw\f[R] \f[B](num)\f[R]
توان مصرفی باتری بر حسب وات.
.RS
.PP
پیش‌فرض: BAT0
.RE
.TP
\f[B]battery_short\f[R] \f[B](num)\f[R]
وضعیت باتری و درصد ظرفیت باقی‌مانده برای باتری ACPI یا APM.
شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود.
این حالت یک وضعیت کوتاه نمایش می‌دهد:
\f[CR]C\f[R]
برای در حال شارژ (charging)،
\f[CR]D\f[R]
برای در حال تخلیه (discharging)،
\f[CR]F\f[R]
برای پر (full)،
\f[CR]N\f[R]
برای وجود نداشتن (not present)،
\f[CR]E\f[R]
برای خالی (empty)، و
\f[CR]U\f[R]
برای نامشخص (unknown).
.RS
.PP
پیش‌فرض: BAT0
.RE
.TP
\f[B]battery_status\f[R] \f[B](num)\f[R]
وضعیت باتری برای یک باتری ACPI.
شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود.
.RS
.PP
پیش‌فرض: BAT0
.RE
.TP
\f[B]battery_time\f[R] \f[B](num)\f[R]
زمان باقی‌مانده شارژ یا تخلیه باتری ACPI.
شمارهٔ باتری ACPI می‌تواند به عنوان آرگومان داده شود.
.RS
.PP
پیش‌فرض: BAT0
.RE
.TP
\f[B]blink\f[R] \f[B]text_and_other_conky_vars\f[R]
چشمک زدن متن و متغیرهای مشخص‌شده (خاموش و روشن شدن `text_and_other_conky_vars`).
.TP
\f[B]buffers\f[R]
میزان حافظهٔ اختصاص‌یافته به بافرها (buffered).
.TP
\f[B]cached\f[R]
میزان حافظهٔ اختصاص‌یافته به کَش (cached).
.TP
\f[B]cat\f[R] \f[B]file\f[R]
یک فایل را می‌خواند و محتویات آن را در Conky نمایش می‌دهد.
این ویژگی زمانی کاربرد دارد که فرآیندی مستقل خروجی‌ای تولید می‌کند که می‌خواهید آن را در Conky نمایش دهید.
.TP
\f[B]catp\f[R] \f[B]file\f[R]
یک فایل را می‌خواند و محتویات آن را در Conky نمایش می‌دهد.
این ویژگی زمانی کاربرد دارد که فرآیندی مستقل خروجی‌ای تولید می‌کند که می‌خواهید آن را در Conky نمایش دهید.
تفاوت این دستور با
\f[CR]$cat\f[R]
در این است که محتویات فایل را پردازش (parse) می‌کند، بنابراین می‌توانید مواردی مانند
\f[CR]${color red}hi!${color}\f[R]
را در فایل خود قرار دهید و Conky آن را به درستی تفسیر کند.
.TP
\f[B]cmdline_to_pid\f[R] \f[B]string\f[R]
شناسهٔ فرآیند (PID) اولین فرآیندی که خط فرمان آن شامل رشتهٔ داده‌شده باشد.
.TP
\f[B]cmus_aaa\f[R]
چاپ وضعیت aaa در پخش‌کننده cmus (حالت‌های all/artist/album).
.TP
\f[B]cmus_album\f[R]
نام آلبوم آهنگ فعلی cmus را چاپ می‌کند.
.TP
\f[B]cmus_artist\f[R]
نام هنرمند آهنگ فعلی cmus را چاپ می‌کند.
.TP
\f[B]cmus_curtime\f[R]
زمان فعلی سپری‌شده از آهنگ فعلی cmus.
.TP
\f[B]cmus_date\f[R]
تاریخ انتشار آهنگ فعلی cmus را چاپ می‌کند.
.TP
\f[B]cmus_file\f[R]
نام فایل آهنگ فعلی cmus را چاپ می‌کند.
.TP
\f[B]cmus_genre\f[R]
نام سبک (ژانر) آهنگ فعلی cmus را چاپ می‌کند.
.TP
\f[B]cmus_percent\f[R]
درصد پیشرفت آهنگ در حال پخش.
.TP
\f[B]cmus_progress\f[R] \f[B](height),(width)\f[R]
نوار پیشرفت پخش در cmus.
.TP
\f[B]cmus_random\f[R]
وضعیت پخش تصادفی (Random) در cmus (فعال/غیرفعال \- on/off).
.TP
\f[B]cmus_repeat\f[R]
وضعیت تکرار (Repeat) در cmus (حالت‌های song/all/off).
.TP
\f[B]cmus_state\f[R]
وضعیت کنونی cmus (مانند playing، paused، stopped و غیره).
.TP
\f[B]cmus_timeleft\f[R]
زمان باقی‌مانده از آهنگ فعلی cmus.
.TP
\f[B]cmus_title\f[R]
عنوان آهنگ فعلی cmus را چاپ می‌کند.
.TP
\f[B]cmus_totaltime\f[R]
مدت زمان کل آهنگ فعلی cmus.
.TP
\f[B]cmus_track\f[R]
شماره قطعه (ترک) آهنگ فعلی cmus را چاپ می‌کند.
.TP
\f[B]color\f[R] \f[B](color)\f[R]
تغییر رنگ رسم به
\f[I]color\f[R]
که می‌تواند نام یک رنگ یا کد هگزادسیمال همراه با # باشد، مانند
\f[CR]#0A1B2C\f[R].
در صورت استفاده از ncurses فقط رنگ‌های زیر پشتیبانی می‌شوند:
red، green، yellow، blue، magenta، cyan، black و white.
.TP
\f[B]colorN\f[R]
تغییر رنگ رسم به گزینهٔ پیکربندی colorN، که در آن N عددی بین 0 تا 9 (شامل هر دو) است.
.TP
\f[B]combine\f[R] \f[B]var1 var2\f[R]
خطوط var2 را در سمت راست خطوط var1 قرار می‌دهد که با نویسه‌های درج‌شده بین var1 و var2 از یکدیگر جدا می‌شوند.
به‌عنوان مثال:
\f[CR]${combine ${head /proc/cpuinfo 2} \- ${head /proc/meminfo 1}}\f[R]
در خط اول خروجی
\f[CR]cpuinfo_line1 \- meminfo_line1\f[R]
و در خط دوم خروجی
\f[CR]cpuinfo_line2 \-\f[R]
را می‌دهد.
متغیرهای $combine همچنین می‌توانند به‌صورت تودرتو استفاده شوند تا متغیرهای بیشتری در کنار یکدیگر قرار گیرند.
.TP
\f[B]conky_build_arch\f[R]
معماری پردازنده‌ای (CPU) که Conky برای آن ساخته شده است.
.TP
\f[B]conky_version\f[R]
نسخهٔ Conky.
.TP
\f[B]cpu\f[R] \f[B](cpuN)\f[R]
میزان استفاده از پردازنده (CPU) بر حسب درصد.
برای سیستم‌های چندپردازنده‌ای (SMP)، شمارهٔ CPU می‌تواند به عنوان یک آرگومان داده شود.
${cpu cpu0} کل میزان مصرف، و ${cpu cpuX} (که در آن X >= 1) میزان مصرف تک‌تک هسته‌ها/پردازنده‌ها است.
.TP
\f[B]cpubar\f[R] \f[B](cpuN) (height),(width)\f[R]
نواری که میزان مصرف پردازنده را نشان می‌دهد؛ height ارتفاع نوار بر حسب پیکسل است.
برای اطلاعات بیشتر در مورد SMP به $cpu مراجعه کنید.
.TP
\f[B]cpugauge\f[R] \f[B](cpuN) (height),(width)\f[R]
نشانگر بیضوی (گیج) که میزان مصرف پردازنده را نشان می‌دهد؛ height و width به ترتیب محورهای عمودی و افقی نشانگر هستند.
برای اطلاعات بیشتر در مورد SMP به $cpu مراجعه کنید.
.TP
\f[B]cpugovernor\f[R] \f[B](cpuN)\f[R]
گاورنر فعال تنظیم فرکانس پردازنده (CPU scaling governor)، که به‌طور پیش‌فرض اولین هسته است.
برای اطلاعات بیشتر در مورد SMP به $cpu مراجعه کنید.
تنها در لینوکس.
.TP
\f[B]cpugraph\f[R] \f[B](cpuN) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
نمودار مصرف پردازنده، با رنگ‌های اختیاری در قالب هگزادسیمال (بدون #).
برای اطلاعات بیشتر در مورد SMP به $cpu مراجعه کنید.
در صورت استفاده از سوییچ
\-l
از مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند.
سوییچ
`\-t'
یک گرادیان دمایی اعمال می‌کند که باعث می‌شود مقادیر گرادیان بسته به دامنهٔ یک مقدار خاص در نمودار تغییر کند (امتحان کنید تا ببینید).
فلگ
`\-x'
محور x و فلگ
`\-y'
محور y نمودار را معکوس می‌کند.
فلگ
`\-m'
یک حد پایین/حداقل غیرصفر تعیین می‌کند، و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل تعیین‌شده باشند (به‌جز صفر).
.TP
\f[B]curl\f[R] \f[B]url (interval_in_minutes)\f[R]
دانلود داده‌ها از URI با استفاده از Curl در بازهٔ زمانی مشخص‌شده.
بازهٔ زمانی می‌تواند یک عدد اعشاری مثبت باشد (0 نیز مجاز است)، در غیر این صورت مقدار پیش‌فرض 15 دقیقه است.
بیشترین کاربرد آن در ترکیب با Lua و API زبان Lua است.
این شیء چندریسمانی (threaded) است و پس از ایجاد ریسه، نمی‌توان آن را به‌طور صریح از بین برد.
برای هر URI مشخص‌شده یک ریسه اجرا خواهد شد.
می‌توانید از هر پروتکلی که Curl پشتیبانی می‌کند استفاده کنید.
.TP
\f[B]desktop\f[R]
شمارهٔ میزمحیطی (دسکتاپ) که Conky در آن اجرا می‌شود یا پیام \(lqNot running in X\(rq در صورتی که در سرور X اجرا نشده باشد.
.TP
\f[B]desktop_name\f[R]
نام دسکتاپی که Conky در آن اجرا می‌شود یا پیام \(lqNot running in X\(rq در صورتی که در سرور X اجرا نشده باشد.
.TP
\f[B]desktop_number\f[R]
تعداد کل دسکتاپ‌ها یا پیام \(lqNot running in X\(rq در صورتی که در سرور X اجرا نشده باشد.
.TP
\f[B]disk_protect\f[R] \f[B]device\f[R]
وضعیت محافظت از دیسک، در صورت پشتیبانی (نیازمند وصلهٔ کرنل است).
عبارت \(lqfrozen\(rq یا \(lqfree\(rq را چاپ می‌کند (به فاصله‌های پرکننده توجه کنید).
.TP
\f[B]diskio\f[R] \f[B](device)\f[R]
نمایش ورودی/خروجی (IO) فعلی دیسک.
آرگومان device اختیاری است و برای /dev/sda به شکل sda مشخص می‌شود.
برچسب یک دستگاه بلوکی را می‌توان با label:foo و شناسه‌یکتای پارتیشن (partuuid) آن را می‌توان با partuuid:40000000\-01 مشخص کرد.
.TP
\f[B]diskio_read\f[R] \f[B](device)\f[R]
نمایش ورودی/خروجی (IO) فعلی خواندن دیسک.
آرگومان device همانند diskio است.
.TP
\f[B]diskio_write\f[R] \f[B](device)\f[R]
نمایش ورودی/خروجی (IO) فعلی نوشتن روی دیسک.
آرگومان device همانند diskio است.
.TP
\f[B]diskiograph\f[R] \f[B](device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
نمودار ورودی/خروجی دیسک، رنگ‌ها در قالب هگزادسیمال (بدون #) تعریف می‌شوند.
اگر scale غیرصفر باشد، به عنوان مقیاس نمودار در نظر گرفته می‌شود.
در صورت استفاده از سوییچ
\-l
از مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند.
سوییچ
`\-t'
یک گرادیان دمایی اعمال می‌کند که باعث می‌شود مقادیر گرادیان بسته به دامنهٔ یک مقدار خاص در نمودار تغییر کند (امتحان کنید تا ببینید).
فلگ
`\-x'
محور x و فلگ
`\-y'
محور y نمودار را معکوس می‌کند.
فلگ
`\-m'
یک حد پایین/حداقل غیرصفر تعیین می‌کند، و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل تعیین‌شده باشند (به‌جز صفر).
.TP
\f[B]diskiograph_read\f[R] \f[B](device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
نمودار ورودی/خروجی (IO) دیسک برای خواندن، رنگ‌ها به صورت هگزادسیمال و بدون # تعریف می‌شوند.
.RS
.IP "1." 3
اگر مقیاس (scale) غیرصفر باشد، به عنوان مقیاس نمودار در نظر گرفته می‌شود.
دستگاه (Device) همانند diskio است.
هنگام استفاده از سوییچ \-l از یک مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند.
سوییچ `\-t' را برای استفاده از گرادیان حرارتی می‌پذیرد که باعث می‌شود مقادیر گرادیان بسته به دامنه مقدار خاصی در نمودار تغییر کنند (امتحان کنید تا ببینید).
فلگ `\-x' محور x و `\-y' محور y نمودار را معکوس می‌کند.
فلگ `\-m' یک مقدار حداقل/کران پایین غیرصفر تعیین می‌کند و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).
.RE
.TP
\f[B]diskiograph_write\f[R] \f[B](device) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
نمودار ورودی/خروجی (IO) دیسک برای نوشتن، رنگ‌ها به صورت هگزادسیمال و بدون # تعریف می‌شوند.
.RS
.IP "1." 3
اگر مقیاس (scale) غیرصفر باشد، به عنوان مقیاس نمودار در نظر گرفته می‌شود.
دستگاه (Device) همانند diskio است.
هنگام استفاده از سوییچ \-l از یک مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند.
سوییچ `\-t' را برای استفاده از گرادیان حرارتی می‌پذیرد که باعث می‌شود مقادیر گرادیان بسته به دامنه مقدار خاصی در نمودار تغییر کنند (امتحان کنید تا ببینید).
فلگ `\-x' محور x و `\-y' محور y نمودار را معکوس می‌کند.
فلگ `\-m' یک مقدار حداقل/کران پایین غیرصفر تعیین می‌کند و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).
.RE
.TP
\f[B]distribution\f[R]
نام توزیع لینوکس.
مقدار \f[CR]NAME\f[R] از فایل \f[CR]/etc/os\-release\f[R] خوانده می‌شود و در صورت عدم موفقیت از محتوای \f[CR]/proc/version\f[R] به عنوان پشتیبان استفاده می‌گردد.
در صورتی که اطلاعات گزارش‌شده نادرست است، یک گزارش مشکل (issue) ثبت کنید.
.TP
\f[B]downspeed\f[R] \f[B](net)\f[R]
سرعت بارگیری در واحدهای استاندارد و مناسب IEC.
.TP
\f[B]downspeedf\f[R] \f[B](net)\f[R]
سرعت بارگیری بر حسب KiB با یک رقم اعشار.
.TP
\f[B]downspeedgraph\f[R] \f[B](netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m)\f[R]
نمودار سرعت بارگیری، رنگ‌ها به صورت هگزادسیمال و بدون # تعریف می‌شوند.
اگر مقیاس (scale) غیرصفر باشد، حداکثر مقدار نمودار را (بر حسب بایت بر ثانیه) مشخص می‌کند.
هنگام استفاده از سوییچ \-l از یک مقیاس لگاریتمی (برای مشاهده اعداد کوچک) استفاده می‌کند.
سوییچ `\-t' را برای استفاده از گرادیان حرارتی می‌پذیرد که باعث می‌شود مقادیر گرادیان بسته به دامنه مقدار خاصی در نمودار تغییر کنند (امتحان کنید تا ببینید).
فلگ `\-x' محور x و `\-y' محور y نمودار را معکوس می‌کند.
فلگ `\-m' یک مقدار حداقل/کران پایین غیرصفر تعیین می‌کند و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).
.TP
\f[B]draft_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد ایمیل‌های علامت‌گذاری‌شده به عنوان پیش‌نویس (draft) در صندوق پستی مشخص‌شده یا در صورت مشخص نشدن، در صف ایمیل (mail spool).
تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار \-1 را بازمی‌گرداند.
.TP
\f[B]else\f[R]
متنی که اگر هیچ‌یک از شرایط بالا برقرار نباشند نمایش داده می‌شود.
.TP
\f[B]endif\f[R]
پایان دادن به یک بلوک $if.
.TP
\f[B]entropy_avail\f[R]
انتروپی موجود و در دسترس فعلی برای خوره‌های رمزنگاری.
.TP
\f[B]entropy_bar\f[R] \f[B](height),(width)\f[R]
نوار نرمال‌شده انتروپی موجود برای خوره‌های رمزنگاری.
.TP
\f[B]entropy_perc\f[R]
درصد انتروپی موجود در مقایسه با اندازه مخزن انتروپی (poolsize).
.TP
\f[B]entropy_poolsize\f[R]
اندازه کل مخزن انتروپی سیستم برای خوره‌های رمزنگاری.
.TP
\f[B]eval\f[R] \f[B]string\f[R]
رشته داده‌شده را طبق قواعد تفسیر conky.text ارزیابی می‌کند؛ یعنی تجزیه مشخصات هر شیء متنی موجود به خروجی آن، تبدیل هر
`$′\f[I]i\f[R]\f[I]n\f[R]\f[I]t\f[R]\f[I]o\f[R]\f[I]a\f[R]\f[I]s\f[R]\f[I]i\f[R]\f[I]n\f[R]\f[I]g\f[R]\f[I]l\f[R]\f[I]e\f[R]^′^'
و غیره.
سپس خروجی دوباره تجزیه می‌شود.
.TP
\f[B]exec\f[R] \f[B]command\f[R]
یک دستور پوسته را اجرا می‌کند و خروجی را در conky نمایش می‌دهد.
هشدار: این متغیر نسبت به سایر متغیرها منابع بسیار بیشتری مصرف می‌کند.
پیشنهاد می‌کنم رفتار مورد نظر را در C/C++ کدنویسی کرده و یک وصله (patch) ارسال کنید.
.TP
\f[B]execbar\f[R] \f[B](height),(width) command\f[R]
همانند exec است، با این تفاوت که اگر اولین مقدار بازگردانده‌شده عددی بین 0\-100 باشد، از آن عدد برای رسم یک نوار افقی استفاده می‌کند.
پارامترهای ارتفاع (height) و عرض (width) اختیاری هستند و به ترتیب به گزینه‌های پیکربندی default_bar_height و default_bar_width پیش‌فرض می‌شوند.
.TP
\f[B]execgauge\f[R] \f[B](height),(width) command\f[R]
همانند exec است، با این تفاوت که اگر اولین مقدار بازگردانده‌شده عددی بین 0\-100 باشد، از آن عدد برای رسم یک درجه دایره‌ای (بسیار شبیه به سرعت‌سنج خودرو) استفاده می‌کند.
پارامترهای ارتفاع و عرض اختیاری هستند و به ترتیب به گزینه‌های پیکربندی default_gauge_height و default_gauge_width پیش‌فرض می‌شوند.
.TP
\f[B]execgraph\f[R] \f[B]command (height),(width) (gradient color 1) (gradient color 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
یک نمودار پیمایش‌شونده افقی با مقادیر 0\-100 که روی محور عمودی ترسیم شده‌اند، رسم می‌کند.
تمامی پارامترهای پس از دستور اختیاری هستند.
رنگ‌های گرادیان را می‌توان به صورت مقادیر هگزادسیمال بدون پیشوند 0x یا # مشخص کرد.
از سوییچ \-t برای فعال‌سازی گرادیان حرارتی استفاده کنید، تا مقادیر کوچک با رنگ 1 «سرد» (\(lqcold\(rq) و مقادیر بزرگ با رنگ 2 «گرم» (\(lqhot\(rq) باشند.
بدون سوییچ \-t، رنگ‌ها یک گرادیان افقی در امتداد عرض نمودار ایجاد می‌کنند.
پارامتر مقیاس (scale) حداکثر مقدار نمودار را تعیین می‌کند.
از سوییچ \-l برای فعال‌سازی یک مقیاس لگاریتمی استفاده کنید که به مشاهده مقادیر کوچک کمک می‌کند.
اندازه پیش‌فرض نمودارها را می‌توان از طریق تنظیمات پیکربندی default_graph_height و default_graph_width کنترل کرد.
فلگ `\-x' محور x و `\-y' محور y نمودار را معکوس می‌کند.
فلگ `\-m' یک مقدار حداقل/کران پایین غیرصفر تعیین می‌کند و تضمین می‌نماید که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).
.RS
.PP
اگر نیاز به اجرای دستوری با فاصله دارید، چند گزینه پیش رو دارید:
.IP "1." 3
دستور خود را در نقل‌قول دوگانه (double-quotes) قرار دهید، یا
.IP "2." 3
دستور خود را در یک فایل جداگانه مانند \(ti/bin/myscript.sh قرار داده و از آن به عنوان دستور execgraph استفاده کنید.
.PP
به یاد داشته باشید که اسکریپت خود را قابل اجرا کنید!
.PP
در مثال زیر، execgraph را به گونه‌ای تنظیم می‌کنیم که ثانیه‌ها (0\-59) را روی نموداری با ارتفاع 50 پیکسل و عرض 200 پیکسل، با استفاده از گرادیان حرارتی با رنگ‌های متغیر از قرمز برای مقادیر کوچک (FF0000) تا زرد برای مقادیر بزرگ (FFFF00) نمایش دهد.
ما مقیاس را روی 60 تنظیم می‌کنیم.
.IP
.EX
${execgraph \(ti/seconds.sh 50,200 FF0000 FFFF00 60 \-t}
.EE
.RE
.TP
\f[B]execi\f[R] \f[B]interval command\f[R]
همانند exec است، اما با یک بازه زمانی مشخص بر حسب ثانیه.
این بازه زمانی نمی‌تواند کمتر از مقدار update_interval در پیکربندی شما باشد.
همچنین $texeci را ببینید.
.TP
\f[B]execibar\f[R] \f[B]interval (height),(width) command\f[R]
همانند execbar است، اما با یک بازه زمانی.
.TP
\f[B]execigauge\f[R] \f[B]interval (height),(width) command\f[R]
همانند execgauge است، اما با یک بازه زمانی.
.TP
\f[B]execigraph\f[R] \f[B]interval command (height),(width) (gradient color 1) (gradient color 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
همانند execgraph است، اما با یک بازه زمانی.
.TP
\f[B]execp\f[R] \f[B]command\f[R]
یک دستور پوسته را اجرا می‌کند و خروجی را در conky نمایش می‌دهد.
هشدار: این متغیر نسبت به سایر متغیرها منابع بسیار بیشتری مصرف می‌کند.
پیشنهاد می‌کنم رفتار مورد نظر را در C/C++ کدنویسی کرده و یک وصله ارسال کنید.
تفاوت آن با $exec در این است که خروجی دستور را تجزیه می‌کند، بنابراین می‌توانید مواردی مانند \(ga${color red}hi!${color}\(ga را در اسکریپت خود وارد کنید تا به درستی توسط Conky تجزیه شوند.
نکات مهم: Conky خروجی $execp را در هر بار اجرای حلقه Conky تجزیه و ارزیابی می‌کند، و سپس تمام اشیاء را نابود می‌سازد.
اگر سعی کنید از مواردی مانند $execi درون عبارت $execp استفاده کنید، عملاً در همان بازه زمانی اجرای عبارت $execp اجرا خواهد شد، چرا که در هر بازه ایجاد شده و از بین می‌رود.
.TP
\f[B]execpi\f[R] \f[B]interval command\f[R]
همانند execp است، اما با یک بازه زمانی.
توجه داشته باشید که خروجی دستور $execpi همچنان در هر بازه زمانی تجزیه و ارزیابی می‌شود.
.TP
\f[B]flagged_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد ایمیل‌های علامت‌گذاری‌شده به عنوان پرچم‌دار (flagged) در صندوق پستی مشخص‌شده یا در صورت مشخص نشدن، در صف ایمیل (mail spool).
تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار \-1 را بازمی‌گرداند.
.TP
\f[B]font\f[R] \f[B](font)\f[R]
مشخص کردن یک قلم متفاوت.
این قلم جدید بر خط جاری و تمام خطوط پس از آن اعمال خواهد شد.
می‌توانید از $font بدون آرگومان برای بازگشت به قلم پیش‌فرض استفاده کنید (بسیار شبیه به $color).
.TP
\f[B]fontN\f[R]
تغییر قلم به گزینه پیکربندی fontN، که در آن N رقمی بین 0 و 9 (شامل هر دو) است.
.TP
\f[B]format_time\f[R] \f[B]seconds format\f[R]
قالب‌بندی زمان داده‌شده بر حسب ثانیه.
این متغیر تنها زمانی کار می‌کند که تنظیم پیکربندی times_in_seconds فعال باشد.
قالب رشته‌ای است که باید با نویسه نقل‌قول دوگانه \f[CR]\(dq\f[R] شروع و پایان یابد.
نویسه‌های نقل‌قول بخشی از خروجی نیستند؛ ,,,(,) و \(rs با هفته‌ها، روزها، ساعت‌ها، دقیقه‌ها، ثانیه‌ها، (، ) و جایگزین می‌شوند.
اگر واحدی را حذف کنید، مقدار آن در بزرگ‌ترین واحد پایین‌تر از واحد حذف‌شده بیان می‌شود.
متن بین نویسه‌های ()\- در صورتی که واحد جایگزین‌شده در این متن 0 باشد، قابل مشاهده نخواهد بود.
اگر ثانیه‌ها یک عدد اعشاری باشند، می‌توانید با استفاده از نویسه به همراه عددی که تعداد ارقام اعشار مورد نظر را مشخص می‌کند (حداکثر 9)، ارقام اعشار را مشاهده کنید.
همچنین می‌توانید یک `x' در ادامه قرار دهید تا تمام ارقام بعد از اعشار بدون صفر\(cqsهای پایانی نمایش داده شوند (همچنین حداکثر 9).
.TP
\f[B]forwarded_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد ایمیل‌های علامت‌گذاری‌شده به عنوان فورواردشده در صندوق پستی مشخص‌شده یا در صورت مشخص نشدن، در صف ایمیل (mail spool).
تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار \-1 را بازمی‌گرداند.
.TP
\f[B]free_bufcache\f[R]
میزان حافظه بافرشده یا کَش‌شده، طبق گزارش دستور free.
فقط لینوکس.
.TP
\f[B]free_cached\f[R]
میزان حافظه کَش‌شده، طبق گزارش دستور free.
فقط لینوکس.
.TP
\f[B]freq\f[R] \f[B](n)\f[R]
فرکانس پردازنده شماره n را بر حسب مگاهرتز بازمی‌گرداند.
شمارش پردازنده‌ها از 1 شروع می‌شود.
.RS
.PP
پیش‌فرض: 1
.RE
.TP
\f[B]freq2\f[R] \f[B](n)\f[R]
سرعت کلاک پردازنده شماره n را از کد اسمبلی بر حسب مگاهرتز بازمی‌گرداند.
شمارش پردازنده‌ها از 1 شروع می‌شود.
.RS
.PP
پیش‌فرض: 1
.RE
.TP
\f[B]freq_g\f[R] \f[B](n)\f[R]
فرکانس پردازنده شماره n را بر حسب گیگاهرتز بازمی‌گرداند.
شمارش پردازنده‌ها از 1 شروع می‌شود.
.RS
.PP
پیش‌فرض: 1
.RE
.TP
\f[B]fs_bar\f[R] \f[B](height),(width) fs\f[R]
نواری که نشان می‌دهد چه مقدار فضا در یک سیستم فایل استفاده شده است.
height ارتفاع بر حسب پیکسل است.
fs هر فایلی بر روی آن سیستم فایل است.
.TP
\f[B]fs_bar_free\f[R] \f[B](height),(width) fs\f[R]
نواری که نشان می‌دهد چه مقدار فضا در یک سیستم فایل آزاد است.
height ارتفاع بر حسب پیکسل است.
fs هر فایلی بر روی آن سیستم فایل است.
.TP
\f[B]fs_free\f[R] \f[B](fs)\f[R]
فضای آزاد در یک سیستم فایل که در دسترس کاربران است.
.TP
\f[B]fs_free_perc\f[R] \f[B](fs)\f[R]
درصد فضای آزاد در یک سیستم فایل که در دسترس کاربران است.
.TP
\f[B]fs_size\f[R] \f[B](fs)\f[R]
اندازه سیستم فایل.
.TP
\f[B]fs_type\f[R] \f[B](fs)\f[R]
نوع سیستم فایل.
.TP
\f[B]fs_used\f[R] \f[B](fs)\f[R]
فضای استفاده‌شده سیستم فایل.
.TP
\f[B]fs_used_perc\f[R] \f[B](fs)\f[R]
درصد فضای استفاده‌شده سیستم فایل.
.TP
\f[B]gid_name\f[R] \f[B]gid\f[R]
نام گروه دارای این gid.
.TP
\f[B]github_notifications\f[R]
تعداد اعلان‌های گیت‌هاب (GitHub).
.TP
\f[B]goto\f[R] \f[B]x\f[R]
عنصر بعدی در موقعیت `x' چاپ خواهد شد.
.TP
\f[B]gw_iface\f[R]
رابط مسیر پیش‌فرض یا بر این اساس \(lqmultiple\(rq/\(lqnone\(rq را نمایش می‌دهد.
.TP
\f[B]gw_ip\f[R]
نشانی IP درگاه پیش‌فرض یا بر این اساس \(lqmultiple\(rq/\(lqnone\(rq را نمایش می‌دهد.
.TP
\f[B]hddtemp\f[R] \f[B](dev)\f[R]
دمای دیسک سخت انتخاب‌شده را طبق گزارش دیمن hddtemp نمایش می‌دهد.
از hddtemp_host و hddtemp_port برای مشخص کردن میزبان و پورت برای تمامی اشیاء hddtemp استفاده کنید.
اگر پارامتر dev داده نشود، اولین دیسک بازگردانده‌شده توسط دیمن hddtemp استفاده خواهد شد.
.TP
\f[B]head\f[R] \f[B]logfile lines (next_check)\f[R]
تعداد N خط اول فایل متنی ارائه‌شده را نمایش می‌دهد.
فایل در هر به‌روزرسانی `next_check' بررسی می‌شود.
اگر next_check ارائه نشود، Conky به طور پیش‌فرض از 2 استفاده می‌کند.
حداکثر 30 خط را می‌توان نمایش داد، یا تا زمانی که بافر متنی پر شود.
.TP
\f[B]hr\f[R] \f[B](height) (width)\f[R]
خط افقی، height ارتفاع بر حسب پیکسل است.
از width می‌توان برای تنظیم عرض خط افقی بر حسب پیکسل استفاده کرد.
.TP
\f[B]hwmon\f[R] \f[B](dev) type n (factor offset)\f[R]
حسگر Hwmon از sysfs (لینوکس 2.6).
پارامتر dev می‌تواند یکی از موارد زیر باشد:
.RS
.IP "1." 3
عدد.
برای مثال \f[CR]1\f[R] به معنی hwmon1 است.
.IP "2." 3
نام ماژول.
برای مثال \f[CR]k10temp\f[R] به معنی اولین دستگاه hwmon است که نام ماژول آن \f[CR]k10temp\f[R] باشد.
.IP "3." 3
حذف شود.
در این صورت از اولین دستگاه hwmon یعنی (hwmon0) استفاده خواهد شد.
.PP
پارامتر type یا \f[CR]in\f[R] است یا \f[CR]vol\f[R] به معنی ولتاژ؛ \f[CR]fan\f[R] به معنی فن؛ \f[CR]temp\f[R] به معنی دما.
پارامتر n شماره حسگر است.
مسیر \f[CR]/sys/class/hwmon/\f[R] را روی رایانه محلی خود ببینید.
آرگومان‌های اختیاری \f[CR]factor\f[R] و \f[CR]offset\f[R] امکان محاسبه پیشاپیش ورودی خام را فراهم می‌کنند که به شکل زیر تغییر می‌یابد:
\f[CR]input = input * factor + offset\f[R].
توجه داشته باشید که آن‌ها باید به صورت مقادیر اعشاری داده شوند (یعنی حداقل دارای یک رقم اعشار باشند).
.RE
.TP
\f[B]hwmonbar\f[R] \f[B](height),(width) (dev) type n (factor offset)\f[R]
همانند hwmon است، اما مقدار خوانده‌شده حسگر را به صورت یک نوار افقی نمایش می‌دهد.
از factor و offset برای تغییر مقیاس مقدار گزارش‌شده توسط hwmon به محدوده 0\-100 استفاده کنید.
مقادیر دما از قبل از میلی‌درجه تبدیل شده‌اند.
ارتفاع و عرض به ترتیب به صورت پیش‌فرض برابر با default_bar_height و default_bar_width هستند.
.TP
\f[B]i2c\f[R] \f[B](dev) type n (factor offset)\f[R]
حسگر I2C از sysfs (لینوکس 2.6).
اگر فقط یک دستگاه I2C دارید، پارامتر dev می‌تواند حذف شود.
پارامتر type یا \f[CR]in\f[R] است یا \f[CR]vol\f[R] به معنی ولتاژ؛ \f[CR]fan\f[R] به معنی فن؛ \f[CR]temp\f[R] به معنی دما.
پارامتر n شماره حسگر است.
مسیر \f[CR]/sys/bus/i2c/devices/\f[R] را روی رایانه محلی خود ببینید.
آرگومان‌های اختیاری \f[CR]factor\f[R] و \f[CR]offset\f[R] امکان محاسبه پیشاپیش ورودی خام را فراهم می‌کنند که به شکل زیر تغییر می‌یابد:
\f[CR]input = input * factor + offset\f[R].
توجه داشته باشید که آن‌ها باید به صورت مقادیر اعشاری داده شوند (یعنی حداقل دارای یک رقم اعشار باشند).
.TP
\f[B]i2cbar\f[R] \f[B](height),(width) (dev) type n (factor offset)\f[R]
همانند i2c است، اما مقدار خوانده‌شده حسگر را به صورت یک نوار افقی نمایش می‌دهد.
از factor و offset برای تغییر مقیاس مقدار گزارش‌شده توسط i2c به محدوده 0\-100 استفاده کنید.
مقادیر دما از قبل از میلی‌درجه تبدیل شده‌اند.
ارتفاع و عرض به ترتیب به صورت پیش‌فرض برابر با default_bar_height و default_bar_width هستند.
.TP
\f[B]i8k_ac_status\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، وضعیت متصل بودن برق متناوب (AC) را مطابق با \f[CR]/proc/i8k\f[R] (ترجمه‌شده به حالت خوانا برای انسان) نمایش می‌دهد.
توجه داشته باشید که این ویژگی به صورت پیش‌فرض توسط خود i8k فعال نیست.
.TP
\f[B]i8k_bios\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، نسخه بایوس (BIOS) را مطابق با /proc/i8k نمایش می‌دهد.
.TP
\f[B]i8k_buttons_status\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، وضعیت دکمه‌های میزان صدا را مطابق با /proc/i8k نمایش می‌دهد.
.TP
\f[B]i8k_cpu_temp\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، دمای پردازنده را بر حسب سلسیوس، طبق گزارش /proc/i8k نمایش می‌دهد.
.TP
\f[B]i8k_left_fan_rpm\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، سرعت چرخش فن چپ را بر حسب دور بر دقیقه (RPM) مطابق با /proc/i8k نمایش می‌دهد.
توجه داشته باشید که در برخی لپ‌تاپ‌ها، i8k این فن‌ها را با ترتیب معکوس گزارش می‌کند.
.TP
\f[B]i8k_left_fan_status\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، وضعیت فن چپ را مطابق با /proc/i8k (ترجمه‌شده به حالت خوانا برای انسان) نمایش می‌دهد.
توجه داشته باشید که در برخی لپ‌تاپ‌ها، i8k این فن‌ها را با ترتیب معکوس گزارش می‌کند.
.TP
\f[B]i8k_right_fan_rpm\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، سرعت چرخش فن راست را بر حسب دور بر دقیقه (RPM) مطابق با /proc/i8k نمایش می‌دهد.
توجه داشته باشید که در برخی لپ‌تاپ‌ها، i8k این فن‌ها را با ترتیب معکوس گزارش می‌کند.
.TP
\f[B]i8k_right_fan_status\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، وضعیت فن راست را مطابق با /proc/i8k (ترجمه‌شده به حالت خوانا برای انسان) نمایش می‌دهد.
توجه داشته باشید که در برخی لپ‌تاپ‌ها، i8k این فن‌ها را با ترتیب معکوس گزارش می‌کند.
.TP
\f[B]i8k_serial\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، شماره سریال لپ‌تاپ شما را مطابق با /proc/i8k نمایش می‌دهد.
.TP
\f[B]i8k_version\f[R]
در صورت اجرای درایور هسته i8k برای لپ‌تاپ‌های Inspiron، قالب‌بندی نسخه /proc/i8k را نمایش می‌دهد.
.TP
\f[B]ibm_brightness\f[R]
در صورت اجرای IBM ACPI، میزان روشنایی صفحه‌نمایش LCD لپ‌تاپ را نمایش می‌دهد (0\-7).
.TP
\f[B]ibm_fan\f[R]
در صورت اجرای IBM ACPI، سرعت فن را نمایش می‌دهد.
.TP
\f[B]ibm_temps\f[R] \f[B]N\f[R]
در صورت اجرای IBM ACPI، دماها را از حسگرهای دمای IBM نمایش می‌دهد (N=0..7). حسگر 0 روی CPU و حسگر 3 روی GPU قرار دارد.
.TP
\f[B]ibm_thinklight\f[R]
در صورت اجرای IBM ACPI، وضعیت ThinkLight™ شما را نمایش می‌دهد.
مقدار آن یکی از موارد `on'، `off' یا `unknown' است.
.TP
\f[B]ibm_volume\f[R]
در صورت اجرای IBM ACPI، میزان صدای اصلی (\(lqmaster\(rq) را که توسط کلیدهای میزان صدا کنترل می‌شود نمایش می‌دهد (0\-14).
.TP
\f[B]ical\f[R] \f[B]number file\f[R]
عنوان رویداد شماره `number' را در فایل ical (RFC 5545) با نام `file' نمایش می‌دهد.
رویدادها ابتدا بر اساس زمان شروع مرتب می‌شوند؛ رویدادهایی که در گذشته آغاز شده‌اند نادیده گرفته می‌شوند.
رویدادهایی که نمایش داده می‌شوند VEVENTها هستند، عنوانی که نشان داده می‌شود SUMMARY است و زمان شروع استفاده‌شده برای مرتب‌سازی DTSTART می‌باشد.
.TP
\f[B]iconv_start\f[R] \f[B]codeset_from codeset_to\f[R]
تبدیل متن از یک مجموعه‌کد به مجموعه‌کد دیگر با استفاده از GNU iconv.
باید با iconv_stop متوقف شود.
.TP
\f[B]iconv_stop\f[R]
توقف تبدیل مجموعه نویسه (codeset) توسط iconv.
.TP
\f[B]if_empty\f[R] \f[B](var)\f[R]
اگر متغیرِ کانکی VAR خالی باشد، تمام موارد بین $if_empty و $endif متناظر نمایش داده می‌شود.
.TP
\f[B]if_existing\f[R] \f[B]file (string)\f[R]
اگر FILE وجود داشته باشد، تمام موارد بین if_existing و $endif متناظر نمایش داده می‌شود.
پارامتر اختیاری دوم وجود رشته مشخص‌شده در FILE را بررسی کرده و تمام موارد بین $if_existing و $endif متناظر را چاپ می‌کند.
.TP
\f[B]if_gw\f[R]
اگر حداقل یک درگاه پیش‌فرض (default gateway) وجود داشته باشد، تمام موارد بین $if_gw و $endif متناظر نمایش داده می‌شود.
.TP
\f[B]if_match\f[R] \f[B]expression\f[R]
عبارت بولی داده‌شده را ارزیابی کرده و بسته به درست (true) بودن یا نبودن نتیجه، تمام موارد بین $if_match و $endif متناظر را چاپ می‌کند.
عبارت‌های معتبر شامل یک سمت چپ، یک عملگر و یک سمت راست هستند.
سمت چپ و راست پیش از ارزیابی، برای اشیاء متنی موجود در آن‌ها تجزیه می‌شوند.
.RS
.PP
انواع معتبر و شناخته‌شده برای سمت چپ و راست عبارتند از:
.IP \(bu 2
\f[B]double\f[R]: آرگومان فقط از ارقام و یک نقطه تشکیل شده است.
.IP \(bu 2
\f[B]long\f[R]: آرگومان فقط شامل ارقام است.
.IP \(bu 2
\f[B]string\f[R]: آرگومان درون علامت نقل‌قول (\f[CR]\(dq\f[R]) قرار دارد.
.PP
عملگرهای معتبر عبارتند از:
.IP \(bu 2
\f[CR]<\f[R] یا \f[CR]>\f[R]
.IP \(bu 2
\f[CR]<=\f[R] یا \f[CR]>=\f[R]
.IP \(bu 2
\f[CR]==\f[R] یا \f[CR]!=\f[R]
.RE
.TP
\f[B]if_mixer_mute\f[R] \f[B](mixer)\f[R]
اگر میکسر موجود [و بی‌صدا] باشد، تمام موارد بین $if_mixer_mute و $endif متناظر را نمایش می‌دهد.
اگر هیچ مکسری مشخص نشود، از \(lqVol\(rq استفاده می‌شود.
.TP
\f[B]if_mounted\f[R] \f[B](mountpoint)\f[R]
اگر نقطه اتصال MOUNTPOINT متصل (مونت) شده باشد، تمام موارد بین $if_mounted و $endif متناظر نمایش داده می‌شود.
.TP
\f[B]if_mpd_playing\f[R]
اگر mpd در حال پخش یا مکث باشد، تمام موارد بین $if_mpd_playing و $endif متناظر را نمایش می‌دهد.
.TP
\f[B]if_pa_sink_muted\f[R]
اگر سینک پیش‌فرض PulseAudio بی‌صدا (muted) باشد، تمام موارد بین $if_pa_sink_muted و $else یا $endif متناظر را نمایش می‌دهد.
.TP
\f[B]if_pa_source_muted\f[R]
اگر سورس پیش‌فرض PulseAudio (مانند میکروفون شما) بی‌صدا باشد، تمام موارد بین $if_pa_source_muted و $else یا $endif متناظر را نمایش می‌دهد.
.TP
\f[B]if_pa_source_running\f[R]
اگر سورس پیش‌فرض PulseAudio در حال کار باشد (مثلاً برنامه‌ای در حال دسترسی به میکروفون شما باشد)، تمام موارد بین $if_pa_source_running و $else یا $endif متناظر را نمایش می‌دهد.
.TP
\f[B]if_running\f[R] \f[B](process)\f[R]
اگر PROCESS در حال اجرا باشد، تمام موارد بین \f[CR]$if_running\f[R] و \f[CR]$else\f[R] یا \f[CR]$endif\f[R] متناظر را نمایش می‌دهد.
توجه داشته باشید که PROCESS می‌تواند یک خط فرمان کامل به همراه آرگومان‌ها (بدون پیشوند دایرکتوری)، یا صرفاً نام یک فایل اجرایی باشد.
به عنوان مثال، در صورت در حال اجرا بودن فرآیندی با خط فرمان \f[CR]/usr/bin/conky \-u 5\f[R], هر یک از موارد زیر درست خواهد بود:
.RS
.IP \(bu 2
\f[CR]${if_running conky \-u 5}\f[R] یا
.IP \(bu 2
\f[CR]${if_running conky}\f[R]
.PP
مهم است که فاصله‌های پایانی قرار داده نشوند.
به عنوان مثال، \f[CR]${if_running conky }\f[R] نادرست خواهد بود.
.RE
.TP
\f[B]if_smapi_bat_installed\f[R] \f[B](INDEX)\f[R]
هنگام استفاده از smapi، اگر باتری با نمایه INDEX نصب شده باشد، تمام موارد بین $if_smapi_bat_installed و $endif متناظر را نمایش می‌دهد.
.TP
\f[B]if_up\f[R] \f[B](interface)\f[R]
اگر INTERFACE وجود داشته و فعال (up) باشد، تمام موارد بین $if_up و $endif متناظر را نمایش می‌دهد.
.TP
\f[B]if_updatenr\f[R] \f[B](updatenr)\f[R]
اگر UPDATENR\-امین باری باشد که کانکی به‌روزرسانی می‌شود، تمام موارد بین $if_updatenr و $endif متناظر را نمایش می‌دهد.
با رسیدن به بالاترین UPDATENR، شمارنده بازنشانی می‌شود.
.RS
.PP
مثال:
\f[CR]{$if_updatenr 1}foo$endif{$if_updatenr 2}bar$endif{$if_updatenr 4}$endif\f[R]
در ۲۵٪ مواقع foo، پس از آن در ۲۵٪ مواقع bar، و در نصف دیگر زمان هیچ‌چیز را نشان نمی‌دهد.
.RE
.TP
\f[B]if_xmms2_connected\f[R]
اگر xmms2 در حال اجرا باشد، تمام موارد بین $if_xmms2_connected و $endif متناظر را نمایش می‌دهد.
.TP
\f[B]iface\f[R] \f[B](number)\f[R]
نام‌های رابط شبکه را با شروع از شماره ۱ نمایش می‌دهد؛ مانند \f[CR]${iface 1}\f[R].
.TP
\f[B]image\f[R] \f[B] (\-p x,y) (\-s WxH) (\-n) (\-f interval)\f[R]
تصویری را از مسیر مشخص‌شده با استفاده از Imlib2 رندر می‌کند.
۴ آرگومان اختیاری می‌پذیرد: موقعیت، اندازه، سوییچ عدم ذخیره در حافظه پنهان (no\-cache)، و فاصله زمانی پاکسازی حافظه پنهان.
تغییر موقعیت x,y محل قرارگیری تصویر را تغییر می‌دهد و تغییر WxH تصویر را مقیاس‌بندی می‌کند.
اگر گزینه عدم ذخیره در حافظه پنهان (\-n) را مشخص کنید، تصویر در حافظه پنهان ذخیره نخواهد شد.
همچنین می‌توانید از سوییچ \-f int برای مشخص کردن فاصله زمانی پاکسازی حافظه پنهان برای یک تصویر خاص استفاده کنید.
مثال: \f[CR]${image /home/brenden/cheeseburger.jpg \-p 20,20 \-s 200x200}\f[R]
تصویر `cheeseburger.jpg' را در موقعیت (20,20) با اندازه ۲۰۰×۲۰۰ پیکسل رندر می‌کند.
کانکی هیچ تلاشی برای تنظیم موقعیت (یا هر قالب‌بندی دیگری) از تصاویر نمی‌کند؛ آن‌ها صرفاً طبق آرگومان‌های ارائه‌شده رندر می‌شوند.
تنها دلیل اینکه $image بخشی از بخش conky.text است، فراهم آوردن امکان تغییرات در زمان اجرا از طریق $execp ،$lua_parse یا روش‌های دیگر است.
.TP
\f[B]imap_messages\f[R] \f[B](args)\f[R]
به‌طور پیش‌فرض تعداد پیام‌های موجود در صندوق ورودی سراسری IMAP شما را نمایش می‌دهد.
می‌توانید صندوق‌های ورودی IMAP مجزا را با ارسال آرگومان‌ها به این شیء، به صورت جداگانه تعریف کنید.
آرگومان‌ها عبارتند از: \(lqhost user pass [\-i interval (in seconds)] [\-f `folder'] [\-p port] [\-e `command'] [\-r retries]\(rq.
پورت پیش‌فرض ۱۴۳، پوشه پیش‌فرض `INBOX'، فاصله زمانی پیش‌فرض ۵ دقیقه، و تعداد تلاش‌های مجدد پیش‌فرض قبل از انصراف ۵ است.
اگر گذرواژه به صورت \(cq*\(cq داده شود، هنگام شروع کانکی از شما خواسته می‌شود گذرواژه را وارد کنید.
.TP
\f[B]imap_unseen\f[R] \f[B](args)\f[R]
به‌طور پیش‌فرض تعداد پیام‌های دیده‌نشده در صندوق ورودی سراسری IMAP شما را نمایش می‌دهد.
می‌توانید صندوق‌های ورودی IMAP مجزا را با ارسال آرگومان‌ها به این شیء، به صورت جداگانه تعریف کنید.
آرگومان‌ها عبارتند از: \(lqhost user pass [\-i interval (in seconds)] [\-f `folder'] [\-p port] [\-e `command'] [\-r retries]\(rq.
پورت پیش‌فرض ۱۴۳، پوشه پیش‌فرض `INBOX'، فاصله زمانی پیش‌فرض ۵ دقیقه، و تعداد تلاش‌های مجدد پیش‌فرض قبل از انصراف ۵ است.
اگر گذرواژه به صورت \(cq*\(cq داده شود، هنگام شروع کانکی از شما خواسته می‌شود گذرواژه را وارد کنید.
.TP
\f[B]intel_backlight\f[R]
روشنایی نور پس‌زمینه اینتل (Intel backlight) را بر حسب درصد نمایش می‌دهد.
.TP
\f[B]ioscheduler\f[R] \f[B]disk\f[R]
زمان‌بند ورودی/خروجی (ioscheduler) فعلی مورد استفاده برای نام دیسک مشخص‌شده (مانند \(lqhda\(rq یا \(lqsdb\(rq) را چاپ می‌کند.
.TP
\f[B]irc\f[R] \f[B]server(:port) #channel (max_msg_lines)\f[R]
هر آنچه را که در کانال #channel روی سرور IRC به نام `server' گفته می‌شود نمایش می‌دهد.
در صورت عدم تعیین `port'، از پورت TCP شماره ۶۶۶۷ برای اتصال استفاده می‌شود.
همه پیام‌ها از آخرین بار یا در صورت مشخص شدن، آخرین ورودی‌های `max_msg_lines' را نشان می‌دهد.
.TP
\f[B]journal\f[R] \f[B](lines) (type)\f[R]
N خط آخر ژورنال systemd را نمایش می‌دهد.
در صورت حذف N، مقدار پیش‌فرض آن ۱ است.
از ۰ برای نمایش تمام خطوط موجود استفاده کنید.
مقادیر منفی به ۱ محدود می‌شوند.
نوع اختیاری type ژورنال مورد خواندن را فیلتر می‌کند: `system' فقط ژورنال سیستم را نشان می‌دهد، `user' فقط ژورنال کاربر جاری را نشان می‌دهد، `runtime' فقط ژورنال زمان اجرا را نشان می‌دهد، و `local' تمام ژورنال‌های محلی را نشان می‌دهد (حالت پیش‌فرض، مشابه حذف type).
خروجی توسط اندازه بافر متنی محدود می‌شود.
.TP
\f[B]kernel\f[R]
نسخه هسته (کرنل).
.TP
\f[B]key_caps_lock\f[R]
نشانگری برای کلید قفل حروف بزرگ (Caps Lock).
.TP
\f[B]key_num_lock\f[R]
نشانگری برای کلید قفل اعداد (Num Lock).
.TP
\f[B]key_scroll_lock\f[R]
نشانگری برای کلید قفل پیمایش (Scroll Lock).
.TP
\f[B]keyboard_layout\f[R]
چیدمان صفحه‌کلید را نمایش می‌دهد.
.TP
\f[B]laptop_mode\f[R]
مقدار فایل \f[CR]/proc/sys/vm/laptop_mode\f[R].
.TP
\f[B]legacymem\f[R]
میزان حافظه مصرفی، محاسبه‌شده به همان شیوه در برنامه \f[CR]free\f[R].
.TP
\f[B]lines\f[R] \f[B]textfile\f[R]
تعداد خطوط موجود در فایل داده‌شده را نمایش می‌دهد.
.TP
\f[B]loadavg\f[R] \f[B](1|2|3)\f[R]
میانگین بار سیستم؛ عدد ۱ برای ۱ دقیقه گذشته، ۲ برای ۵ دقیقه گذشته و ۳ برای ۱۵ دقیقه گذشته است.
بدون آرگومان، هر سه مقدار را جداشده با فاصله چاپ می‌کند.
.TP
\f[B]loadgraph\f[R] \f[B](height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
نمودار میانگین بار ۱ دقیقه‌ای (Load1)، شبیه به xload، با رنگ‌های اختیاری در قالب هگز بدون علامت #.
هنگام استفاده از سوییچ \-l، از مقیاس لگاریتمی (برای مشاهده مقادیر کوچک) استفاده می‌کند.
سوییچ `\-t' را برای استفاده از طیف دمایی می‌پذیرد، که باعث می‌شود مقادیر طیف بسته به دامنه مقدار نمودار تغییر کنند (امتحان کنید تا ببینید).
گزینه `\-x' محور x و `\-y' محور y نمودار را معکوس می‌کند.
گزینه `\-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقلِ مشخص‌شده باشند (به جز صفر).
.TP
\f[B]lowercase\f[R] \f[B]text\f[R]
تمام حروف را به حروف کوچک تبدیل می‌کند.
.TP
\f[B]lua\f[R] \f[B]function_name (function parameters)\f[R]
یک تابع Lua را با پارامترهای داده‌شده اجرا می‌کند، سپس رشته بازگردانده‌شده را چاپ می‌کند.
همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید.
کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
.TP
\f[B]lua_bar\f[R] \f[B](height,width) function_name (function parameters)\f[R]
یک تابع Lua را با پارامترهای داده‌شده اجرا می‌کند و یک نوار رسم می‌کند.
انتظار می‌رود مقدار نتیجه یک عدد صحیح بین ۰ و ۱۰۰ باشد.
همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید.
کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
.TP
\f[B]lua_gauge\f[R] \f[B](height,width) function_name (function parameters)\f[R]
یک تابع Lua را با پارامترهای داده‌شده اجرا می‌کند و یک سنجه (gauge) رسم می‌کند.
انتظار می‌رود مقدار نتیجه یک عدد صحیح بین ۰ و ۱۰۰ باشد.
همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید.
کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
.TP
\f[B]lua_graph\f[R] \f[B]function_name (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
یک تابع Lua را اجرا می‌کند و نموداری رسم می‌نماید.
انتظار می‌رود مقدار نتیجه هر عددی باشد، و به‌طور پیش‌فرض برای نمایش کل محدوده مقیاس‌بندی می‌شود.
همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید.
سوییچ `\-t' را برای استفاده از طیف دمایی می‌پذیرد، که باعث می‌شود مقادیر طیف بسته به دامنه مقدار نمودار تغییر کنند (امتحان کنید تا ببینید).
کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
گزینه `\-x' محور x و `\-y' محور y نمودار را معکوس می‌کند.
گزینه `\-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقلِ مشخص‌شده باشند (به جز صفر).
.TP
\f[B]lua_parse\f[R] \f[B]function_name (function parameters)\f[R]
یک تابع Lua را با پارامترهای داده‌شده مانند $lua اجرا می‌کند، سپس مقدار نتیجه را مطابق با نحو (سینتکس) بخش conky.text تجزیه و چاپ می‌کند.
همچنین برای نحوه بارگذاری اسکریپت‌ها به `lua_load' مراجعه کنید.
کانکی پیشوند `conky_' را به ابتدای function_name اضافه می‌کند تا از فراخوانی تصادفی تابع اشتباه جلوگیری کند، مگر اینکه خودتان `conky_' را در ابتدای آن قرار داده باشید.
.TP
\f[B]machine\f[R]
معماری ماشین؛ مانند \f[CR]i686\f[R] یا \f[CR]x86_64\f[R].
.TP
\f[B]mails\f[R] \f[B](mailbox) (interval)\f[R]
تعداد نامه‌های موجود در صندوق پستی مشخص‌شده یا در صورت عدم تعیین، در صف نامه‌های (mail spool) شما.
هر دو نوع صندوق پستی mbox و maildir پشتیبانی می‌شوند.
می‌توانید از برنامه‌ای مانند fetchmail برای دریافت نامه‌ها از یک سرور با استفاده از پروتکل مورد علاقه خود استفاده کنید.
همچنین به new_mails مراجعه کنید.
.TP
\f[B]mboxscan\f[R] \f[B](\-n number of messages to print) (\-fw from width) (\-sw subject width) mbox\f[R]
خلاصه‌ای از پیام‌های اخیر را در یک صندوق پستی با فرمت mbox چاپ می‌کند.
پارامتر mbox نام فایل صندوق پستی است (می‌تواند با استفاده از \(cq\(lq\(cq احاطه شود، یعنی
${mboxscan \-n 10\(rq/home/brenden/some box\(rq}
.TP
\f[B]mem\f[R]
مقدار حافظه در حال استفاده.
.TP
\f[B]memactive\f[R]
مقدار حافظه فعال (active).
فقط در FreeBSD.
.TP
\f[B]memavail\f[R]
مقدار حافظه در دسترس، طبق آنچه در \f[CR]/proc/meminfo\f[R] ثبت شده است.
فقط در لینوکس ۳.۱۴ به بالا.
.TP
\f[B]membar\f[R] \f[B](height),(width)\f[R]
نواری که مقدار حافظه در حال استفاده را نمایش می‌دهد.
.TP
\f[B]memdirty\f[R]
مقدار حافظه بازنویسی‌شده یا اصطلاحاً کثیف (\(lqdirty\(rq).
فقط در لینوکس.
.TP
\f[B]memeasyfree\f[R]
مقدار حافظه آزاد شامل حافظه‌ای که بسیار آسان آزاد می‌شود (بافرها/کاشه‌ها).
.TP
\f[B]memfree\f[R]
مقدار حافظه آزاد.
.TP
\f[B]memgauge\f[R] \f[B](height),(width)\f[R]
سنجه‌ای که مقدار حافظه در حال استفاده را نشان می‌دهد (cpugauge را ببینید).
.TP
\f[B]memgraph\f[R] \f[B](height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
نمودار مصرف حافظه.
هنگام استفاده از سوییچ \-l، از مقیاس لگاریتمی (برای مشاهده مقادیر کوچک) استفاده می‌کند.
سوییچ `\-t' را برای استفاده از طیف دمایی می‌پذیرد، که باعث می‌شود مقادیر طیف بسته به دامنه مقدار نمودار تغییر کنند (امتحان کنید تا ببینید).
گزینه `\-x' محور x و `\-y' محور y نمودار را معکوس می‌کند.
گزینه `\-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقلِ مشخص‌شده باشند (به جز صفر).
.TP
\f[B]meminactive\f[R]
مقدار حافظه غیرفعال (inactive).
فقط در FreeBSD.
.TP
\f[B]memlaundry\f[R]
مقدار حافظه موجود در صف laundry.
فقط در FreeBSD.
.TP
\f[B]memmax\f[R]
مقدار کل حافظه.
.TP
\f[B]memperc\f[R]
درصد حافظه در حال استفاده.
.TP
\f[B]memwired\f[R]
مقدار حافظه سیم‌کشی‌شده (wired).
فقط در FreeBSD.
.TP
\f[B]memwithbuffers\f[R]
مقدار حافظه در حال استفاده، شامل حافظه مصرف‌شده توسط بافرها و کاشه‌های سیستم.
.TP
\f[B]memwithbuffersbar\f[R] \f[B](height),(width)\f[R]
نواری که مقدار حافظه در حال استفاده را نشان می‌دهد (شامل حافظه مصرف‌شده توسط بافرها و کاشه‌های سیستم).
.TP
\f[B]memwithbuffersgraph\f[R] \f[B](height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m value)\f[R]
نمودار مصرف حافظه شامل حافظه مصرف‌شده توسط بافرها و کاشه سیستم.
هنگام استفاده از سوییچ \-l، از مقیاس لگاریتمی (برای مشاهده مقادیر کوچک) استفاده می‌کند.
سوییچ `\-t' را برای استفاده از طیف دمایی می‌پذیرد، که باعث می‌شود مقادیر طیف بسته به دامنه مقدار نمودار تغییر کنند (امتحان کنید تا ببینید).
گزینه `\-x' محور x و `\-y' محور y نمودار را معکوس می‌کند.
گزینه `\-m' یک حد پایین/حداقل غیرصفر تعیین می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقلِ مشخص‌شده باشند (به جز صفر).
.TP
\f[B]mixer\f[R] \f[B](device)\f[R]
مقدار میکسر گزارش‌شده توسط سیستم‌عامل را چاپ می‌کند.
در لینوکس، این متغیر از شبیه‌سازی OSS استفاده می‌کند، بنابراین باید ماژول کرنل مناسب بارگذاری شده باشد.
میکسر پیش‌فرض \(lqVol\(rq است، اما می‌توانید یکی از کنترل‌های موجود در OSS را مشخص کنید: \(lqVol\(rq، \(lqBass\(rq، \(lqTrebl\(rq، \(lqSynth\(rq،
\(lqPcm\(rq، \(lqSpkr\(rq، \(lqLine\(rq، \(lqMic\(rq، \(lqCD\(rq،
\(lqMix\(rq، \(lqPcm2\(rq، \(lqRec\(rq، \(lqIGain\(rq، \(lqOGain\(rq،
\(lqLine1\(rq، \(lqLine2\(rq، \(lqLine3\(rq، \(lqDigital1\(rq،
\(lqDigital2\(rq، \(lqDigital3\(rq، \(lqPhoneIn\(rq، \(lqPhoneOut\(rq،
\(lqVideo\(rq، \(lqRadio\(rq و \(lqMonitor\(rq.
.RS
.PP
پیش‌فرض: Vol
.RE
.TP
\f[B]mixerbar\f[R] \f[B](device)\f[R]
مقدار میکسر گزارش‌شده توسط سیستم‌عامل را در یک نوار نمایش می‌دهد.
برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
.TP
\f[B]mixerl\f[R] \f[B](device)\f[R]
مقدار میکسر کانال چپ را طبق گزارش سیستم‌عامل چاپ می‌کند.
برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
.TP
\f[B]mixerlbar\f[R] \f[B](device)\f[R]
مقدار میکسر کانال چپ را طبق گزارش سیستم‌عامل در یک نوار نمایش می‌دهد.
برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
.TP
\f[B]mixerr\f[R] \f[B](device)\f[R]
مقدار میکسر کانال راست را طبق گزارش سیستم‌عامل چاپ می‌کند.
برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
.TP
\f[B]mixerrbar\f[R] \f[B](device)\f[R]
مقدار میکسر کانال راست را طبق گزارش سیستم‌عامل در یک نوار نمایش می‌دهد.
برای جزئیات بیشتر در مورد آرگومان‌ها، مستندات $mixer را ببینید.
.TP
\f[B]moc_album\f[R]
آلبوم آهنگ جاری در MOC.
.TP
\f[B]moc_artist\f[R]
هنرمند (خواننده) آهنگ جاری در MOC.
.TP
\f[B]moc_bar\f[R] \f[B](height),(width)\f[R]
نوار پیشرفت آهنگ جاری در MOC.
.TP
\f[B]moc_bitrate\f[R]
نرخ بیت (bitrate) در آهنگ جاری MOC.
.TP
\f[B]moc_avgbitrate\f[R]
میانگین نرخ بیت در آهنگ جاری MOC.
.TP
\f[B]moc_curtime\f[R]
زمان سپری‌شده آهنگ جاری در MOC.
.TP
\f[B]moc_cursec\f[R]
زمان سپری‌شده آهنگ جاری در MOC به ثانیه.
.TP
\f[B]moc_file\f[R]
نام فایل آهنگ جاری در MOC.
.TP
\f[B]moc_percent\f[R]
درصد پیشرفت آهنگ جاری در MOC.
.TP
\f[B]moc_rate\f[R]
نرخ نمونه‌برداری آهنگ جاری در MOC.
.TP
\f[B]moc_song\f[R]
نام آهنگ در حال پخش در MOC.
.TP
\f[B]moc_state\f[R]
وضعیت جاری MOC؛ در حال پخش (playing)، متوقف (stopped) و غیره.
.TP
\f[B]moc_timeleft\f[R]
زمان باقی‌مانده از آهنگ جاری در MOC.
.TP
\f[B]moc_title\f[R]
عنوان آهنگ جاری در MOC.
.TP
\f[B]moc_totaltime\f[R]
مدت‌زمان کل آهنگ جاری در MOC.
.TP
\f[B]moc_totalsec\f[R]
مدت‌زمان کل آهنگ جاری در MOC برحسب ثانیه.
.TP
\f[B]monitor\f[R]
شماره مانیتوری که conky روی آن در حال اجرا است، یا پیام \(lqNot
running in X\(rq در صورتی که این‌گونه باشد.
.TP
\f[B]monitor_number\f[R]
تعداد مانیتورها، یا پیام \(lqNot running in X\(rq در صورتی که این‌گونه
باشد.
.TP
\f[B]mouse_speed\f[R]
نمایش سرعت ماوس.
.TP
\f[B]mpd_album\f[R]
نام آلبوم آهنگ جاری در MPD.
.TP
\f[B]mpd_albumartist\f[R]
هنرمند آلبوم آهنگ جاری در MPD.
.TP
\f[B]mpd_artist\f[R]
هنرمند آهنگ جاری در MPD؛ باید در زمان کامپایل فعال شده باشد.
.TP
\f[B]mpd_bar\f[R] \f[B](height),(width)\f[R]
نوار پیشرفت پخش در MPD.
.TP
\f[B]mpd_bitrate\f[R]
نرخ بیت (بیت‌ریت) آهنگ جاری.
.TP
\f[B]mpd_comment\f[R] \f[B](max\-length)\f[R]
توضیحات (کامنت) آهنگ جاری در MPD.
.TP
\f[B]mpd_date\f[R]
تاریخ آهنگ جاری.
.TP
\f[B]mpd_elapsed\f[R]
زمان سپری‌شده از آهنگ.
.TP
\f[B]mpd_file\f[R]
نام فایل آهنگ جاری در MPD را چاپ می‌کند.
.TP
\f[B]mpd_length\f[R]
مدت‌زمان آهنگ.
.TP
\f[B]mpd_name\f[R]
فیلد نام را در MPD چاپ می‌کند.
.TP
\f[B]mpd_percent\f[R]
درصد پیشرفت آهنگ.
.TP
\f[B]mpd_random\f[R]
وضعیت پخش تصادفی (روشن/خاموش - On/Off).
.TP
\f[B]mpd_repeat\f[R]
وضعیت تکرار (روشن/خاموش - On/Off).
.TP
\f[B]mpd_smart\f[R] \f[B](max length)\f[R]
نام آهنگ را بسته به اطلاعات موجود، به شکل \(lqartist \- title\(rq یا نام
فایل چاپ می‌کند.
.TP
\f[B]mpd_status\f[R]
در حال پخش، متوقف‌شده، و غیره.
.TP
\f[B]mpd_title\f[R] \f[B](max length)\f[R]
عنوان آهنگ جاری در MPD.
.TP
\f[B]mpd_track\f[R]
فیلد ترک (شماره آهنگ) را در MPD چاپ می‌کند.
.TP
\f[B]mpd_vol\f[R]
میزان بلندی صدای MPD.
.TP
\f[B]mysql\f[R] \f[B]query\f[R]
اولین فیلد از نخستین ردیف نتیجه کوئری را نشان می‌دهد.
.TP
\f[B]nameserver\f[R] \f[B](index)\f[R]
یک سرور نام دامنه (nameserver) را از /etc/resolv.conf چاپ می‌کند.
.TP
\f[B]new_mails\f[R] \f[B](mailbox) (interval)\f[R]
تعداد نامه‌های خوانده‌نشده در صندوق پستی مشخص‌شده یا در صورت تعیین نشدن، در mail spool.
هر دو نوع صندوق پستی mbox و maildir پشتیبانی می‌شوند.
.TP
\f[B]no_update\f[R] \f[B]text\f[R]
متن را نمایش داده و متغیرهای درون آن را پردازش می‌کند، اما آن‌ها را به‌روزرسانی نمی‌کند.
از این قابلیت برای مواردی استفاده کنید که در طول اجرای conky تغییر نمی‌کنند، مانند
$machine ،$conky_version و...\&
با به‌روزرسانی نکردن این موارد می‌توانید در مصرف منابع صرفه‌جویی کنید.
.TP
\f[B]nodename\f[R]
نام هاست (Hostname).
.TP
\f[B]nodename_short\f[R]
نام کوتاه هاست (مشابه دستور شل `hostname \-s').
.TP
\f[B]nvidia\f[R] \f[B]argument (GPU_ID)\f[R]
اطلاعات کارت گرافیک Nvidia از طریق کتابخانه XNVCtrl یا کتابخانه
NVML.
.RS
.PP
دماها به‌صورت اعشاری (float) و سایر مقادیر به‌صورت عدد صحیح چاپ می‌شوند.
.PP
\f[B]GPU_ID:\f[R] پارامتر اختیاری برای انتخاب GPU مورد استفاده به‌صورت
0,1,2,3,..
پارامتر پیش‌فرض 0 است
.PP
\f[B]آرگومان‌های ممکن:\f[R]
.PP
.TS
tab(@);
lw(12.4n) lw(8.1n) lw(40.3n) lw(5.6n) lw(3.7n).
T{
آرگومان
T}@T{
نام مستعار
T}@T{
توضیحات
T}@T{
XNVCtrl
T}@T{
NVML
T}
_
T{
\f[CR]gputemp\f[R]
T}@T{
\f[CR]temp\f[R]
T}@T{
دمای پردازنده گرافیکی (GPU)
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]gputempthreshold\f[R]
T}@T{
\f[CR]threshold\f[R]
T}@T{
آستانه دمایی که در آن پردازنده گرافیکی فرکانس کاری (کلاک) خود را کاهش می‌دهد
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]ambienttemp\f[R]
T}@T{
\f[CR]ambient\f[R]
T}@T{
دمای محیط پیرامون کارت گرافیک
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]gpufreqcur\f[R]
T}@T{
\f[CR]gpufreq\f[R]
T}@T{
فرکانس کاری (کلاک) فعلی GPU
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]gpufreqmin\f[R]
T}@T{
T}@T{
حداقل فرکانس کاری GPU
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]gpufreqmax\f[R]
T}@T{
T}@T{
حداکثر فرکانس کاری GPU
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]memfreqcur\f[R]
T}@T{
\f[CR]memfreq\f[R]
T}@T{
فرکانس کاری فعلی حافظه
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]memfreqmin\f[R]
T}@T{
T}@T{
حداقل فرکانس کاری حافظه
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]memfreqmax\f[R]
T}@T{
T}@T{
حداکثر فرکانس کاری حافظه
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]mtrfreqcur\f[R]
T}@T{
\f[CR]mtrfreq\f[R]
T}@T{
فرکانس کاری فعلی نرخ انتقال داده حافظه
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]mtrfreqmin\f[R]
T}@T{
T}@T{
حداقل فرکانس کاری نرخ انتقال داده حافظه
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]mtrfreqmax\f[R]
T}@T{
T}@T{
حداکثر فرکانس کاری نرخ انتقال داده حافظه
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]perflevelcur\f[R]
T}@T{
\f[CR]perflevel\f[R]
T}@T{
سطح عملکرد (کارایی) فعلی
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]perflevelmin\f[R]
T}@T{
T}@T{
پایین‌ترین سطح عملکرد
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]perflevelmax\f[R]
T}@T{
T}@T{
بالاترین سطح عملکرد
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]perfmode\f[R]
T}@T{
T}@T{
حالت عملکرد (Performance mode)
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]gpuutil\f[R]
T}@T{
T}@T{
درصد استفاده از پردازنده گرافیکی (GPU)
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]membwutil\f[R]
T}@T{
T}@T{
درصد استفاده از پهنای باند حافظه
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]videoutil\f[R]
T}@T{
T}@T{
درصد استفاده از موتور ویدیویی
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]pcieutil\f[R]
T}@T{
T}@T{
درصد استفاده از پهنای باند PCIe
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]memused\f[R]
T}@T{
\f[CR]mem\f[R]
T}@T{
میزان حافظه مصرف‌شده
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]memfree\f[R]
T}@T{
\f[CR]memavail\f[R]
T}@T{
میزان حافظه آزاد
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]memmax\f[R]
T}@T{
\f[CR]memtotal\f[R]
T}@T{
کل میزان حافظه
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]memutil\f[R]
T}@T{
\f[CR]memperc\f[R]
T}@T{
درصد استفاده از حافظه
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]fanspeed\f[R]
T}@T{
T}@T{
سرعت فن
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]fanlevel\f[R]
T}@T{
T}@T{
درصد سطح فن
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]imagequality\f[R]
T}@T{
T}@T{
کیفیت تصویر
T}@T{
✅
T}@T{
❌
T}
T{
\f[CR]modelname\f[R]
T}@T{
T}@T{
نام مدل کارت گرافیک
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]driverversion\f[R]
T}@T{
T}@T{
نسخه درایور
T}@T{
✅
T}@T{
✅
T}
T{
\f[CR]arch\f[R]
T}@T{
T}@T{
نام معماری پردازنده گرافیکی (GPU)
T}@T{
❌
T}@T{
✅
T}
T{
\f[CR]powerlimit\f[R]
T}@T{
T}@T{
محدودیت توان مصرفی برحسب وات
T}@T{
❌
T}@T{
✅
T}
T{
\f[CR]powerinstant\f[R]
T}@T{
T}@T{
توان مصرفی لحظه‌ای برحسب وات
T}@T{
❌
T}@T{
✅
T}
T{
\f[CR]poweravg\f[R]
T}@T{
T}@T{
میانگین توان مصرفی طی یک ثانیه برحسب وات
T}@T{
❌
T}@T{
✅
T}
.TE
.RE
.TP
\f[B]nvidiabar\f[R] \f[B](height),(width) argument (GPU_ID)\f[R]
مشابه با nvidia، با این تفاوت که خروجی را در یک نوار افقی رسم می‌کند.
پارامترهای ارتفاع و عرض اختیاری هستند و به ترتیب مقادیر پیش‌فرض
تنظیمات پیکربندی default_bar_height و default_bar_width را می‌گیرند.
.RS
.PP
\f[B]GPU_ID:\f[R] پارامتر اختیاری برای انتخاب پردازنده گرافیکی (GPU) مورد استفاده به‌صورت
0,1,2,3,..
پارامتر پیش‌فرض 0 است.
.PP
\f[B]توجه داشته باشید که آرگومان‌های زیر\f[R] ناسازگار هستند:
.IP \(bu 2
\f[CR]gputempthreshold\f[R] (\f[CR]threshold\f[R])
.IP \(bu 2
\f[CR]gpufreqmin\f[R]
.IP \(bu 2
\f[CR]gpufreqmax\f[R]
.IP \(bu 2
\f[CR]memfreqmin\f[R]
.IP \(bu 2
\f[CR]memfreqmax\f[R]
.IP \(bu 2
\f[CR]mtrfreqmin\f[R]
.IP \(bu 2
\f[CR]mtrfreqmax\f[R]
.IP \(bu 2
\f[CR]perflevelmin\f[R]
.IP \(bu 2
\f[CR]perflevelmax\f[R]
.IP \(bu 2
\f[CR]perfmode\f[R]
.IP \(bu 2
\f[CR]memtotal\f[R] (\f[CR]memmax\f[R])
.IP \(bu 2
\f[CR]fanspeed\f[R]
.IP \(bu 2
\f[CR]powerlimit\f[R]
.RE
.TP
\f[B]nvidiagauge\f[R] \f[B](height),(width) argument (GPU_ID)\f[R]
مشابه با nvidiabar، با این تفاوت که یک عقربه دایره‌ای (بسیار شبیه به
سرعت‌سنج خودرو) رسم می‌کند.
پارامترهای ارتفاع و عرض اختیاری هستند و به ترتیب مقادیر پیش‌فرض
تنظیمات پیکربندی default_gauge_height و default_gauge_width را می‌گیرند.
.RS
.PP
\f[B]GPU_ID:\f[R] پارامتر اختیاری برای انتخاب پردازنده گرافیکی (GPU) مورد استفاده به‌صورت
0,1,2,3,..
پارامتر پیش‌فرض 0 است.
.PP
برای آرگومان‌های ممکن، nvidia و nvidiabar را ببینید.
.RE
.TP
\f[B]nvidiagraph\f[R] \f[B]argument (height),(width) (gradient color 1) (gradient color 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m) GPU_ID\f[R]
مشابه با nvidiabar، با این تفاوت که یک نمودار با پیمایش افقی است که مقادیر
0\-100 روی محور عمودی آن رسم می‌شوند.
پارامترهای ارتفاع و عرض اختیاری هستند و به ترتیب مقادیر پیش‌فرض
تنظیمات پیکربندی default_graph_height و default_graph_width را می‌گیرند.
.RS
.PP
\f[B]GPU_ID:\f[R] اختیاری نیست.
این پارامتر امکان انتخاب پردازنده گرافیکی مورد استفاده را به‌صورت 0,1,2,3,.. فراهم می‌کند.
.PP
برای آرگومان‌های ممکن، nvidia و nvidiabar را ببینید.
برای کسب اطلاعات بیشتر درباره گزینه‌های \-t \-l \-x \-y و رنگ‌های گرادیان،
execgraph را ببینید.
.RE
.TP
\f[B]offset\f[R] \f[B](pixels)\f[R]
جابه‌جایی متن به اندازه N پیکسل به جلو.
همچنین $voffset را ببینید.
.TP
\f[B]outlinecolor\f[R] \f[B](color)\f[R]
تغییر رنگ خط دور (outline).
.TP
\f[B]pa_card_active_profile\f[R]
پروفایل فعال کارت پیش‌فرض PulseAudio.
.TP
\f[B]pa_card_name\f[R]
نام کارت پیش‌فرض PulseAudio.
.TP
\f[B]pa_sink_active_port_description\f[R]
توضیحات درگاه فعال سینک (sink) پیش‌فرض PulseAudio.
.TP
\f[B]pa_sink_active_port_name\f[R]
نام درگاه فعال سینک (sink) پیش‌فرض PulseAudio.
.TP
\f[B]pa_sink_description\f[R]
توضیحات سینک (sink) پیش‌فرض PulseAudio.
.TP
\f[B]pa_sink_volume\f[R]
درصد حجم صدای سینک (sink) پیش‌فرض PulseAudio.
.TP
\f[B]pa_sink_volumebar\f[R]
نوار حجم صدای سینک (sink) پیش‌فرض PulseAudio.
.TP
\f[B]password\f[R] \f[B](length)\f[R]
تولید گذرواژه‌های تصادفی.
.TP
\f[B]pb_battery\f[R] \f[B]item\f[R]
در صورت اجرا روی Apple powerbook/ibook، اطلاعات وضعیت باتری را نمایش می‌دهد.
پارامتر item مشخص می‌کند چه اطلاعاتی نمایش داده شود.
دقیقاً باید یک مورد مشخص شود.
موارد معتبر عبارتند از:
.RS
.PP
.TS
tab(@);
lw(10.0n) lw(60.0n).
T{
مورد (Item)
T}@T{
توضیحات
T}
_
T{
\f[CR]status\f[R]
T}@T{
نمایش وضعیت شارژ کامل، در حال شارژ، در حال دشارژ (تخلیه) یا عدم وجود باتری
(کار با برق مستقیم AC).
T}
T{
\f[CR]percent\f[R]
T}@T{
نمایش درصد شارژ باتری در صورت شارژ شدن یا تخلیه شدن.
اگر باتری کاملاً شارژ شده باشد یا وجود نداشته باشد، چیزی نمایش داده نمی‌شود.
T}
T{
\f[CR]time\f[R]
T}@T{
نمایش زمان باقی‌مانده تا شارژ کامل یا تخلیه کامل باتری با نرخ فعلی.
اگر باتری وجود نداشته باشد یا موجود باشد اما کاملاً شارژ شده و در حال تخلیه نباشد، چیزی نمایش داده نمی‌شود.
T}
.TE
.RE
.TP
\f[B]pid_chroot\f[R] \f[B]pid\f[R]
پوشه‌ای که به عنوان پوشه ریشه توسط فرایند استفاده می‌شود (این مقدار برابر \(lq/\(rq خواهد بود مگر آنکه فرایند فراخوان سیستمی chroot را انجام داده باشد).
.TP
\f[B]pid_cmdline\f[R] \f[B]pid\f[R]
خط فرمانی که این فرایند با آن فراخوانی شده است.
.TP
\f[B]pid_cwd\f[R] \f[B]pid\f[R]
پوشه کاری جاری فرایند.
.TP
\f[B]pid_egid\f[R] \f[B]pid\f[R]
شناسه گروه موثر (effective gid) فرایند.
.TP
\f[B]pid_environ\f[R] \f[B]pid varname\f[R]
محتوای یک متغیر محیطی فرایند.
.TP
\f[B]pid_environ_list\f[R] \f[B]pid\f[R]
فهرست متغیرهای محیطی که برای فرایند قابل مشاهده هستند.
.TP
\f[B]pid_euid\f[R] \f[B]pid\f[R]
شناسه کاربر موثر (effective uid) فرایند.
.TP
\f[B]pid_exe\f[R] \f[B]pid\f[R]
مسیر دستور اجراشده که فرایند را آغاز کرده است.
.TP
\f[B]pid_fsgid\f[R] \f[B]pid\f[R]
شناسه گروه سیستم‌فایل (file system gid) فرایند.
.TP
\f[B]pid_fsuid\f[R] \f[B]pid\f[R]
شناسه کاربر سیستم‌فایل (file system uid) فرایند.
.TP
\f[B]pid_gid\f[R] \f[B]pid\f[R]
شناسه گروه واقعی (real gid) فرایند.
.TP
\f[B]pid_nice\f[R] \f[B]pid\f[R]
مقدار نایس (nice) فرایند.
.TP
\f[B]pid_openfiles\f[R] \f[B]pid\f[R]
فهرست پرونده‌هایی که فرایند باز نگه داشته است.
.TP
\f[B]pid_parent\f[R] \f[B]pid\f[R]
شناسه فرایند والد (parent pid) این فرایند.
.TP
\f[B]pid_priority\f[R] \f[B]pid\f[R]
اولویت فرایند (`priority' را در \(lqman 5 proc\(rq ببینید).
.TP
\f[B]pid_read\f[R] \f[B]pid\f[R]
تعداد کل بایت‌های خوانده‌شده توسط فرایند.
.TP
\f[B]pid_sgid\f[R] \f[B]pid\f[R]
شناسه گروه ذخیره‌شده (saved set gid) فرایند.
.TP
\f[B]pid_state\f[R] \f[B]pid\f[R]
وضعیت فرایند.
.TP
\f[B]pid_state_short\f[R] \f[B]pid\f[R]
یکی از نویسه‌های موجود در \(lqRSDZTW\(rq که نمایانگر وضعیت فرایند است؛
که در آن R در حال اجرا، S در خواب با انتظار با قابلیت وقفه، D در حال انتظار در خواب غیرقابل وقفه دیسک، Z زامبی، T ردیابی‌شده یا متوقف‌شده (با یک سیگنال) و W پیجینگ است.
.TP
\f[B]pid_stderr\f[R] \f[B]pid\f[R]
توصیف‌گر پرونده متصل به STDERR فرایند.
.TP
\f[B]pid_stdin\f[R] \f[B]pid\f[R]
توصیف‌گر پرونده متصل به STDIN فرایند.
.TP
\f[B]pid_stdout\f[R] \f[B]pid\f[R]
توصیف‌گر پرونده متصل به STDOUT فرایند.
.TP
\f[B]pid_suid\f[R] \f[B]pid\f[R]
شناسه کاربر ذخیره‌شده (saved set uid) فرایند.
.TP
\f[B]pid_thread_list\f[R] \f[B]pid\f[R]
فهرستی شامل شناسه‌های فرایند (PID) ریسمان‌های این فرایند.
.TP
\f[B]pid_threads\f[R] \f[B]pid\f[R]
تعداد ریسمان‌های موجود در فرایندی که شامل این ریسمان است.
.TP
\f[B]pid_time\f[R] \f[B]pid\f[R]
مجموع $pid_time_kernelmode و $pid_time_usermode.
.TP
\f[B]pid_time_kernelmode\f[R] \f[B]pid\f[R]
مدت زمانی که فرایند در حالت هسته (kernel mode) زمان‌بندی شده است بر حسب ثانیه.
.TP
\f[B]pid_time_usermode\f[R] \f[B]pid\f[R]
مدت زمانی که فرایند در حالت کاربر (user mode) زمان‌بندی شده است بر حسب ثانیه.
.TP
\f[B]pid_uid\f[R] \f[B]pid\f[R]
شناسه کاربر واقعی (real uid) فرایند.
.TP
\f[B]pid_vmdata\f[R] \f[B]pid\f[R]
اندازه بخش داده (data segment) فرایند.
.TP
\f[B]pid_vmexe\f[R] \f[B]pid\f[R]
اندازه بخش متن یا کد (text segment) فرایند.
.TP
\f[B]pid_vmhwm\f[R] \f[B]pid\f[R]
اوج اندازه مجموعه مقیم در حافظه (\(lqhigh water mark\(rq) فرایند.
.TP
\f[B]pid_vmlck\f[R] \f[B]pid\f[R]
اندازه حافظه قفل‌شده فرایند.
.TP
\f[B]pid_vmlib\f[R] \f[B]pid\f[R]
اندازه کد کتابخانه اشتراکی فرایند.
.TP
\f[B]pid_vmpeak\f[R] \f[B]pid\f[R]
اوج اندازه حافظه مجازی فرایند.
.TP
\f[B]pid_vmpte\f[R] \f[B]pid\f[R]
اندازه ورودی‌های جدول صفحه (PTE) فرایند.
.TP
\f[B]pid_vmrss\f[R] \f[B]pid\f[R]
اندازه مجموعه مقیم در حافظه (RSS) فرایند.
.TP
\f[B]pid_vmsize\f[R] \f[B]pid\f[R]
اندازه حافظه مجازی فرایند.
.TP
\f[B]pid_vmstk\f[R] \f[B]pid\f[R]
اندازه بخش پشته (stack segment) فرایند.
.TP
\f[B]pid_write\f[R] \f[B]pid\f[R]
تعداد کل بایت‌های نوشته‌شده توسط فرایند.
.TP
\f[B]platform\f[R] \f[B](dev) type n (factor offset)\f[R]
حسگر پلتفرم از sysfs (لینوکس 2.6).
در صورتی که تنها یک دستگاه پلتفرم دارید، پارامتر dev می‌تواند نادیده گرفته شود.
نوع پلتفرم (Platform type) یکی از مقادیر \f[CR]in\f[R] یا \f[CR]vol\f[R] به معنی ولتاژ؛
\f[CR]fan\f[R] به معنی فن؛ و \f[CR]temp\f[R] به معنی دما است.
پارامتر n شماره حسگر است.
مسیر \f[CR]/sys/bus/platform/devices/\f[R] را در رایانه محلی خود ببینید.
آرگومان‌های اختیاری \f[CR]factor\f[R] و \f[CR]offset\f[R] امکان پیش‌محاسبه ورودی خام را فراهم می‌کنند که به‌صورت زیر تغییر می‌یابد:
\f[CR]input = input * factor + offset\f[R].
توجه داشته باشید که آن‌ها باید به‌صورت مقادیر اعشاری داده شوند (یعنی حداقل شامل یک رقم اعشار باشند).
.TP
\f[B]platformbar\f[R] \f[B](height),(width) (dev) type n (factor offset)\f[R]
مشابه با platform، با این تفاوت که خوانش حسگر را در یک نوار افقی نمایش می‌دهد.
از factor و offset برای مقیاس‌بندی مقدار گزارش‌شده توسط platform به محدوده 0\-100 استفاده کنید.
مقادیر دما از قبل از میلی‌درجه تبدیل شده‌اند.
ارتفاع و عرض به ترتیب مقادیر پیش‌فرض default_bar_height و default_bar_width را می‌گیرند.
.TP
\f[B]pop3_unseen\f[R] \f[B](args)\f[R]
به‌طور پیش‌فرض تعداد پیام‌های دیده‌نشده در صندوق ورودی سراسری POP3 شما را نمایش می‌دهد.
می‌توانید با ارسال آرگومان‌ها به این شیء، صندوق‌های ورودی POP3 جداگانه را به‌طور مستقل تعریف کنید.
آرگومان‌ها عبارتند از: \(lqhost user pass [\-i interval (in seconds)] [\-p port]
[\-e `command'] [\-r retries]\(rq.
پورت پیش‌فرض 110، بازه زمانی پیش‌فرض 5 دقیقه، و تعداد پیش‌فرض تلاش‌های مجدد قبل از انصراف 5 است.
اگر گذرواژه به‌صورت \(cq*\(cq داده شود، هنگام شروع Conky از شما خواسته می‌شود گذرواژه را وارد کنید.
.TP
\f[B]pop3_used\f[R] \f[B](args)\f[R]
به‌طور پیش‌فرض مقدار فضای استفاده‌شده (بر حسب مبی‌بایت، 2\(ha20) در صندوق ورودی سراسری POP3 شما را نمایش می‌دهد.
می‌توانید با ارسال آرگومان‌ها به این شیء، صندوق‌های ورودی POP3 جداگانه را به‌طور مستقل تعریف کنید.
آرگومان‌ها عبارتند از: \(lqhost user pass [\-i interval (in seconds)] [\-p port]
[\-e `command'] [\-r retries]\(rq.
پورت پیش‌فرض 110، بازه زمانی پیش‌فرض 5 دقیقه، و تعداد پیش‌فرض تلاش‌های مجدد قبل از انصراف 5 است.
اگر گذرواژه به‌صورت \(cq*\(cq داده شود، هنگام شروع Conky از شما خواسته می‌شود گذرواژه را وارد کنید.
.TP
\f[B]processes\f[R]
تعداد کل فرایندها (در خواب و در حال اجرا).
.TP
\f[B]read_tcp\f[R] \f[B](host) port\f[R]
به یک درگاه (پورت) tcp در یک میزبان (پیش‌فرض localhost است) متصل می‌شود، تمام نویسه‌های موجود در آن لحظه را می‌خواند و آن‌ها را نشان می‌دهد.
.TP
\f[B]read_udp\f[R] \f[B](host) port\f[R]
به یک درگاه (پورت) udp در یک میزبان (پیش‌فرض localhost است) متصل می‌شود، تمام نویسه‌های موجود در آن لحظه را می‌خواند و آن‌ها را نشان می‌دهد.
.TP
\f[B]replied_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد نامه‌های علامت‌گذاری‌شده به عنوان پاسخ‌داده‌شده در صندوق پستی مشخص‌شده یا در صورت عدم تعیین، در mail spool.
تنها صندوق‌های پستی نوع maildir پشتیبانی می‌شوند، نوع mbox مقدار \-1 برمی‌گرداند.
.TP
\f[B]rss\f[R] \f[B]uri interval_in_seconds action (num_par (spaces_in_front))\f[R]
بارگیری و تجزیه فیدهای RSS.
بازه زمانی (interval) می‌تواند یک مقدار (ممیز شناور) بزرگ‌تر از 0 باشد.
کنش (action) می‌تواند یکی از موارد زیر باشد: feed_title، item_title (همراه با num par)، item_desc (همراه با num par) و item_titles (هنگام استفاده از این کنش و در صورت تعیین spaces_in_front، کانکی آن تعداد فاصله را در جلوی هر مورد قرار می‌دهد).
این شیء به‌صورت چندریسمانی (threaded) کار می‌کند و پس از ایجاد یک ریسمان، نمی‌توان آن را به‌طور صریح نابود کرد.
به ازای هر URI مشخص‌شده یک ریسمان اجرا خواهد شد.
می‌توانید از هر پروتکلی که Curl پشتیبانی می‌کند استفاده کنید.
.TP
\f[B]rstrip\f[R] \f[B]text\f[R]
تمام فاصله‌های خالی انتهایی را از ورودی حذف می‌کند.
.TP
\f[B]running_processes\f[R]
فرایندهای در حال اجرا (نه در حال خواب).
نیازمند لینوکس 2.6 است.
.TP
\f[B]running_threads\f[R]
تعداد ریسمان‌های در حال اجرا (قابل اجرا - runnable).
تنها در لینوکس.
.TP
\f[B]scroll\f[R] \f[B](direction) length (step) (interval) text\f[R]
پیمایش `text' به اندازه `step' نویسه به سمت چپ یا راست (تنظیم `direction' به `left' یا `right' یا `wait') در حالی که تعداد `length' نویسه به‌طور همزمان نمایش داده می‌شود.
متن می‌تواند شامل متغیرها نیز باشد.
مقدار `step' اختیاری است و در صورت عدم تنظیم، پیش‌فرض آن 1 است.
مقدار `direction' اختیاری است و در صورت عدم تنظیم، پیش‌فرض آن left است.
هنگامی که direction برابر `wait' باشد، متن به سمت چپ پیمایش می‌شود و در ابتدا و انتهای متن به اندازه `interval' تکرار درنگ می‌کند.
اگر یک متغیر در چندین خط خروجی تولید کند، آن خطوط پشت سر یکدیگر و با علامت `|' از هم جدا می‌شوند.
اگر رنگ متن (textcolor) را درون $scroll تغییر دهید، در انتهای $scroll به‌طور خودکار به مقدار قبلی خود بازمی‌گردد.
پایان و آغاز متن به تعداد `length' فاصله از یکدیگر جدا خواهند شد، مگر اینکه direction برابر `wait' باشد.
.TP
\f[B]seen_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد نامه‌های علامت‌گذاری‌شده به عنوان دیده‌شده در صندوق پستی مشخص‌شده یا در صورت عدم تعیین، در mail spool.
تنها صندوق‌های پستی نوع maildir پشتیبانی می‌شوند، نوع mbox مقدار \-1 برمی‌گرداند.
.TP
\f[B]shadecolor\f[R] \f[B](color)\f[R]
تغییر رنگ سایه (shading color).
.TP
\f[B]shmem\f[R]
میزان حافظه اشتراکی.
تنها در لینوکس.
.TP
\f[B]sip_status\f[R] \f[B](switch)\f[R]
اطلاعات مربوط به محافظت از یکپارچگی سیستم (System Integrity Protection یا SIP) در macOS را چاپ می‌کند.
اگر هیچ سوییچی داده نشود، وضعیت SIP را چاپ می‌کند (فعال / غیرفعال)، در غیر این صورت،
وضعیت ویژگی خاص SIP مربوط به سوییچ داده‌شده را چاپ می‌کند.
.RS
.PP
در زیر سوییچ‌های موجود نشان داده شده‌اند:
.PP
.TS
tab(@);
l l l.
T{
SWITCH
T}@T{
RESULT
T}@T{
STATUS
T}
_
T{
0
T}@T{
apple internal
T}@T{
YES/NO
T}
T{
1
T}@T{
forbid untrusted kexts
T}@T{
YES/NO
T}
T{
2
T}@T{
forbid task\-for\-pid
T}@T{
YES/NO
T}
T{
3
T}@T{
restrict filesystem
T}@T{
YES/NO
T}
T{
4
T}@T{
forbid kernel\-debugger
T}@T{
YES/NO
T}
T{
5
T}@T{
restrict dtrace
T}@T{
YES/NO
T}
T{
6
T}@T{
restrict nvram
T}@T{
YES/NO
T}
T{
7
T}@T{
forbid device\-configuration
T}@T{
YES/NO
T}
T{
8
T}@T{
forbid any\-recovery\-os
T}@T{
YES/NO
T}
T{
9
T}@T{
forbid user\-approved\-kexts
T}@T{
YES/NO
T}
.TE
.PP
آیا از پیکربندی پشتیبانی‌نشده استفاده می‌کند؟: اگر بله، عبارت \(lqunsupported configuration, beware!\(rq و در غیر این صورت \(lqconfiguration is ok\(rq را چاپ می‌کند.
.PP
کاربرد (USAGE):
.IP
.EX
$ conky \-t \(aq${sip_status}\(aq
# چاپ وضعیت SIP
$ conky \-t \(aq${sip_status 0}\(aq
# چاپ اینکه آیا apple\-internal مجاز است یا خیر؟ Yes یا No؟
.EE
.PP
نکات (NOTES):
.IP \(bu 2
برای تمامی نسخه‌های macOS در دسترس است (حتی نسخه‌های قبل از El Capitan که SIP برای اولین بار در آن معرفی شد)
.IP \(bu 2
در صورت اجرا روی نسخه‌های قبل از El Capitan، قابلیت SIP در دسترس نیست و در نتیجه فقط \(lqunsupported\(rq دریافت خواهید کرد.
.RE
.TP
\f[B]smapi\f[R] \f[B](ARGS)\f[R]
هنگام استفاده از smapi، محتوای دایرکتوری
\f[CR]/sys/devices/platform/smapi\f[R]
را نمایش می‌دهد.
شناسه‌های ARGS یا به‌صورت
\f[CR](FILENAME)\f[R]
یا
\f[CR]bat (INDEX) (FILENAME)\f[R]
هستند تا محتوای فایل‌های مربوطه نمایش داده شود.
این یک روش بسیار خام برای دسترسی به مقادیر smapi است.
در صورت در دسترس بودن، بهتر است به‌جای آن از یکی از متغیرهای smapi_* استفاده کنید.
.TP
\f[B]smapi_bat_bar\f[R] \f[B](INDEX),(height),(width)\f[R]
هنگام استفاده از smapi، ظرفیت باقی‌مانده باتری با شاخص INDEX را به‌صورت یک نوار نمایش می‌دهد.
.TP
\f[B]smapi_bat_perc\f[R] \f[B](INDEX)\f[R]
هنگام استفاده از smapi، ظرفیت باقی‌مانده باتری با شاخص INDEX را برحسب درصد نمایش می‌دهد.
این یک متغیر جداگانه است زیرا از گزینه پیکربندی `use_spacer' پشتیبانی می‌کند.
.TP
\f[B]smapi_bat_power\f[R] \f[B]INDEX\f[R]
هنگام استفاده از smapi، توان فعلی باتری با شاخص INDEX را برحسب وات نمایش می‌دهد.
این یک متغیر جداگانه است زیرا مقدار خوانده‌شده اصلی از mW تبدیل می‌شود.
علامت خروجی نشان‌دهنده وضعیت شارژ شدن (مثبت) یا تخلیه شارژ (منفی) است.
.TP
\f[B]smapi_bat_temp\f[R] \f[B]INDEX\f[R]
هنگام استفاده از smapi، دمای فعلی باتری با شاخص INDEX را برحسب درجه سلسیوس نمایش می‌دهد.
این یک متغیر جداگانه است زیرا مقدار خوانده‌شده اصلی از میلی‌درجه سلسیوس تبدیل می‌شود.
.TP
\f[B]sony_fanspeed\f[R]
در صورت فعال بودن پشتیبانی کرنل sony\-laptop، اطلاعات سرعت فن Sony VAIO را نمایش می‌دهد.
فقط در لینوکس.
.TP
\f[B]startcase\f[R] \f[B]text\f[R]
حرف اول هر کلمه را به حروف بزرگ تبدیل می‌کند.
.TP
\f[B]stippled_hr\f[R] \f[B](space) (height) (width)\f[R]
خط افقی نقطه‌چین (خط‌چین).
.TP
\f[B]stock\f[R] \f[B]symbol data\f[R]
داده‌های یک نماد سهام را نمایش می‌دهد.
داده‌های زیر پشتیبانی می‌شوند:
.RS
.PP
.TS
tab(@);
l l.
T{
نام
T}@T{
توضیحات
T}
_
T{
1ytp
T}@T{
قیمت هدف ۱ ساله
T}
T{
200ma
T}@T{
میانگین متحرک ۲۰۰ روزه
T}
T{
50ma
T}@T{
میانگین متحرک ۵۰ روزه
T}
T{
52weekhigh
T}@T{
T}
T{
52weeklow
T}@T{
T}
T{
52weekrange
T}@T{
T}
T{
adv
T}@T{
میانگین حجم روزانه
T}
T{
ag
T}@T{
سود سالانه‌شده
T}
T{
ahcrt
T}@T{
تغییر پس از ساعات کاری به صورت بلادرنگ
T}
T{
ask
T}@T{
T}
T{
askrt
T}@T{
نرخ پیشنهادی فروش (Ask) به صورت بلادرنگ
T}
T{
asksize
T}@T{
T}
T{
bid
T}@T{
T}
T{
bidrt
T}@T{
نرخ پیشنهادی خرید (Bid) به صورت بلادرنگ
T}
T{
bidsize
T}@T{
T}
T{
bookvalue
T}@T{
T}
T{
c200ma
T}@T{
تغییر نسبت به میانگین متحرک ۲۰۰ روزه
T}
T{
c50ma
T}@T{
تغییر نسبت به میانگین متحرک ۵۰ روزه
T}
T{
c52whigh
T}@T{
تغییر نسبت به بالاترین قیمت ۵۲ هفته
T}
T{
c52wlow
T}@T{
تغییر نسبت به پایین‌ترین قیمت ۵۲ هفته
T}
T{
change
T}@T{
T}
T{
changert
T}@T{
تغییر به صورت بلادرنگ
T}
T{
cip
T}@T{
درصد تغییر
T}
T{
commission
T}@T{
T}
T{
cprt
T}@T{
درصد تغییر به صورت بلادرنگ
T}
T{
dayshigh
T}@T{
T}
T{
dayslow
T}@T{
T}
T{
dpd
T}@T{
تاریخ پرداخت سود سهام
T}
T{
dr
T}@T{
دامنه نوسان روز
T}
T{
drrt
T}@T{
دامنه نوسان روز به صورت بلادرنگ
T}
T{
ds
T}@T{
سود تقسیمی به ازای هر سهم
T}
T{
dvc
T}@T{
تغییر ارزش روز
T}
T{
dvcrt
T}@T{
تغییر ارزش روز به صورت بلادرنگ
T}
T{
dy
T}@T{
بازدهی سود سهام
T}
T{
ebitda
T}@T{
T}
T{
edv
T}@T{
تاریخ بدون حق سود سهام (Ex\-Dividend)
T}
T{
ei
T}@T{
نشانگر خطا
T}
T{
epsecy
T}@T{
تخمین EPS سال جاری
T}
T{
epsenq
T}@T{
تخمین EPS سه‌ماهه آینده
T}
T{
epseny
T}@T{
تخمین EPS سال آینده
T}
T{
es
T}@T{
درآمد به ازای هر سهم (EPS)
T}
T{
floatshares
T}@T{
T}
T{
hg
T}@T{
سود دارایی‌ها
T}
T{
hgp
T}@T{
درصد سود دارایی‌ها
T}
T{
hgprt
T}@T{
درصد سود دارایی‌ها به صورت بلادرنگ
T}
T{
hgrt
T}@T{
سود دارایی‌ها به صورت بلادرنگ
T}
T{
hl
T}@T{
حد بالا
T}
T{
hv
T}@T{
ارزش دارایی‌ها
T}
T{
hvrt
T}@T{
ارزش دارایی‌ها به صورت بلادرنگ
T}
T{
ll
T}@T{
حد پایین
T}
T{
ltd
T}@T{
تاریخ آخرین معامله
T}
T{
ltp
T}@T{
قیمت آخرین معامله
T}
T{
lts
T}@T{
حجم آخرین معامله
T}
T{
ltt
T}@T{
زمان آخرین معامله
T}
T{
mc
T}@T{
ارزش کل بازار (Market Capitalization)
T}
T{
mcrt
T}@T{
ارزش بازار به صورت بلادرنگ
T}
T{
moreinfo
T}@T{
T}
T{
name
T}@T{
T}
T{
notes
T}@T{
T}
T{
obrt
T}@T{
دفتر سفارش‌ها به صورت بلادرنگ
T}
T{
open
T}@T{
T}
T{
pb
T}@T{
نسبت قیمت به ارزش دفتری (P/B)
T}
T{
pc
T}@T{
قیمت پایانی پیشین
T}
T{
pc200ma
T}@T{
درصد تغییر نسبت به میانگین متحرک ۲۰۰ روزه
T}
T{
pc50ma
T}@T{
درصد تغییر نسبت به میانگین متحرک ۵۰ روزه
T}
T{
pc52whigh
T}@T{
درصد تغییر نسبت به بالاترین قیمت ۵۲ هفته
T}
T{
pc52wlow
T}@T{
درصد تغییر نسبت به پایین‌ترین قیمت ۵۲ هفته
T}
T{
pegr
T}@T{
نسبت PEG
T}
T{
pepsecy
T}@T{
نسبت قیمت به تخمین EPS سال جاری
T}
T{
pepseny
T}@T{
نسبت قیمت به تخمین EPS سال آینده
T}
T{
per
T}@T{
نسبت P/E
T}
T{
perrt
T}@T{
نسبت P/E به صورت بلادرنگ
T}
T{
pricepaid
T}@T{
T}
T{
ps
T}@T{
نسبت قیمت به فروش (P/S)
T}
T{
se
T}@T{
بورس اوراق بهادار
T}
T{
sharesowned
T}@T{
T}
T{
shortratio
T}@T{
T}
T{
symbol
T}@T{
T}
T{
tradedate
T}@T{
T}
T{
tradelinks
T}@T{
T}
T{
tt
T}@T{
روند نماد (Ticker Trend)
T}
T{
volume
T}@T{
T}
.TE
.RE
.TP
\f[B]swap\f[R]
میزان حافظه مبادله (swap) در حال استفاده.
.TP
\f[B]swapbar\f[R] \f[B](height),(width)\f[R]
نواری که میزان حافظه مبادله در حال استفاده را نمایش می‌دهد.
.TP
\f[B]swapfree\f[R]
میزان حافظه مبادله آزاد.
.TP
\f[B]swapmax\f[R]
میزان کل حافظه مبادله.
.TP
\f[B]swapperc\f[R]
درصد حافظه مبادله در حال استفاده.
.TP
\f[B]sysctlbyname\f[R] \f[B](name)\f[R]
چاپ مقدار sysctl بر اساس نام.
فقط در FreeBSD.
.TP
\f[B]sysname\f[R]
نام سیستم، برای نمونه Linux.
.TP
\f[B]tab\f[R] \f[B](width, (start))\f[R]
یک تب با عرض مشخص‌شده، با شروع از ستون `start` قرار می‌دهد.
واحد هر دو آرگومان پیکسل است.
.TP
\f[B]tail\f[R] \f[B]logfile lines (next_check)\f[R]
نمایش N خط آخر پرونده متنی ارائه‌شده.
پرونده در هر به‌روزرسانی `next_check` بررسی می‌شود.
اگر next_check مشخص نشود، Conky به صورت پیش‌فرض از ۲ استفاده می‌کند.
حداکثر ۳۰ خط، یا تا زمانی که بافر متن پر شود، قابل نمایش است.
.TP
\f[B]tcp_ping\f[R] \f[B]host (port)\f[R]
تعداد میکروثانیه‌های لازم برای دریافت پاسخ پینگ به پورت tcp در `host` را نمایش می‌دهد.
آرگومان `port` اختیاری است و مقدار پیش‌فرض آن ۸۰ است.
این متغیر هم روی پورت‌های باز و هم روی پورت‌های بسته کار می‌کند، فقط مطمئن شوید که پورت پشت فایروال قرار نداشته باشد، در غیر این صورت پاسخ `down` دریافت خواهید کرد.
بهتر است به جای یک پورت باز، یک پورت بسته را آزمایش کنید، زیرا پاسخ سریع‌تری دریافت خواهید کرد.
.TP
\f[B]tcp_portmon\f[R] \f[B]port_begin port_end item (index)\f[R]
مانیتور پورت TCP (هم IPv6 و هم IPv4) برای پورت‌های محلی مشخص‌شده.
شماره پورت‌ها باید در محدوده ۱ تا ۶۵۵۳۵ باشند.
موارد معتبر عبارتند از:
.RS
.PP
.TS
tab(@);
l l.
T{
مورد
T}@T{
توضیحات
T}
_
T{
\f[CR]count\f[R]
T}@T{
تعداد کل اتصالات در محدوده
T}
T{
\f[CR]rip\f[R]
T}@T{
آدرس IP دوردست
T}
T{
\f[CR]rhost\f[R]
T}@T{
نام هاست دوردست
T}
T{
\f[CR]rport\f[R]
T}@T{
شماره پورت دوردست
T}
T{
\f[CR]rservice\f[R]
T}@T{
نام سرویس دوردست از \f[CR]/etc/services\f[R]
T}
T{
\f[CR]lip\f[R]
T}@T{
آدرس IP محلی
T}
T{
\f[CR]lhost\f[R]
T}@T{
نام هاست محلی
T}
T{
\f[CR]lport\f[R]
T}@T{
شماره پورت محلی
T}
T{
\f[CR]lservice\f[R]
T}@T{
نام سرویس محلی از \f[CR]/etc/services\f[R]
T}
.TE
.PP
اندیس اتصال دسترسی به هر اتصال را در مانیتور پورت فراهم می‌کند.
مانیتور اطلاعات را برای مقادیر اندیس از ۰ تا n\-1 اتصال بازمی‌گرداند.
مقادیر بزرگ‌تر از n\-1 نادیده گرفته می‌شوند.
برای مورد \f[CR]count\f[R]، اندیس اتصال باید حذف شود (ذکر نشود).
برای سایر موارد، وجود آن الزامی است.
.PP
مثال‌ها:
.PP
.TS
tab(@);
lw(21.3n) lw(48.7n).
T{
مثال
T}@T{
توضیحات
T}
_
T{
\f[CR]${tcp_portmon 6881 6999 count}\f[R]
T}@T{
تعداد اتصالات در محدوده پورت bittorrent را نمایش می‌دهد
T}
T{
\f[CR]${tcp_portmon 22 22 rip 0}\f[R]
T}@T{
آدرس IP هاست دوردست اولین اتصال sshd را نمایش می‌دهد
T}
T{
\f[CR]${tcp_portmon 22 22 rip 9}\f[R]
T}@T{
آدرس IP هاست دوردست دهمین اتصال sshd را نمایش می‌دهد
T}
T{
\f[CR]${tcp_portmon 1 1024 rhost 0}\f[R]
T}@T{
نام هاست دوردست اولین اتصال روی یک پورت مجاز/ممتاز (privileged) را نمایش می‌دهد
T}
T{
\f[CR]${tcp_portmon 1 1024 rport 4}\f[R]
T}@T{
پورت هاست دوردست پنجمین اتصال روی یک پورت مجاز/ممتاز را نمایش می‌دهد
T}
T{
\f[CR]${tcp_portmon 1 65535 lservice 14}\f[R]
T}@T{
نام سرویس محلی پانزدهمین اتصال در محدوده تمام پورت‌ها را نمایش می‌دهد
T}
.TE
.PP
توجه داشته باشید که متغیرهای مانیتور پورت که محدوده پورت یکسانی دارند در واقع به همان مانیتور اشاره می‌کنند، بنابراین ارجاعات متعدد به یک محدوده پورت واحد برای موارد و اندیس‌های مختلف همگی در درون برنامه از یک مانیتور استفاده می‌کنند.
به عبارت دیگر، برنامه از ایجاد مانیتورهای زائد و تکراری جلوگیری می‌کند.
.RE
.TP
\f[B]templateN\f[R] \f[B](arg1) (arg2) (arg3 \&...)\f[R]
محتوای متغیر پیکربندی templateN را (که در آن N مقداری بین ۰ و ۹ شامل خود آن‌ها است) ارزیابی کرده و جایگزینی‌ها را مطابق با آنچه در مستندات متغیر پیکربندی متناظر توضیح داده شده است اعمال می‌کند.
تعداد آرگومان‌ها اختیاری است، اما باید با بالاترین اندیس ارجاع‌شده در قالب مطابقت داشته باشد.
می‌توانید در هر آرگومان از همان دنباله‌های ویژه‌ای استفاده کنید که برای تعریف قالب معتبر هستند، برای نمونه جهت مجاز دانستن وجود فاصله در یک آرگومان.
همچنین تودرتوسازی ساده قالب‌ها به این روش امکان‌پذیر است.
.RS
.PP
در اینجا چند مثال از تعاریف قالب آورده شده است، توجه داشته باشید که آن‌ها به جای \f[CR]...\f[R] بین \f[CR][[ ... ]]\f[R] قرار می‌گیرند:
.IP
.EX
template0 = [[$12]]
template1 = [[1: ${fs_used 2} / ${fs_size 2}]]
template2 = [[1 2]]
.EE
.PP
فهرست زیر کاربرد نمونه‌ای از قالب‌های تعریف‌شده در بالا را با نحو معادل در زمان عدم استفاده از هیچ قالبی نشان می‌دهد:
.PP
.TS
tab(@);
lw(36.2n) lw(33.8n).
T{
با استفاده از قالب
T}@T{
همان بدون قالب
T}
_
T{
\f[CR]${template0 node name}\f[R]
T}@T{
\f[CR]$nodename\f[R]
T}
T{
\f[CR]${template1 root /}\f[R]
T}@T{
\f[CR]root: ${fs_free /} / ${fs_size /}\f[R]
T}
T{
\f[CR]${template1 ${template2 disk root} /}\f[R]
T}@T{
\f[CR]disk root: ${fs_free /} / ${fs_size /}\f[R]
T}
T{
\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em
T}@T{
\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em\(em
T}
.TE
.RE
.TP
\f[B]texeci\f[R] \f[B]interval command\f[R]
دستوری را در یک بازه زمانی درون یک ریسه اجرا کرده و خروجی را نمایش می‌دهد.
همانند $execi است، با این تفاوت که دستور درون یک ریسه اجرا می‌شود.
اگر اسکریپتی کند دارید، برای تداوم به‌روزرسانی Conky از این متغیر استفاده کنید.
باید بازه زمانی را کمی بیشتر از مدت‌زمان لازم برای اجرای اسکریپت خود در نظر بگیرید.
برای مثال، اگر اسکریپتی دارید که اجرای آن ۵ ثانیه طول می‌کشد، باید بازه زمانی را حداقل ۶ ثانیه قرار دهید.
همچنین $execi را ببینید.
این شیء هنگام نابودی، ریسه مربوطه را پاکسازی می‌کند، بنابراین می‌توان با اطمینان از آن به شکل تودرتو استفاده کرد، هرچند ممکن است در صورت استفاده به این شکل، رفتار مطلوب حاصل نشود.
.TP
\f[B]texecpi\f[R] \f[B]interval command\f[R]
همانند execpi است، با این تفاوت که دستور درون یک ریسه اجرا می‌شود.
.TP
\f[B]threads\f[R]
تعداد کل ریسه‌ها.
.TP
\f[B]time\f[R] \f[B](format)\f[R]
زمان محلی، برای دریافت اطلاعات بیشتر درباره قالب، \(lqman strftime\(rq را ببینید.
.TP
\f[B]to_bytes\f[R] \f[B]size\f[R]
اگر `size` عددی باشد که در ادامه آن یک واحد اندازه (kilobyte، mb، GiB و\&...) آمده باشد، آنگاه اندازه را به بایت تبدیل کرده و آن را بدون واحد نمایش می‌دهد، در غیر این صورت فقط `size` را نشان می‌دهد.
.TP
\f[B]top\f[R] \f[B]type num\f[R]
این متغیر آرگومان‌هایی را به فرم top (name) (number) دریافت می‌کند. اساساً فرآیندها از بیشترین به کمترین میزان مصرف CPU رتبه‌بندی می‌شوند، که همان چیزی است که (num) نشان می‌دهد.
انواع (type) عبارتند از: \(lqname\(rq، \(lqpid\(rq، \(lqcpu\(rq، \(lqmem\(rq، \(lqmem_res\(rq، \(lqmem_vsize\(rq، \(lqtime\(rq، \(lquid\(rq، \(lquser\(rq، \(lqio_perc\(rq، \(lqio_read\(rq و \(lqio_write\(rq.
حداکثر ۱۰ فرآیند قابل فهرست شدن هستند.
.TP
\f[B]top_io\f[R] \f[B]type num\f[R]
همانند top است، با این تفاوت که بر اساس میزان ورودی/خروجی (I/O) انجام‌شده توسط فرآیند در طول بازه به‌روزرسانی مرتب می‌شود.
.TP
\f[B]top_mem\f[R] \f[B]type num\f[R]
همانند top است، با این تفاوت که به جای cpu، بر اساس میزان مصرف حافظه مرتب می‌شود.
.TP
\f[B]top_time\f[R] \f[B]type num\f[R]
همانند top است، با این تفاوت که به جای مصرف فعلی CPU، بر اساس کل زمان صرف‌شده در CPU مرتب می‌شود.
.TP
\f[B]totaldown\f[R] \f[B](net)\f[R]
کل بارگیری (دانلود)، در لینوکس با معماری ۳۲ بیتی در ۴ گیگابایت سرریز می‌کند و به نظر نمی‌رسد راهی وجود داشته باشد تا بدانیم پیش از شروع conky چند بار این اتفاق افتاده است.
.TP
\f[B]totalup\f[R] \f[B](net)\f[R]
کل بارگذاری (آپلود)، این مقدار نیز ممکن است سرریز کند.
.TP
\f[B]trashed_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد نامه‌های علامت‌گذاری‌شده به عنوان زباله (trashed) در صندوق پستی مشخص‌شده، یا در صورت عدم تعیین در mail spool.
تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار \-1 را بازمی‌گرداند.
.TP
\f[B]tztime\f[R] \f[B](timezone (format))\f[R]
زمان محلی برای منطقه زمانی مشخص‌شده، برای کسب اطلاعات بیشتر درباره قالب، man strftime را ببینید.
آرگومان منطقه زمانی به شیوه‌ای مشابه متغیر محیطی TZ مشخص می‌شود.
برای راهنمایی، به /usr/share/zoneinfo نگاه کنید.
مانند US/Pacific، Europe/Zurich و غیره.
.TP
\f[B]uid_name\f[R] \f[B]uid\f[R]
نام کاربریِ کاربرِ دارای این uid.
.TP
\f[B]unflagged_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد نامه‌هایی که به عنوان نشانه‌دار (flagged) در صندوق پستی مشخص‌شده یا در صورت عدم تعیین در mail spool علامت‌گذاری نشده‌اند.
تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار \-1 را بازمی‌گرداند.
.TP
\f[B]unforwarded_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد نامه‌هایی که به عنوان بازفرستاده‌شده (forwarded) در صندوق پستی مشخص‌شده یا در صورت عدم تعیین در mail spool علامت‌گذاری نشده‌اند.
تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار \-1 را بازمی‌گرداند.
.TP
\f[B]unreplied_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد نامه‌هایی که به عنوان پاسخ‌داده‌شده (replied) در صندوق پستی مشخص‌شده یا در صورت عدم تعیین در mail spool علامت‌گذاری نشده‌اند.
تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار \-1 را بازمی‌گرداند.
.TP
\f[B]unseen_mails\f[R] \f[B](maildir) (interval)\f[R]
تعداد نامه‌های جدید یا دیده‌نشده در صندوق پستی مشخص‌شده یا در صورت عدم تعیین در mail spool.
تنها صندوق‌های پستی از نوع maildir پشتیبانی می‌شوند؛ نوع mbox مقدار \-1 را بازمی‌گرداند.
.TP
\f[B]updates\f[R] \f[B]Number of updates\f[R]
جهت اشکال‌زدایی.
.TP
\f[B]uppercase\f[R] \f[B]text\f[R]
همه حروف را به حروف بزرگ انگلیسی تبدیل می‌کند.
.TP
\f[B]upspeed\f[R] \f[B](net)\f[R]
سرعت بارگذاری (آپلود) در واحدهای مناسب IEC.
.TP
\f[B]upspeedf\f[R] \f[B](net)\f[R]
سرعت بارگذاری بر حسب KiB با یک رقم اعشار.
.TP
\f[B]upspeedgraph\f[R] \f[B](netdev) (height),(width) (gradient colour 1) (gradient colour 2) (scale) (\-t) (\-l) (\-x) (\-y) (\-m)\f[R]
نمودار سرعت بارگذاری، رنگ‌ها با فرمت هگزادسیمال، بدون علامت # تعریف می‌شوند.
اگر مقیاس (scale) غیر صفر باشد، حداکثر مقدار نمودار را (بر حسب بایت بر ثانیه) مشخص می‌کند.
هنگام استفاده از سوییچ `\-l` از یک مقیاس لگاریتمی (برای دیدن اعداد کوچک) استفاده می‌کند.
سوییچ `\-t` را برای استفاده از طیف دمایی دریافت می‌کند، که باعث می‌شود مقادیر طیف بسته به دامنه یک مقدار نموداریِ خاص تغییر کنند (امتحان کنید تا ببینید).
فلگ `\-x` محور x و `\-y` محور y نمودار را معکوس می‌کند.
فلگ `\-m` یک حداقل/کران پایین غیر صفر را تنظیم می‌کند و اطمینان می‌دهد که تمام مقادیر حداقل برابر با حداقل مشخص‌شده باشند (به جز صفر).
.TP
\f[B]uptime\f[R]
مدت زمان کارکرد سیستم (Uptime).
.TP
\f[B]uptime_short\f[R]
مدت زمان کارکرد سیستم در قالبی کوتاه‌تر.
.TP
\f[B]user_names\f[R]
فهرست کردن نام‌های کاربرانی که وارد سیستم شده‌اند.
.TP
\f[B]user_number\f[R]
تعداد کاربرانی که وارد سیستم شده‌اند.
.TP
\f[B]user_terms\f[R]
کنسول‌های در حال استفاده را فهرست می‌کند.
.TP
\f[B]user_time\f[R] \f[B]console\f[R]
فهرست می‌کند که کاربر برای کنسول داده‌شده چه مدت وارد سیستم بوده است.
.TP
\f[B]user_times\f[R]
مدت زمانی را که کاربران وارد سیستم بوده‌اند فهرست می‌کند.
.TP
\f[B]utime\f[R] \f[B](format)\f[R]
نمایش زمان به وقت هماهنگ جهانی (UTC).
.TP
\f[B]v6addrs\f[R] \f[B](\-n) (\-s) (interface)\f[R]
آدرس‌های IPv6 برای یک رابط شبکه، که در صورت تعیین \-n با netmask و در صورت تعیین \-s با دامنه (scope) دنبال می‌شود.
دامنه‌ها عبارتند از Global(G)، Host\-local(H)، Link\-local(L)، Site\-local(S)، Compat(C) و Unspecified(/).
فقط در لینوکس.
.TP
\f[B]version\f[R]
شماره نسخه گیت.
فقط در DragonFly.
.TP
\f[B]voffset\f[R] \f[B](pixels)\f[R]
تغییر آفست عمودی به اندازه N پیکسل.
مقادیر منفی باعث همپوشانی متن می‌شوند.
همچنین $offset را ببینید.
.TP
\f[B]voltage_mv\f[R] \f[B](n)\f[R]
ولتاژ پردازنده شماره n را بر حسب میلی‌ولت (mV) بازمی‌گرداند.
شمارش پردازنده‌ها از ۱ آغاز می‌شود.
.RS
.PP
پیش‌فرض: 1
.RE
.TP
\f[B]voltage_v\f[R] \f[B](n)\f[R]
ولتاژ پردازنده شماره n را بر حسب ولت (V) بازمی‌گرداند. شمارش پردازنده‌ها از ۱ آغاز می‌شود.
.RS
.PP
پیش‌فرض: 1
.RE
.TP
\f[B]wireless_ap\f[R] \f[B](net)\f[R]
آدرس MAC نقطه دسترسی بی‌سیم (Access Point).
فقط در لینوکس.
.TP
\f[B]wireless_bitrate\f[R] \f[B](net)\f[R]
نرخ بیت بی‌سیم (برای نمونه 11 Mb/s).
فقط در لینوکس.
.TP
\f[B]wireless_channel\f[R] \f[B](net)\f[R]
کانال WLAN که دستگاه `net` در آن در حال شنود است.
.TP
\f[B]wireless_essid\f[R] \f[B](net)\f[R]
شناسه ESSID نقطه دسترسی بی‌سیم.
فقط در لینوکس.
.TP
\f[B]wireless_freq\f[R] \f[B](net)\f[R]
فرکانسی که دستگاه `net` در آن در حال شنود است.
.TP
\f[B]wireless_link_bar\f[R] \f[B](net) (height),(width)\f[R]
نوار کیفیت پیوند بی‌سیم.
فقط در لینوکس.
.TP
\f[B]wireless_link_qual\f[R] \f[B](net)\f[R]
کیفیت پیوند بی‌سیم.
فقط در لینوکس.
.TP
\f[B]wireless_link_qual_max\f[R] \f[B](net)\f[R]
حداکثر مقدار کیفیت پیوند بی‌سیم.
فقط در لینوکس.
.TP
\f[B]wireless_link_qual_perc\f[R] \f[B](net)\f[R]
کیفیت پیوند بی‌سیم بر حسب درصد.
فقط در لینوکس.
.TP
\f[B]wireless_mode\f[R] \f[B](net)\f[R]
حالت بی‌سیم (Managed/Ad\-Hoc/Master).
فقط در لینوکس.
.TP
\f[B]words\f[R] \f[B]textfile\f[R]
تعداد کلمات موجود در پرونده داده‌شده را نمایش می‌دهد.
.TP
\f[B]xmms2_album\f[R]
نام آلبوم در آهنگ جاری XMMS2.
.TP
\f[B]xmms2_artist\f[R]
نام هنرمند در آهنگ جاری XMMS2.
.TP
\f[B]xmms2_bar\f[R] \f[B](height),(width)\f[R]
نوار پیشرفت پخش XMMS2.
.TP
\f[B]xmms2_bitrate\f[R]
نرخ بیت (Bitrate) آهنگ جاری.
.TP
\f[B]xmms2_comment\f[R]
توضیحات (کامنت) در آهنگ جاری XMMS2.
.TP
\f[B]xmms2_date\f[R]
تاریخ آهنگ را بازمی‌گرداند.
.TP
\f[B]xmms2_duration\f[R]
مدت زمان آهنگ جاری.
.TP
\f[B]xmms2_elapsed\f[R]
زمان سپری‌شده از آهنگ.
.TP
\f[B]xmms2_genre\f[R]
سبک (ژانر) در آهنگ جاری XMMS2.
.TP
\f[B]xmms2_id\f[R]
شناسه XMMS2 آهنگ جاری.
.TP
\f[B]xmms2_percent\f[R]
درصد پیشرفت پخش آهنگ.
.TP
\f[B]xmms2_playlist\f[R]
فهرست پخش (Playlist) برنامه XMMS2 را بازمی‌گرداند.
.TP
\f[B]xmms2_size\f[R]
اندازه پرونده آهنگ جاری.
.TP
\f[B]xmms2_smart\f[R]
نام آهنگ را بسته به اطلاعات موجود، به یکی از دو صورت \(lqartist \- title\(rq یا نام پرونده چاپ می‌کند.
.TP
\f[B]xmms2_status\f[R]
وضعیت XMMS2 (شامل Playing، Paused، Stopped، یا Disconnected).
.TP
\f[B]xmms2_timesplayed\f[R]
تعداد دفعاتی که یک آهنگ پخش شده است (احتمالاً).
.TP
\f[B]xmms2_title\f[R]
عنوان آهنگ در آهنگ جاری XMMS2.
.TP
\f[B]xmms2_tracknr\f[R]
شماره قطعه (Track) در آهنگ جاری XMMS2.
.TP
\f[B]xmms2_url\f[R]
مسیر کامل به آهنگ جاری.
.SH "رابط برنامه‌نویسی لوآ (LUA API)"
کانکی از یک رابط برنامه‌نویسی (API) لوآ پشتیبانی می‌کند و همچنین به همراه بایندینگ‌های لوآ برای برخی کتابخانه‌های کاربردی عرضه می‌شود.
توجه داشته باشید که این بایندینگ‌ها به tolua++ نیاز دارند.
.PP
برای استفاده از لوآ با کانکی، ابتدا مطمئن شوید که نسخه‌ای از کانکی با پشتیبانی فعال از لوآ را در اختیار دارید (دستور \f[CR]conky \-v\f[R] این موضوع را گزارش می‌دهد).
کانکی توابع و متغیرهای سراسری خاصی را تعریف می‌کند که می‌توان از طریق کدهای لوآ در حال اجرا در کانکی به آن‌ها دسترسی پیدا کرد.
اسکریپت‌ها ابتدا باید با استفاده از گزینه پیکربندی \f[CR]lua_load\f[R] بارگذاری شوند.
سپس می‌توانید توابع لوآ را از طریق \f[CR]$lua\f[R]، \f[CR]$lua_read\f[R] و قلاب‌های لوآ در کانکی فراخوانی کنید.
.PP
هنگام ایجاد اشیاء چندریسه‌ای (threaded) از طریق رابط برنامه‌نویسی لوآ دقت کنید.
اگر با هر تکرار یک ریسه ایجاد شود، ممکن است در نهایت با تعداد بسیار زیادی از ریسه‌های در حال اجرا مواجه شوید.
.PP
توجه: جهت سازگاری با قابلیت‌های خاصی در رابط برنامه‌نویسی کتابخانه Cairo، کانکی چند تابع اضافی را برای ایجاد ساختارهای مشخصی صادر (export) می‌کند.
این موارد در ادامه مستند شده‌اند.
.TP
\f[B]RsvgDimensionData:create()\f[R]
این متد را برای بازگرداندن یک ساختار جدید RsvgDimensionData فراخوانی کنید.
تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی Rsvg ارائه نشده است.
.RS
.PP
پس از فراخوانی این متد، باید از \f[CR]tolua.takeownership(rect)\f[R]
روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.
.RE
.TP
\f[B]RsvgDimensionData:destroy()\f[R]
این متد را برای آزادسازی حافظه تخصیص‌یافته توسط
\f[CR]RsvgDimensionData:create\f[R] فراخوانی کنید.
.RS
.PP
برای جلوگیری از آزادسازی دوگانه حافظه (double\-free)، باید پیش از فراخوانی این تابع،
دستور \f[CR]tolua.releaseownership(dd)\f[R] را فراخوانی کنید، البته فقط در صورتی که پیش‌تر
\f[CR]tolua.takeownership(dd)\f[R] را صدا زده باشید.
.RE
.TP
\f[B]RsvgDimensionData:get()\f[R]
مقادیر یک ساختار موجود RsvgDimensionData را دریافت می‌کند.
.TP
\f[B]RsvgDimensionData:set(x, y, width, height)\f[R]
مقادیر یک ساختار موجود RsvgDimensionData را تنظیم می‌کند.
.TP
\f[B]RsvgRectangle:create()\f[R]
این متد را برای بازگرداندن یک ساختار جدید RsvgRectangle فراخوانی کنید.
تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی Rsvg ارائه نشده است.
.RS
.PP
پس از فراخوانی این متد، باید از \f[CR]tolua.takeownership(rect)\f[R]
روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.
.RE
.TP
\f[B]RsvgRectangle:destroy()\f[R]
این متد را برای آزادسازی حافظه تخصیص‌یافته توسط
\f[CR]RsvgRectangle:create\f[R] فراخوانی کنید.
.RS
.PP
برای جلوگیری از آزادسازی دوگانه حافظه (double\-free)، باید پیش از فراخوانی این تابع،
دستور \f[CR]tolua.releaseownership(rect)\f[R] را فراخوانی کنید، البته فقط در صورتی که پیش‌تر
\f[CR]tolua.takeownership(rect)\f[R] را صدا زده باشید.
.RE
.TP
\f[B]RsvgRectangle:get()\f[R]
مقادیر یک ساختار موجود RsvgRectangle را دریافت می‌کند.
.TP
\f[B]RsvgRectangle:set(x, y, width, height)\f[R]
مقادیر یک ساختار موجود RsvgRectangle را تنظیم می‌کند.
.TP
\f[B]cairo_font_extents_t:create()\f[R]
این تابع را برای بازگرداندن یک ساختار جدید cairo_font_extents_t فراخوانی کنید.
تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی cairo ارائه نشده است.
.RS
.PP
پس از فراخوانی این تابع، باید از \f[CR]tolua.takeownership(cfe)\f[R]
روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.
.RE
.TP
\f[B]cairo_font_extents_t:destroy(structure)\f[R]
این تابع را برای آزادسازی حافظه تخصیص‌یافته توسط
cairo_font_extents_t:create فراخوانی کنید.
.RS
.PP
برای جلوگیری از آزادسازی دوگانه حافظه (double\-free)، باید پیش از فراخوانی این تابع،
دستور \f[CR]tolua.releaseownership(cfe)\f[R] را فراخوانی کنید، البته فقط در صورتی که پیش‌تر
\f[CR]tolua.takeownership(cfe)\f[R] را صدا زده باشید.
.RE
.TP
\f[B]cairo_matrix_t:create()\f[R]
این تابع را برای بازگرداندن یک ساختار جدید cairo_matrix_t فراخوانی کنید.
تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی cairo ارائه نشده است.
.RS
.PP
پس از فراخوانی این تابع، باید از \f[CR]tolua.takeownership(cm)\f[R] روی
مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.
.RE
.TP
\f[B]cairo_matrix_t:destroy(structure)\f[R]
این تابع را برای آزادسازی حافظه تخصیص‌یافته توسط cairo_matrix_t:create فراخوانی کنید.
.RS
.PP
برای جلوگیری از آزادسازی دوگانه حافظه (double\-free)، باید پیش از فراخوانی این تابع،
دستور \f[CR]tolua.releaseownership(cm)\f[R] را فراخوانی کنید، البته فقط در صورتی که پیش‌تر
\f[CR]tolua.takeownership(cm)\f[R] را صدا زده باشید.
.RE
.TP
\f[B]cairo_place_image(file, cr, x, y, width, height, alpha)\f[R]
تصویری را با استفاده از imlib2 بر روی یک cairo_t رندر می‌کند.
در برخی موارد، استفاده از یک cairo_t و مختصات دقیق سودمندتر است.
.RS
.PP
.TS
tab(@);
lw(13.7n) lw(56.3n).
T{
آرگومان
T}@T{
توضیحات
T}
_
T{
file
T}@T{
مسیر تصویری که باید رندر شود.
T}
T{
cr
T}@T{
ساختار \f[CR]cairo_t\f[R] که رندر روی آن انجام می‌شود.
T}
T{
x,y
T}@T{
موقعیت رسم تصویر.
T}
T{
width, height
T}@T{
عرض و ارتفاع برای رسم تصویر.
T}
T{
alpha
T}@T{
میزان شفافیت تصویر؛ 1.0 کاملاً مات و 0.0 کاملاً شفاف است.
T}
.TE
.PP
دستور \f[CR]require(\(gacairo_imlib2_helper\(aq)\f[R] را در فایل لوآی خود وارد کنید.
.RE
.TP
\f[B]cairo_text_extents_t:create()\f[R]
این تابع را برای بازگرداندن یک ساختار جدید cairo_text_extents_t فراخوانی کنید.
تابعی برای ایجاد این ساختار توسط رابط برنامه‌نویسی cairo ارائه نشده است.
.RS
.PP
پس از فراخوانی این تابع، باید از \f[CR]tolua.takeownership(cte)\f[R]
روی مقدار بازگشتی استفاده کنید تا اطمینان حاصل شود که مالکیت به درستی منتقل شده است.
.RE
.TP
\f[B]cairo_text_extents_t:destroy(structure)\f[R]
این تابع را برای آزادسازی حافظه تخصیص‌یافته توسط
cairo_text_extents_t:create فراخوانی کنید.
.RS
.PP
برای جلوگیری از آزادسازی دوگانه حافظه (double\-free)، باید پیش از فراخوانی این تابع،
دستور \f[CR]tolua.releaseownership(cte)\f[R] را فراخوانی کنید، البته فقط در صورتی که پیش‌تر
\f[CR]tolua.takeownership(cte)\f[R] را صدا زده باشید.
.RE
.TP
\f[B]conky_build_arch\f[R]
رشته‌ای حاوی معماری ساخت این نمونه از کانکی.
.TP
\f[B]conky_build_info\f[R]
رشته‌ای حاوی اطلاعات ساخت این نمونه از کانکی، شامل نسخه، تاریخ ساخت و معماری.
.TP
\f[B]conky_config\f[R]
رشته‌ای حاوی مسیر فایل پیکربندی فعلی کانکی.
.TP
\f[B]conky_info\f[R]
این جدول حاوی اطلاعاتی درباره داده‌های داخلی کانکی است.
جدول زیر مقادیر موجود در آن را شرح می‌دهد:
.RS
.PP
.TS
tab(@);
l l.
T{
کلید
T}@T{
مقدار
T}
_
T{
update_interval
T}@T{
فاصله زمانی به‌روزرسانی کانکی (به ثانیه).
T}
.TE
.RE
.TP
\f[B]conky_parse(string)\f[R]
این تابع رشته‌ای را دریافت می‌کند که مطابق با بخش TEXT کانکی ارزیابی می‌شود، و سپس رشته‌ای حاوی نتیجه را بازمی‌گرداند.
.TP
\f[B]conky_set_update_interval(number)\f[R]
فاصله زمانی به‌روزرسانی کانکی (به ثانیه) را روی `number' تنظیم می‌کند.
.TP
\f[B]conky_surface()\f[R]
ساختار \f[CR]cairo_surface_t\f[R] فعلی را برای خروجی نمایشگر فعال بازمی‌گرداند، یا اگر سطح گرافیکی در دسترس نباشد مقدار \f[CR]nil\f[R] برمی‌گرداند.
این روش، راهکار ترجیحی و مستقل از بک‌اند برای به‌دست آوردن سطح رسم جهت استفاده با Cairo است.
.RS
.PP
سطح بازگردانده‌شده فقط برای چرخه رسم فعلی معتبر است.
آن را در فریم‌های مختلف کَش (ذخیره) نکنید؛ هر بار که قلاب رسم شما فراخوانی می‌شود، تابع \f[CR]conky_surface()\f[R] را فراخوانی کنید.
.PP
نمونه استفاده:
.IP
.EX
require(\(aqcairo\(aq)
\f[B]function\f[R] conky_draw()
  \f[B]local\f[R] surface = conky_surface()
  \f[B]if\f[R] \f[B]not\f[R] surface \f[B]then\f[R] \f[B]return\f[R] \f[B]end\f[R]
  \f[B]local\f[R] cr = cairo_create(surface)
  \f[I]\-\- draw ...\f[R]
  cairo_destroy(cr)
\f[B]end\f[R]
.EE
.RE
.TP
\f[B]conky_version\f[R]
رشته‌ای حاوی نسخه نمونه فعلی کانکی.
.TP
\f[B]conky_window\f[R]
این جدول شامل اطلاعات فقط‌خواندنی درباره پنجره کانکی است.
جدول زیر مقادیر موجود را شرح می‌دهد:
.RS
.PP
.TS
tab(@);
lw(14.4n) lw(55.6n).
T{
کلید
T}@T{
مقدار
T}
_
T{
drawable
T}@T{
\f[B]منسوخ شده.\f[R] شیء ترسیم‌پذیر پنجره (Xlib Drawable).
به جای آن از \f[CR]conky_surface()\f[R] استفاده کنید.
T}
T{
visual
T}@T{
\f[B]منسوخ شده.\f[R] ساختار دیداری پنجره (Xlib Visual).
به جای آن از \f[CR]conky_surface()\f[R] استفاده کنید.
T}
T{
display
T}@T{
\f[B]منسوخ شده.\f[R] نمایشگر پنجره (Xlib Display).
به جای آن از \f[CR]conky_surface()\f[R] استفاده کنید.
T}
T{
width
T}@T{
عرض پنجره بر حسب نقاط چیدمان (pt؛ منطقی).
T}
T{
height
T}@T{
ارتفاع پنجره بر حسب نقاط چیدمان (pt؛ منطقی).
T}
T{
pixel_size.x
T}@T{
عرض پنجره بر حسب پیکسل‌های دستگاه (px؛ فیزیکی).
T}
T{
pixel_size.y
T}@T{
ارتفاع پنجره بر حسب پیکسل‌های دستگاه (px؛ فیزیکی).
T}
T{
scale
T}@T{
ضریب مقیاس‌بندی بافر (dpi؛ نسبت pixel_size به size).
T}
T{
border_inner_margin
T}@T{
حاشیه درونی کادر پنجره (به پیکسل).
T}
T{
border_outer_margin
T}@T{
حاشیه بیرونی کادر پنجره (به پیکسل).
T}
T{
border_width
T}@T{
عرض کادر پنجره (به پیکسل).
T}
T{
text_start_x
T}@T{
مؤلفه x از مختصات شروع رسم متن.
T}
T{
text_start_y
T}@T{
مؤلفه y از مختصات شروع رسم متن.
T}
T{
text_width
T}@T{
عرض ناحیه رسم متن.
T}
T{
text_height
T}@T{
ارتفاع ناحیه رسم متن.
T}
.TE
.PP
نکته: این جدول فقط زمانی تعریف می‌شود که یک خروجی رابط کاربری گرافیکی (GUI) فعال باشد.
فیلدهای \f[CR]drawable\f[R]، \f[CR]visual\f[R] و \f[CR]display\f[R]
مختص X11 بوده و منسوخ شده‌اند.
.RE
.TP
\f[B]ret_scale_x,ret_scale_y:cairo_draw_image(file, cs, x, y, scale_x, scale_y)\f[R]
تصویری را با استفاده از imlib2 بر روی یک cairo_surface_t رندر می‌کند.
میزان مقیاس‌بندی اعمال‌شده روی تصویر را بازمی‌گرداند.
.RS
.PP
.TS
tab(@);
lw(13.7n) lw(56.3n).
T{
آرگومان
T}@T{
توضیحات
T}
_
T{
file
T}@T{
مسیر تصویری که باید رندر شود.
T}
T{
cs
T}@T{
ساختار \f[CR]cairo_surface_t\f[R] که رندر روی آن انجام می‌شود.
T}
T{
x,y
T}@T{
موقعیت رسم تصویر.
T}
T{
scale_x, scale_y
T}@T{
میزان مقیاس‌بندی تصویر؛ مقدار 1.0 بدون تغییر مقیاس، مقدار 2.0 برای دو
برابر اندازه و
T}
T{
T}@T{
0.5 برای نصف اندازه و غیره.
مقدار پیش‌فرض: بدون مقیاس‌بندی (1.0,1.0)
T}
.TE
.PP
دستور \f[CR]require(\(gacairo_imlib2_helper\(aq)\f[R] را در فایل لوآی خود وارد کنید.
.RE
.TP
\f[B]cairo_text_hp_show(cr, x, y, text, font, font_size, alignment, language, script, direction)\f[R]
متن را با استفاده از HarfBuzz و FreeType بر روی یک \f[CR]cairo_t\f[R] رندر می‌کند.
این روش رندر متن را بسیار باکیفیت‌تر از توابع داخلی Cairo انجام می‌دهد.
.RS
.PP
.TS
tab(@);
lw(13.7n) lw(56.3n).
T{
آرگومان
T}@T{
توضیحات
T}
_
T{
cr
T}@T{
ساختار \f[CR]cairo_t\f[R] که رندر روی آن انجام می‌شود.
T}
T{
x,y
T}@T{
موقعیت رسم متن.
T}
T{
text
T}@T{
متنی که باید رندر شود.
T}
T{
font
T}@T{
نام قلمی (فونتی) که باید استفاده شود؛ برای جستجوی قلم از \f[CR]Fontconfig\f[R]
استفاده می‌شود.
T}
T{
font_size
T}@T{
اندازه قلم (فونت).
T}
T{
alignment
T}@T{
یکی از مقادیر \f[CR]CAIRO_TEXT_ALIGN_LEFT\f[R]،
\f[CR]CAIRO_TEXT_ALIGN_RIGHT\f[R] یا
\f[CR]CAIRO_TEXT_ALIGN_CENTER\f[R]. مقدار پیش‌فرض:
\f[CR]CAIRO_TEXT_ALIGN_LEFT\f[R]
T}
T{
language
T}@T{
رشته‌ای حاوی برچسب زبان BCP 47. مقدار پیش‌فرض: \f[CR]en\f[R]
T}
T{
script
T}@T{
رشته‌ای حاوی برچسب خط ISO 15924. مقدار پیش‌فرض: تشخیص خودکار
از روی متن
T}
T{
direction
T}@T{
رشته‌ای نشان‌دهنده جهت متن مانند \f[CR]LTR\f[R]، \f[CR]RTL\f[R]
یا \f[CR]TTB\f[R]. مقدار پیش‌فرض: تشخیص خودکار از روی متن، در غیر این صورت
\f[CR]LTR\f[R]
T}
.TE
.RE
.TP
\f[B]width,height:cairo_text_hp_text_size(text, font, font_size, language, script, direction)\f[R]
برای محاسبه تعداد پیکسل‌های مورد نیاز برای رندر یک رشته با تابع
\f[CR]cairo_text_hp_show\f[R] استفاده می‌شود و یک جفت عدد صحیح شامل
\f[CR]width\f[R] و \f[CR]height\f[R] را بازمی‌گرداند.
.RS
.PP
.TS
tab(@);
lw(13.7n) lw(56.3n).
T{
آرگومان
T}@T{
توضیحات
T}
_
T{
cr
T}@T{
ساختار \f[CR]cairo_t\f[R] که رندر روی آن انجام می‌شود.
T}
T{
text
T}@T{
متنی که باید رندر شود.
T}
T{
font
T}@T{
نام قلمی (فونتی) که باید استفاده شود؛ برای جستجوی قلم از \f[CR]Fontconfig\f[R]
استفاده می‌شود.
T}
T{
font_size
T}@T{
اندازه قلم (فونت).
T}
T{
language
T}@T{
رشته‌ای حاوی برچسب زبان BCP 47. مقدار پیش‌فرض: \f[CR]en\f[R]
T}
T{
script
T}@T{
رشته‌ای حاوی برچسب خط ISO 15924. مقدار پیش‌فرض: تشخیص خودکار
از روی متن
T}
T{
direction
T}@T{
رشته‌ای نشان‌دهنده جهت متن مانند \f[CR]LTR\f[R]، \f[CR]RTL\f[R]
یا \f[CR]TTB\f[R]. مقدار پیش‌فرض: تشخیص خودکار از روی متن، در غیر این صورت
\f[CR]LTR\f[R]
T}
.TE
.RE
.TP
\f[B]cairo_text_hp_delete_fonts()\f[R]
هر دو تابع \f[CR]cairo_text_hp_show\f[R] و \f[CR]cairo_text_hp_text_size\f[R]
جزئیات داخلی قلم را کَش (ذخیره موقت) می‌کنند؛ این تابع آن حافظه‌های موقت را پاکسازی می‌کند.
.SH "مثالها (EXAMPLES)"
.TP
\f[B]conky \-t \(aq${time %D %H:%M}\(aq \-o \-u 30\f[R]
اجرای Conky در پنجره اختصاصی خود با نمایش تاریخ و ساعت به صورت متنی و بازه به‌روزرسانی ۳۰ ثانیه‌ای.
.TP
\f[B]conky \-a top_left \-x 5 \-y 500 \-d\f[R]
اجرای Conky در پس‌زمینه در مختصات (5, 500).
.TP
\f[B]conky \-C > \(ti/.config/conky/conky.conf\f[R]
برنامه Conky را اجرا نمی‌کند، بلکه فایل پیکربندی پیش‌فرض داخلی را در مسیر \f[I]\(ti/.config/conky/conky.conf\f[R] برای سفارشی‌سازی‌های بعدی خروجی می‌دهد.
.SH "فایلها (FILES)"
.TP
\f[I]${sysconfdir}/conky/conky.conf\f[R]
فایل پیکربندی پیش‌فرض سراسری سیستم.
مقدار ${sysconfdir} به گزینه‌های زمان کامپایل بستگی دارد (به احتمال زیاد /etc).
.TP
\f[I]\(ti/.config/conky/conky.conf\f[R]
فایل پیکربندی پیش‌فرض شخصی.
.SH "اشکالات (BUGS)"
رسم مستقیم روی پنجره ریشه (root) یا برخی پنجره‌های دیگر میزکار با تمام مدیرهای پنجره کار نمی‌کند.
به‌ویژه با Gnome به خوبی کار نمی‌کند و گزارش شده است که با KDE نیز کار نمی‌کند.
می‌توان از رسم Nautilus روی میزکار با برنامه gconf\-editor جلوگیری کرد.
گزینه show_desktop را در مسیر /apps/nautilus/preferences/ غیرفعال کنید.
در Conky سوییچ \f[B]\-w\f[R] برای تنظیم یک شناسه پنجره مشخص وجود دارد.
ممکن است دستور \f[B]xwininfo \-tree\f[R] برای یافتن پنجره‌ای که می‌خواهید روی آن رسم کنید مفید باشد.
همچنین می‌توانید از آرگومان \f[B]\-o\f[R] استفاده کنید که باعث می‌شود Conky پنجره اختصاصی خود را ایجاد کند.
اگر اجرای Conky در پنجره اختصاصی خود را امتحان می‌کنید، حتماً درباره تنظیمات own_window_type مطالعه کرده و آن را بیازمایید.
.SH "همچنین ببینید (SEE ALSO)"
\f[I]https://github.com/brndnmtthws/conky\f[R]
.SH "کپیرایت و تکثیر (COPYING)"
کپی‌رایت (c) 2005\-2026 Brenden Matthews، Philip Kovacs و دیگران.
هرگونه کد اصلی torsmo تحت مجوز BSD منتشر شده است (برای دریافت یک نسخه، فایل LICENSE.BSD را ببینید).
تمامی کدهای نوشته‌شده از زمان انشعاب (fork) torsmo تحت مجوز GPL منتشر شده‌اند (برای دریافت یک نسخه، فایل LICENSE.GPL را ببینید)، مگر در مواردی که به صورت متفاوت ذکر شده باشد (مانند کدهای portmon و audacious که تحت مجوز LGPL هستند، و prss که دارای مجوزی از نوع MIT است).
.SH "نویسندگان (AUTHORS)"
تیم توسعه Conky (برای مشاهده فهرست کامل مشارکت‌کنندگان فایل AUTHORS را ببینید).