.TH RDMA\-STATISTIC 8 "27 June 2019" "iproute2" "Linux"
.SH "نام (NAME)"
rdma-statistic \- مشاهده آمار دستگاه و پورتهای RDMA
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.ad l
.in +8
.ti -8
.B rdma
.RI "[ " OPTIONS " ]"
.B statistic
.RI  "{ " COMMAND " | "
.BR help " }"
.sp

.ti -8
.B rdma statistic
.RI "{ " OBJECT " }"
.B show

.ti -8
.B rdma statistic
.RI "[ " OBJECT " ]"
.B show link
.RI "[ " DEV/PORT_INDX " ]"
.RI "[ " FILTER_NAME " " FILTER_VALUE " ]"

.ti -8
.B rdma statistic
.IR OBJECT
.B mode

.ti -8
.B rdma statistic
.IR OBJECT
.B set
.IR COUNTER_SCOPE
.RI "[ " DEV/PORT_INDEX " ]"
.B auto
.RI "{ " CRITERIA " | "
.BR off " }"
.B [ optional-counters | on/off ]

.ti -8
.B rdma statistic
.IR OBJECT
.B bind
.IR COUNTER_SCOPE
.RI "[ " DEV/PORT_INDEX " ]"
.RI "[ " OBJECT-ID " ]"
.RI "[ " COUNTER-ID " ]"

.ti -8
.B rdma statistic
.IR OBJECT
.B unbind
.IR COUNTER_SCOPE
.RI "[ " DEV/PORT_INDEX " ]"
.RI "[ " COUNTER-ID " ]"
.RI "[ " OBJECT-ID " ]"

.ti -8
.B rdma statistic
.B mode
.B "[" supported "]"
.B link
.RI "[ " DEV/PORT_INDEX " ]"

.ti -8
.B rdma statistic
.B set
.B link
.RI "[ " DEV/PORT_INDEX " ]"
.B optional-counters
.RI "[ " OPTIONAL-COUNTERS " ]"

.ti -8
.B rdma statistic
.B unset
.B link
.RI "[ " DEV/PORT_INDEX " ]"
.B optional-counters

.ti -8
.IR COUNTER_SCOPE " := "
.RB "{ " link " | " dev " }"

.ti -8
.IR OBJECT " := "
.RB "{ " qp " | " mr " }"

.ti -8
.IR CRITERIA " := "
.RB "{ " type " | " pid " }"

.ti -8
.IR FILTER_NAME " := "
.RB "{ " cntn " | " lqpn " | " pid " | " qp-type " }"

.SH "توضیحات (DESCRIPTION)"
.SS "rdma statistic [object] show \- استعلام دستگاه RDMA مشخص‌شده برای آمار RDMA و آمار ویژه درایور. اگر شیء مشخص نشود شمارنده‌های سخت‌افزاری پیش‌فرض نمایش داده می‌شوند"

.PP
.I "DEV"
\- شمارنده‌های این دستگاه RDMA را برای نمایش مشخص می‌کند.

.I "PORT_INDEX"
\- شمارنده‌های این پورت RDMA را برای نمایش مشخص می‌کند.

.I "FILTER_NAME"
\- پالایه‌ای را برای نمایش تنها نتایج منطبق با آن مشخص می‌کند.

.SS "rdma statistic <object> set \- پیکربندی حالت خودکار شمارنده آمار برای یک دستگاه/پورت خاص"
در حالت خودکار تمام اشیائی که به یک دسته تعلق دارند به طور خودکار به یک مجموعه شمارنده متصل می‌شوند. مقدار "off" برای تمام حالت‌های خودکار به صورت سراسری عمل می‌کند. برای MRها قابل اعمال نیست.

.SS "rdma statistic <object> bind \- اتصال دستی یک شیء (مانند یک qp) به یک شمارنده"
هنگامی که متصل شود، آمار این شیء در این شمارنده در دسترس خواهد بود. برای MRها قابل اعمال نیست.

.SS "rdma statistic <object> unbind \- لغو اتصال دستی یک شیء (مانند یک qp) از شمارنده‌ای که قبلاً متصل شده بود"
هنگامی که اتصال لغو شود، آمار این شیء دیگر در این شمارنده در دسترس نخواهد بود؛ و اگر شناسه شیء مشخص نشود، اتصال تمام اشیاء موجود روی این شمارنده لغو خواهد شد. برای MRها قابل اعمال نیست.

.I "COUNTER-ID"
\- شناسه شمارنده‌ای که باید متصل شود را مشخص می‌کند.
اگر این آرگومان حذف شود، یک شمارنده جدید اختصاص داده خواهد شد.

.SS "rdma statistic mode \- نمایش شمارنده‌های اختیاری فعال‌شده برای هر پیوند."

.SS "rdma statistic mode supported \- نمایش شمارنده‌های اختیاری پشتیبانی‌شده برای هر پیوند."

.SS "rdma statistic set \- فعال‌سازی مجموعه‌ای از شمارنده‌های اختیاری برای یک دستگاه/پورت خاص."

.I "OPTIONAL-COUNTERS"
\- نام شمارنده‌های اختیاری را برای فعال‌سازی مشخص می‌کند. شمارنده‌های اختیاری که مشخص نشده باشند غیرفعال خواهند شد. توجه داشته باشید که شمارنده‌های اختیاری مختص درایور هستند.

.SS "rdma statistic unset \- غیرفعال‌سازی تمام شمارنده‌های اختیاری برای یک دستگاه/پورت خاص."

.SH "مثالها (EXAMPLES)"
.PP
rdma statistic show
.RS 4
وضعیت شمارنده پیش‌فرض تمام دستگاه‌های RDMA موجود در سیستم را نمایش می‌دهد.
.RE
.PP
rdma statistic show link mlx5_2/1
.RS 4
وضعیت شمارنده پیش‌فرض پورت RDMA مشخص‌شده را نمایش می‌دهد.
.RE
.PP
rdma statistic qp show
.RS 4
وضعیت تمام شمارنده‌های qp تمام دستگاه‌های RDMA موجود در سیستم را نمایش می‌دهد.
.RE
.PP
rdma statistic qp show link mlx5_2/1
.RS 4
وضعیت تمام شمارنده‌های qp پورت RDMA مشخص‌شده را نمایش می‌دهد.
.RE
.PP
rdma statistic qp show link mlx5_2 pid 30489
.RS 4
وضعیت تمام شمارنده‌های qp پورت RDMA مشخص‌شده که متعلق به pid 30489 هستند را نمایش می‌دهد.
.RE
.PP
rdma statistic qp show link mlx5_2 qp-type UD
.RS 4
وضعیت تمام شمارنده‌های qp پورت RDMA مشخص‌شده با نوع QP برابر با UD را نمایش می‌دهد.
.RE
.PP
rdma statistic qp mode
.RS 4
فهرست کردن حالت فعلی شمارنده در تمام دستگاه‌ها
.RE
.PP
rdma statistic qp mode link mlx5_2/1
.RS 4
فهرست کردن حالت فعلی شمارنده در پورت 1 دستگاه mlx5_2
.RE
.PP
rdma statistic qp set link mlx5_2/1 auto type on
.RS 4
در پورت 1 دستگاه mlx5_2، هر QP کاربری جدید را به صورت خودکار به یک شمارنده متصل می‌کند. برای QPهای با نوع qp یکسان، به ازای هر کدام یک شمارنده مجزا در نظر گرفته می‌شود.
.RE
.PP
rdma statistic qp set link mlx5_2/1 auto type on optional-counters on
.RS 4
در پورت 1 دستگاه mlx5_2، هر QP کاربری جدید را به صورت خودکار به یک شمارنده متصل می‌کند. برای QPهای با نوع qp یکسان، به ازای هر کدام یک شمارنده مجزا در نظر گرفته می‌شود؛ در حالی که شمارنده‌های اختیاری فعال فعلی را نیز متصل می‌کند.
.RE
.PP
rdma statistic qp set link mlx5_2/1 auto pid on
.RS 4
در پورت 1 دستگاه mlx5_2، هر QP کاربری جدید را به صورت خودکار به یک شمارنده متصل می‌کند. به ازای هر شمارنده برای QPهایی با pid یکسان.
.RE
.PP
rdma statistic qp set link mlx5_2/1 auto pid,type on
.RS 4
در پورت 1 دستگاه mlx5_2، هر QP کاربری جدید را به صورت خودکار به یک شمارنده متصل می‌کند. به ازای هر شمارنده برای QPهایی با pid یکسان و نوع یکسان.
.RE
.PP
rdma statistic qp set link mlx5_2/1 auto off
.RS 4
خاموش کردن حالت خودکار در پورت 1 دستگاه mlx5_2. شمارنده‌های تخصیص‌یافته را می‌توان به صورت دستی مورد دسترسی قرار داد.
.RE
.PP
rdma statistic qp bind link mlx5_2/1 lqpn 178
.RS 4
در پورت 1 دستگاه mlx5_2، یک شمارنده تخصیص می‌دهد و qp مشخص‌شده را به آن متصل می‌کند.
.RE
.PP
rdma statistic qp unbind link mlx5_2/1 cntn 4 lqpn 178
.RS 4
در پورت 1 دستگاه mlx5_2، اتصال qp مشخص‌شده را از شمارنده مشخص‌شده لغو می‌کند.
.RE
.PP
rdma statistic qp unbind link mlx5_2/1 cntn 4
.RS 4
در پورت 1 دستگاه mlx5_2، اتصال تمام QPهای موجود روی شمارنده مشخص‌شده را لغو می‌کند. پس از آن، این شمارنده به طور خودکار توسط هسته آزاد خواهد شد.
.RE
.PP
rdma statistic show mr
.RS 4
فهرست کردن تمام MRهای تخصیص‌یافته فعلی و شمارنده‌های آن‌ها.
.RE
.PP
rdma statistic show mr mrn 6
.RS 4
تخلیه و نمایش آمار یک MR خاص با mrn برابر 6. اگر وجود نداشته باشد چیزی نمایش داده نمی‌شود.
.RE
.PP
rdma statistic mode link mlx5_2/1
.RS 4
نمایش شمارنده‌های اختیاری که روی mlx5_2/1 فعال شده بودند.
.RE
.PP
rdma statistic mode supported link mlx5_2/1
.RS 4
نمایش شمارنده‌های اختیاری که mlx5_2/1 از آن‌ها پشتیبانی می‌کند.
.RE
.PP
rdma statistic set link mlx5_2/1 optional-counters cc_rx_ce_pkts,cc_rx_cnp_pkts
.RS 4
فعال‌سازی شمارنده‌های cc_rx_ce_pkts,cc_rx_cnp_pkts روی پورت 1 دستگاه mlx5_2.
.RE
.PP
rdma statistic unset link mlx5_2/1 optional-counters
.RS 4
غیرفعال‌سازی تمام شمارنده‌های اختیاری روی پورت 1 دستگاه mlx5_2.
.RE

.SH "همچنین ببینید (SEE ALSO)"
.BR rdma (8),
.BR rdma-dev (8),
.BR rdma-link (8),
.BR rdma-resource (8)
.br

.SH "نویسنده (AUTHOR)"
Mark Zhang <markz@mellanox.com>
.br
Erez Alfasi <ereza@mellanox.com>
.br
Neta Ostrovsky <netao@nvidia.com>