'\"macro stdmacro
.\"
.\" Copyright (c) 2021,2023 Red Hat.
.\"
.\" This program is free software; you can redistribute it and/or modify it
.\" under the terms of the GNU General Public License as published by the
.\" Free Software Foundation; either version 2 of the License, or (at your
.\" option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful, but
.\" WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
.\" or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
.\" for more details.
.\"
.\"
.TH PCP-SS 1 "PCP" "Performance Co-Pilot"
.SH "نام (NAME)"
pcp-ss \- گزارش آمار سوکت‌ها
.SH "خلاصه دستور (SYNOPSIS)"
\f3pcp\f1 [\f2گزینه‌های\ pcp\f1] \f3ss\f1 [\f2گزینه‌های\ ss\f1]
.SH "توضیحات (DESCRIPTION)"
دستور
.B pcp-ss
آمار سوکت‌های جمع‌آوری‌شده توسط کارگزار PMDA
.BR pmdasockets (1)
را گزارش می‌دهد.
این دستور طوری طراحی شده است که تا حد مناسبی با بسیاری از گزینه‌های خط فرمان و قالب‌های گزارش‌دهی
.BR ss (8)
سازگار باشد، اما در عین حال مزایای پایش محلی یا از راه دور (در حالت زنده) و
همچنین بازپخش پیشینه از یک بایگانی PCP از پیش ضبط‌شده را نیز ارائه دهد.
توجه داشته باشید از آنجا که
.BR ss (1)
دارای گزینه‌های خط فرمان متعددی است که بسیاری از آن‌ها با گزینه‌های استاندارد خط فرمان PCP شرح داده شده در
.BR PCPIntro (1)
یکسان هستند، ابزار
.B pcp-ss
باید همواره توسط کاربران با استفاده از پیشانهٔ (front-end)
.B pcp
فراخوانی شود.
این امر اجازه می‌دهد گزینه‌های استاندارد خط فرمان PCP مانند
.BR \-h ،
.BR \-a ،
.BR \-S ،
.BR \-T ،
.BR \-O ،
.BR \-z
و غیره بدون تداخل با گزینه‌های
.BR ss (1)
ارسال شوند.
برای نمونه‌های متداول کاربرد و خطوط فرمان، بخش
.B مثال‌ها (EXAMPLES)
در ادامه را ببینید.
.PP
حالت زنده (Live mode) از گزینهٔ
\fB\-h\fP \fIhost\fP
دستور
.B pcp
استفاده می‌کند و مستلزم آن است که PMDA مربوط به
.BR pmdasockets (1)
روی \fIhost\fP هدف (محلی یا از راه دور) نصب و فعال شده باشد؛ برای جزئیات در مورد نحوهٔ فعال‌سازی PMDA مربوط به \fBsockets\fP روی یک میزبان خاص،
.BR pmdasockets (1)
را ببینید.
اگر هیچ‌یک از گزینه‌های
.B \-h
یا
.B \-a
داده نشوند، منبع پیش‌فرض، معیارهای زندهٔ جمع‌آوری‌شده روی
.BR localhost
است.
.PP
بازپخش پیشینه/بایگانی از گزینهٔ
\fB\-a\fP \fIarchive\fP
دستور
.B pcp
استفاده می‌کند، که در آن \fIarchive\fP نام پایهٔ (basename) یک بایگانی PCP از پیش ضبط‌شده است.
ویژگی بازپخش بایگانی به‌ویژه از این جهت مفید است که آمار سوکت می‌تواند برای یک زمان مشخص با استفاده از گزینهٔ
.B \-\-origin
دستور
.B pcp
گزارش شود (که مقدار پیش‌فرض آن زمان شروع بایگانی است).
.SH "مثال‌ها (EXAMPLES)"
.TP 5
\fBpcp ss\fP
نمایش اطلاعات پایه و پیش‌فرض سوکت برای میزبان محلی.
این اطلاعات شامل \fBNetid\fP (\fBtcp\fP، \fBudp\fP و غیره)، \fBState\fP (\fBESTAB\fP،
\fBTIME_WAIT\fP و غیره)، طول صف‌های \fBRecv-Q\fP و \fBSend-Q\fP،
و نشانی محلی و همتا (peer) و درگاه (port) برای هر سوکت است.
.TP 5
\fBpcp \-h \fIsomehost\fP ss \-noemitauO\fP
نمایش همان اطلاعات پایهٔ سوکت بالا برای میزبان \fIsomehost\fP،
که ممکن است همان \fBlocalhost\fP پیش‌فرض باشد.
آرگومان‌های اضافی خط فرمان (\fB\-noemitauO\fP) این موارد را نمایش می‌دهند:
یک خط برای هر سوکت (\fB\-O\fP)، نام‌های عددی (\fB\-n\fP) سرویس‌ها (پیش‌فرض)،
اطلاعات زمان‌سنج (\fB\-o\fP)، جزئیات گسترش‌یافتهٔ سوکت (\fB\-e\fP)،
میزان مصرف حافظه سوکت (\fB\-m\fP)، اطلاعات داخلی TCP (\fB\-i\fP)،
هر دو سوکت‌های udp (\fB\-u\fP) و tcp (\fB\-t\fP)، و هر دو سوکت‌های شنونده (listening) و
غیرشنونده (\fB\-a\fP).
.TP 5
\fBpcp \-a \fIsomearchive\fP \fB-S'@Wed 16 Jun 2021 12:57:21'\fP ss \-noemitauO\fP
نمایش همان اطلاعات مثال بالا، اما برای بایگانی
\fIsomearchive\fP با شروع از زمان مشخص‌شدهٔ \fBWed 16 Jun 2021 12:57:21\fP.
توجه داشته باشید که پیشوند نویسه‌ای \fB@\fP برای زمان مطلق الزامی است؛ برای جزئیات،
.BR PCPIntro (1)
را ببینید.
بایگانی مسلماً باید شامل داده‌های زمان درخواستی باشد. می‌توانید برای بررسی کران‌های زمانی \fIsomearchive\fP از دستور
\fBpmlogdump \-l\fP \fIsomearchive\fP
استفاده کنید.
.TP 5
\fBpcp \-a \fIsomearchive\fP \fB\-O\-0\fP ss \-noemitauO\fP
همانند بالا، اما با آفست صفر ثانیه (\fB\-O\-0\fP) پیش از پایان فعلی
\fIsomearchive\fP، یعنی تازه‌ترین داده‌های ثبت‌شده در گزارش. توجه داشته باشید که ممکن است \fIsomearchive\fP
در حال حاضر در حال رشد باشد (یعنی داده‌ها با
.BR pmlogger (1)
در آن در حال ثبت باشند).
.SH "گزینه‌ها (OPTIONS)"
به دلیل تعداد زیاد گزینه‌های پشتیبانی‌شده توسط
.BR pcp-ss ،
جهت تعیین گزینه‌هایی نظیر منبع معیارها (میزبان یا بایگانی)
و همچنین (در حالت بایگانی) زمان شروع درخواستی یا آفست، و منطقه زمانی،
دستور
.BR pcp (1)
باید همواره برای فراخوانی
.B pcp-ss
با گزینه‌های زیر استفاده شود:
.TP 5
\fB\-h\fP, \fB\-\-host\fP
نام میزبان دوردست برای اتصال در حالت زنده.
.TP 5
\fB\-a\fP, \fB\-\-archive\fP
فایل بایگانی برای استفاده در نمونه‌برداری پیشینه.
.TP 5
\fB\-O\fP, \fB\-\-origin\fP
آفست زمانی برای استفاده درون یک بایگانی (به‌معنای استفاده از
.BR \-a
است).
.TP 5
\fB\-S\fP, \fB\-\-start\fP
زمان شروع (مثلاً در قالب
.BR ctime (3))
برای استفاده هنگام بازپخش یک بایگانی.
.TP 5
\fB\-Z\fP, \fB\-\-timezone\fP
استفاده از یک منطقه زمانی مشخص.
از آنجا که
.B pcp-ss
برچسب‌های زمانی را گزارش نمی‌کند، این مورد تنها بر تفسیر
زمان شروع مطلق (\fB\-S\fP) یا آفست (\fB\-O\fP) اثر می‌گذارد.
.TP 5
\fB\-z\fP, \fB\-\-hostzone\fP
در حالت بایگانی، استفاده از منطقه زمانی بایگانی به جای
منطقه زمانی سیستم محلی اجراکنندهٔ
.BR pcp-ss .
منطقه زمانی، و زمان‌های شروع و پایان بایگانی را می‌توان با استفاده از
.BR pmlogdump (1)
به همراه گزینهٔ \fB\-L\fP بررسی کرد.
.PP
گزینه‌های
.B pcp
فوق از طریق متغیرهای محیطی به‌طور غیرمستقیم در دسترس دستور
.B pcp-ss
قرار می‌گیرند \- برای شرح کامل این گزینه‌ها به
.BR PCPIntro (1)
مراجعه کنید.
.PP
گزینه‌های خط فرمان اضافی موجود برای خود
.B pcp-ss
عبارتند از:
.TP 5
\fB\-h\fP, \fB\-\-help\fP
نمایش پیام راهنما و خروج
.TP 5
\fB\-V\fP, \fB\-\-version\fP
نمایش اطلاعات نسخه
.TP 5
\fB\-n\fP, \fB\-\-numeric\fP
عدم حل (resolve) نام‌های سرویس (در حال حاضر همواره فعال است)
'\" .TP 5
'\" \fB\-r\fP, \fB\-\-resolve\fP
'\" حل نام‌های میزبان (هنوز پیاده‌سازی نشده است)
.TP 5
\fB\-a\fP, \fB\-\-all\fP
نمایش همهٔ سوکت‌ها
.TP 5
\fB\-l\fP, \fB\-\-listening\fP
نمایش سوکت‌های شنونده (listening)
.TP 5
\fB\-o\fP, \fB\-\-options\fP
نمایش اطلاعات زمان‌سنج (timer)
.TP 5
\fB\-e\fP, \fB\-\-extended\fP
نمایش اطلاعات تفصیلی سوکت
.TP 5
\fB\-m\fP, \fB\-\-memory\fP
نمایش میزان مصرف حافظه سوکت
'\" .TP 5
'\" \fB\-p\fP, \fB\-\-processes\fP
'\" نمایش فرایند استفاده‌کننده از سوکت
.TP 5
\fB\-i\fP, \fB\-\-info\fP
نمایش اطلاعات داخلی TCP
'\" .TP 5
'\" \fB\-s\fP, \fB\-\-summary\fP
'\" نمایش خلاصهٔ مصرف سوکت
'\" .TP 5
'\" \fB\-b\fP, \fB\-\-bpf\fP
'\" نمایش اطلاعات سوکت فیلتر bpf
'\" .TP 5
'\" \fB\-E\fP, \fB\-\-events\fP
'\" نمایش مداوم سوکت‌ها هم‌زمان با نابودی آن‌ها
'\" .TP 5
'\" \fB\-Z\fP, \fB\-\-context\fP
'\" نمایش زمینه‌های امنیتی SELinux فرایند
'\" .TP 5
'\" \fB\-z\fP, \fB\-\-contexts\fP
'\" نمایش زمینه‌های امنیتی SELinux فرایند و سوکت
'\" .TP 5
'\" \fB\-N\fP, \fB\-\-net\fP
'\" تغییر به نام فضای‌نام شبکه مشخص‌شده
.TP 5
\fB\-4\fP, \fB\-\-ipv4\fP
نمایش فقط سوکت‌های IP نسخه ۴
.TP 5
\fB\-6\fP, \fB\-\-ipv6\fP
نمایش فقط سوکت‌های IP نسخه ۶
'\" .TP 5
'\" \fB\-0\fP, \fB\-\-packet\fP
'\" نمایش سوکت‌های PACKET
.TP 5
\fB\-t\fP, \fB\-\-tcp\fP
نمایش فقط سوکت‌های TCP
'\" .TP 5
'\" \fB\-M\fP, \fB\-\-mptcp\fP
'\" نمایش فقط سوکت‌های MPTCP
'\" .TP 5
'\" \fB\-S\fP, \fB\-\-sctp\fP
'\" نمایش فقط سوکت‌های SCTP
.TP 5
\fB\-u\fP, \fB\-\-udp\fP
نمایش فقط سوکت‌های UDP
'\" .TP 5
'\" \fB\-d\fP, \fB\-\-dccp\fP
'\" نمایش فقط سوکت‌های DCCP
'\" .TP 5
'\" \fB\-w\fP, \fB\-\-raw\fP
'\" نمایش فقط سوکت‌های RAW
'\" .TP 5
'\" \fB\-x\fP, \fB\-\-unix\fP
'\" نمایش فقط سوکت‌های دامنه یونیکس (Unix domain)
.TP 5
\fB\-H\fP, \fB\-\-noheader\fP
عدم نمایش خط سربرگ (header)
.TP 5
\fB\-O\fP, \fB\-\-oneline\fP
چاپ داده‌های هر سوکت در یک خط واحد
.SH "گزارش (REPORT)"
ستون‌های موجود در گزارش
.B pcp-ss
بر اساس گزینه‌های خط فرمان متفاوت بوده و دارای همان
تفسیری هستند که در
.BR ss (8)
شرح داده شده است.
.PP
یک تفاوت در
.B pcp-ss
این است که خط نخست گزارش با «\fB# Timestamp\fP» آغاز می‌شود
و به دنبال آن برچسب زمانی (در منطقه زمانی درخواستی، \fB\-z\fP و \fB\-Z\fP در بالا را ببینید)
داده‌های نمونه از منبع میزبان یا بایگانی می‌آید.
پس از برچسب زمانی، رشتهٔ فیلتر فعال فعلی برای منبع معیارها قرار دارد.
در حالت بایگانی، فیلتر فعال را می‌توان به‌صورت پویا تغییر داد، حتی در زمانی که بایگانی
در حال ضبط شدن است.
این با
.BR ss (8)
متفاوت است، که در آن فیلتر به‌صورت اختیاری در خط فرمان ابزار مشخص می‌شود و
همواره «زنده» (live) است، یعنی
.BR ss (8)
از بازپخش گذشته‌نگر پشتیبانی نمی‌کند.
در
.BR pcp-ss ،
فیلتر در PMDA پسین (back-end) ذخیره می‌شود، ببینید
.BR pmdasockets (1)،
در معیار
.BR network.persocket.filter.
فیلتر پیش‌فرض \fBstate connected\fP است، که می‌توان با
ذخیره یک مقدار رشته‌ای جدید در معیار
.B network.persocket.filter
با استفاده از
.BR pmstore (1)
آن را تغییر داد؛ برای مثال:
\fBpmstore network.persocket.filter "state established"\fP.
این کار فیلتر پیش‌فرض پایدار را بازنویسی (override) می‌کند، که
در یک فایل پیکربندی PMDA ذخیره شده و با هر بار راه‌اندازی PMDA سوکت‌ها بارگیری می‌شود.
برای جزئیات بیشتر به
.BR pmdasockets (1)
و برای جزئیات ساختار نحو فیلتر و مثال‌ها به
.BR ss (8)
مراجعه کنید.
.SH "محیط PCP (PCP ENVIRONMENT)"
متغیرهای محیطی با پیشوند \fBPCP_\fP برای تعیین پارامترهای نام فایل‌ها و دایرکتوری‌های
مورد استفاده توسط PCP به کار می‌روند.
در هر بار نصب، فایل
\fI/etc/pcp.conf\fP
حاوی مقادیر محلی برای این متغیرها است.
متغیر \fB$PCP_CONF\fP ممکن است برای تعیین یک فایل پیکربندی
جایگزین استفاده شود، همان‌طور که در
\fBpcp.conf\fP(5)
توضیح داده شده است.
.PP
برای متغیرهای محیطی مؤثر بر ابزارهای PCP، به \fBpmGetOptions\fP(3) مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
.BR PCPIntro (1)،
.BR pcp (1)،
.BR pmdasockets (1)،
.BR pmlogger (1)،
.BR pcp.conf (5)
و
.BR ss (8).

.\" control lines for scripts/man-spell
.\" +ok+ somearchive commandline TIME_WAIT persocket
.\" +ok+ noemitauO {from command line option} somehost ESTAB Netid Recv Jun