.TH "PCP-HTOP" "5" "2026" "Performance Co-Pilot" "قالب‌های فایل" .SH "نام (NAME)" pcp-htop \- فایل پیکربندی pcp-htop .SH "توضیحات (DESCRIPTION)" .B pcp-htop یک ابزار سفارشی‌سازی‌پذیر برای گزارش‌گیری معیارهای عملکرد است. این ابزار دارای معماری پویایی است که در آن مجموعه‌ای از فایل‌های پیکربندی، سنجه‌ها و ستون‌های اختیاری و بیشتری را برای گسترش گزینه‌های نمایشیِ ثابت ارائه‌شده توسط .BR htop معمولی فراهم می‌کنند. .LP این فایل‌های پیکربندی می‌توانند هم از مکان‌های سراسری سیستم (نخست .I /etc/pcp/htop و سپس .IR /usr/share/pcp/htop ) و هم از زیرشاخه خانگی کاربر (معمولاً .IR ~/.config/htop ) بارگذاری شوند. درون این مسیرها، دایرکتوری‌های .I meters و .I columns برای مشخصات پویای سنجه‌ها و ستون‌ها پویش می‌شوند. .LP سنجه‌ها در بخش بالایی پنجره‌ی .B pcp-htop و ستون‌ها در بخش پایینی نمایش داده می‌شوند. سنجه‌ها تمایل به نمایش معیارهای سراسری سیستم دارند، و ستون‌ها معیارهای مربوط به هر فرایند را به‌طور جداگانه نمایش می‌دهند. .LP قالب‌ها مشابه هستند اما نیازمندی‌های کمی متفاوتی دارند. هر دو قالب از سبک رایج ini پیروی می‌کنند. خطوط خالی نادیده گرفته می‌شوند. خطوطی که با نویسه "#" آغاز می‌شوند به عنوان توضیح (کامنت) در نظر گرفته می‌شوند. .SH "سنجه‌ها (METERS)" در ادامه یک نمونه پیکربندی برای یک سنجه‌ی جدید Redis آورده شده است: .LP .ft CR .nf .in +0.5i [redisclient] caption = Redis clients type = bar blocked.metric = redis.blocked_clients blocked.color = blue blocked.label = blk clients.metric = redis.connected_clients clients.color = green clients.label = conn .in .fi .ft 1 .LP یک فایل پیکربندی می‌تواند شامل چندین تعریف سنجه باشد. هر تعریف با یک نام شناسایی درون قلاب آغاز می‌شود \- .I redisclient در این مثال. این نام به‌صورت داخلی درون .B pcp-htop استفاده می‌شود و باید یکتا باشد، با یک نویسه‌ی الفبایی آغاز شود و در ادامه تنها می‌تواند شامل نویسه‌های حرفی-عددی یا نویسه‌ی زیرخط (underscore) باشد. استفاده از فاصله خالی یا سایر نویسه‌ها مجاز نیست. .LP چندین پارامتر وجود دارند که نحوه نمایش سنجه را برای کاربر تعیین می‌کنند. .TP 5 .B caption این مقدار پس از انتخاب سنجه، در صفحه برپایی (Setup) نمایش داده می‌شود. همچنین نسخه کوتاه‌شده‌ای از .I caption (به همراه یک دونقطه بعد از آن) هنگام به‌روزرسانی سنجه در نمایشگر اصلی نشان داده خواهد شد. .TP .B description می‌توان از این گزینه برای ارائه جزئیات بیشتر در حین فرایند انتخاب سنجه در صفحه Setup استفاده کرد و در صورت وجود، در ستون "Available Meters" نمایش داده می‌شود. اگر مشخص نشده باشد، .B caption برای این منظور به کار می‌رود. اگر هیچ‌کدام وجود نداشته باشند، همان .B name داخلی (اجباری) استفاده خواهد شد. .TP .B type این تنظیم امکان مشخص کردن نوع پیش‌فرض ترجیحی سنجه را فراهم می‌کند. مقدار مربوطه باید یکی از .IR bar ، .IR text ، .IR graph یا .IR led باشد. اگر مقداری برای یک سنجه پویا تعیین نشود، مقدار پیش‌فرض .IR text استفاده خواهد شد. .TP .B maximum همچنین می‌توان یک مقدار عددی برای تعیین اندازه سنجه تنظیم کرد، به طوری که مقادیر (مثلاً برای نمایش سنجه از نوع .IR bar ) بین بازه صفر تا .IR maximum مقیاس‌بندی شوند. .LP سینتکس باقی‌مانده تعاریف، معیار(های) جداگانه‌ای را توصیف می‌کند که برای پویانمایی سنجه استفاده خواهند شد. برای هر سنجه باید یک یا چند معیار مشخص شود و چندین ویژگی به هر کدام اختصاص می‌یابد. مجدداً، این معیارها باید نام‌گذاری شوند (همان قواعد ذکر شده در بالا برای سنجه‌ها در اینجا نیز صدق می‌کند) و ویژگی‌های زیر قابل پیکربندی هستند: .TP 5 .B name.metric این تنها فیلد اجباری است و یک معیار PCP را به سنجه پیوند می‌دهد. مقادیر نمونه‌برداری‌شده برای هر معیار در زمان اجرا، پویانمایی قابل مشاهده در نمایشگر .B pcp-htop را فراهم می‌کنند. مشخصه معیار می‌تواند یک نام معیار PCP باشد همان‌گونه که توسط .BR pminfo (1) فهرست می‌شود، یا یک عبارت معیار «مشتق‌شده» (derived). قالب عبارات معیارهای مشتق‌شده در صفحه راهنمای .BR pmRegisterDerived (3) توضیح داده شده است. .TP .B name.color تنظیم رنگی که هنگام رندر کردن مقادیر معیار استفاده می‌شود. مقادیر ممکن عبارتند از: .IR red ، .IR green ، .IR blue ، .IR cyan ، .IR magenta ، .IR yellow ، .IR gray ، .I darkgray یا .IR white . .TP .B name.label یک برچسب اختیاری و کوتاه برای نمایش پیش از مقدار معیار. نویسه ":" قبل از بخش مقدار معیار در نمایشگر، به .I label اضافه خواهد شد. .TP .B name.suffix یک پسوند اختیاری و کوتاه برای نمایش پس از مقدار معیار. معمولاً برای نشان دادن مقادیر به صورت درصد با استفاده از مقدار "%" برای .I suffix و همچنین برای ارائه واحد اندازه‌گیری پایه استفاده می‌شود. توجه داشته باشید که از آنجا که PCP واحدها را برای معیارها نگهداری می‌کند، برای معیارهایی که دارای بعد «فضا» هستند (بایت، کیلوبایت، مگابایت و غیره)، یک پسوند به‌طور خودکار اضافه خواهد شد. .SH "ستون‌ها (COLUMNS)" در ادامه یک نمونه پیکربندی برای ستونی جدید آورده شده است که توصیف‌کننده‌های پرونده باز (open file descriptors) را برای هر فرایند نشان می‌دهد: .LP .ft CR .nf .in +0.5i [openfds] heading = FDS caption = FDCOUNT description = Open file descriptors metric = proc.fd.count width = 3 .in .fi .ft 1 .LP یک فایل پیکربندی می‌تواند شامل چندین تعریف ستون باشد. هر تعریف با یک نام شناسایی درون قلاب آغاز می‌شود \- .I openfds در این مثال، و همان قوانینی که در بالا برای نام سنجه‌ها ذکر شد در اینجا نیز اعمال می‌شود. .LP هر ستون باید یک معیار را مشخص کند. پارامترهای اختیاری نیز می‌توانند تنظیم شوند. .TP 5 .B metric همانند سنجه‌ها، مقدار معیار باید یا یک نام معیار PCP باشد (به‌گونه‌ای که توسط .BR pminfo (1) فهرست می‌شود) یا یک معیار مشتق‌شده. معیار باید یک دامنه نمونه (مجموعه‌ای از مقادیر) داشته باشد و آن دامنه نمونه باید به مجموعه‌ای از فرایندها با شناسه‌های فرایند (PID) به عنوان شناسه نمونه نگاشت شود. به‌طور معمول این معیارها از فضای‌نام‌های .I proc یا .I hotproc هستند (\c .BR pmdaproc (1))، اما معیارهای سایر دامنه‌ها (\c .BR pmdabpf (1) و غیره) که دارای مقادیر به ازای هر فرایند هستند نیز به همان اندازه قابل استفاده‌اند. .TP .B width عرض ستون برای استفاده هنگام نمایش مقادیر معیار. یک مقدار منفی می‌تواند برای مشخص کردن تراز از سمت چپ استفاده شود. حداکثر محدودیت ۲۸ نویسه برای عرض ستون اعمال می‌شود. عرض پیش‌فرض ستون ۵ نویسه است. .TP .B heading عنوان کوتاهی که در بالای ستون نمایش داده می‌شود \- معمولاً یک رشته کوتاه، رمزی و تماماً با حروف بزرگ. .TP .B caption یک کلمه شناسایی کوتاه که در صفحه Setup در هر دو فهرست Available Columns و Active Columns به کاربران نشان داده می‌شود. .TP .B description متنی که به کاربران کمک می‌کند تا معنای این ستون را هنگامی که در صفحه Setup در فهرست Available Columns ارائه می‌شود، درک کنند. .SH "همچنین ببینید (SEE ALSO)" .BR pcp-htop (1)، .BR pminfo (1)، .BR pmcd (1)، .BR pmdaproc (1)، .BR pmdabpf (1) و .BR pmRegisterDerived (3). .SH "نویسندگان (AUTHORS)" .B htop در ابتدا توسط Hisham Muhammad توسعه یافت. امروزه این ابزار توسط جامعه در نگهداری می‌شود. .LP .B pcp-htop به عنوان یک همکاری میان جوامع و نگهداری می‌شود و بخشی از مجموعه ابزارهای Performance Co-Pilot را تشکیل می‌دهد.