.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "fi_pingpong" "1" "2024\-12\-10" "Libfabric Programmer\[cq]s Manual" "Libfabric v2.6.0"
.hy
.SH "نام (NAME)"
.PP
fi_pingpong \- آزمون پینگ‌پنگ سریع و ساده برای libfabric
.SH "خلاصه دستور (SYNOPSIS)"
.IP
.nf
\f[C]
 fi_pingpong [OPTIONS]                      راه‌اندازی سرور
 fi_pingpong [OPTIONS] <server address>     اتصال به سرور
\f[R]
.fi
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار fi_pingpong یک آزمون پینگ‌پنگ برای سنجش ویژگی اصلی کتابخانه libfabric است: انتقال داده میان دو فرآیند.
همچنین fi_pingpong آمار تجمیعی را پس از هر بار اجرای آزمون نمایش می‌دهد و می‌تواند علاوه بر این، یکپارچگی داده‌ها را پس از دریافت اعتبارسنجی کند.
.PP
به‌طور پیش‌فرض، برای آزمون از نقطه پایانی (endpoint) دیتاگرام (FI_EP_DGRAM) استفاده می‌شود، مگر اینکه از طریق \f[V]-e\f[R] به‌گونه دیگری مشخص شده باشد.
.SH "نحوه اجرای آزمون‌ها (HOW TO RUN TESTS)"
.PP
باید دو نسخه از برنامه اجرا شود: ابتدا یک نسخه باید به عنوان سرور راه‌اندازی شود.
سپس، نسخه دیگری با مشخص کردن آدرس سرور اجرا می‌شود.
.PP
به عنوان یک آزمون کلاینت-سرور، هر یک از الگوی استفاده زیر پیروی می‌کنند:
.SS راه‌اندازی سرور
.IP
.nf
\f[C]
server$ fi_pingpong
\f[R]
.fi
.SS راه‌اندازی کلاینت
.IP
.nf
\f[C]
client$ fi_pingpong <server address>
\f[R]
.fi
.SH "گزینه‌ها (OPTIONS)"
.PP
برای عملکرد صحیح ابزار fi_pingpong، سرور و کلاینت باید بتوانند ارتباط مناسبی با یکدیگر برقرار کنند.
اگر از هر یک از گزینه‌های \f[V]-e\f[R]، \f[V]-I\f[R]، \f[V]-S\f[R] یا \f[V]-p\f[R] استفاده شود، این گزینه‌ها باید هنگام فراخوانی هر دو فرآیند سرور و کلاینت مشخص شوند.
اگر گزینه \f[V]-d\f[R] در سمت سرور مشخص شده باشد، چنانچه هیچ سرنخی در سمت کلاینت ارائه نشده باشد، کلاینت دامنه (domain) مناسب را انتخاب خواهد کرد.
اگر گزینه \f[V]-d\f[R] در سمت کلاینت مشخص شده باشد، باید در سمت سرور نیز مشخص شود.
اگر هر دو سمت سرور و کلاینت گزینه \f[V]-d\f[R] را مشخص کنند و دامنه‌های تعیین‌شده نتوانند ارتباط برقرار کنند، برنامه با خطا متوقف خواهد شد.
.SS پیام‌رسانی کنترلی (Control Messaging)
.TP
\f[I]-B <src_port>\f[R]
شماره پورت غیرپیش‌فرض مبدأ برای سوکت کنترلی.
اگر ارائه نشود، سرور به‌طور پیش‌فرض به پورت 47592 متصل می‌شود (bind) و کلاینت اجازه می‌دهد پورت به‌طور خودکار انتخاب شود.
.TP
\f[I]-P <dest_port>\f[R]
شماره پورت غیرپیش‌فرض مقصد برای سوکت کنترلی.
اگر ارائه نشود، کلاینت به‌طور پیش‌فرض به 47592 متصل خواهد شد.
سرور این گزینه را نادیده می‌گیرد.
.SS فیلترسازی فابریک (Fabric Filtering)
.TP
\f[I]-p <provider_name>\f[R]
نام ارائه‌دهنده فابریک زیرین (مانند sockets، psm3، usnic و غیره).
اگر ارائه‌دهنده‌ای از طریق سوئیچ -p مشخص نشود، آزمون یکی را از فهرست ارائه‌دهندگان در دسترس (همان‌طور که توسط fi_getinfo(3) برگردانده می‌شود) انتخاب خواهد کرد.
.TP
\f[I]-e <endpoint>\f[R]
نوع نقطه پایانی (endpoint) مورد استفاده برای پیام‌رسانی داده میان دو فرآیند.
مقادیر پشتیبانی‌شده عبارتند از dgram، rdm و msg.
برای اطلاعات بیشتر در مورد انواع endpoint، fi_endpoint(3) را ببینید.
.TP
\f[I]-d <domain>\f[R]
نام دامنه (domain) خاصی که باید استفاده شود.
.TP
\f[I]-s <source address>\f[R]
آدرس مربوط به دامنه متناظر.
در محیط‌های دارای چند آداپتور الزامی است.
.SS گزینه‌های آزمون (Test Options)
.TP
\f[I]-I <iter>\f[R]
تعداد دفعات تکرار اجرای آزمون.
.TP
\f[I]-S <msg_size>\f[R]
اندازه خاص پیام بر حسب بایت که در آزمون استفاده می‌شود، یا \(aqall\(aq برای اجرای تمام اندازه‌های پیش‌فرض.
.TP
\f[I]-c\f[R]
فعال‌سازی بررسی صحت داده‌ها در سمت گیرنده (توجه: این کار کارایی را کاهش می‌دهد).
.SS ابزار کاربردی (Utility)
.TP
\f[I]-v\f[R]
فعال‌سازی اشکال‌زدایی خروجی (هشدار: بسیار پرحجم و دارای جزئیات زیاد).
.TP
\f[I]-h\f[R]
نمایش خروجی راهنما برای آزمون پینگ‌پنگ.
.SH "مثال‌ها (EXAMPLES)"
.SS یک مثال ساده
.SS سرور: \f[V]fi_pingpong -p <provider_name>\f[R]
.PP
\f[V]server$ fi_pingpong -p sockets\f[R]
.SS کلاینت: \f[V]fi_pingpong -p <provider_name> <server_addr>\f[R]
.PP
\f[V]client$ fi_pingpong -p sockets 192.168.0.123\f[R]
.SS مثالی با گزینه‌های گوناگون
.SS سرور:
.PP
\f[V]server$ fi_pingpong -p usnic -I 1000 -S 1024\f[R]
.SS کلاینت:
.PP
\f[V]client$ fi_pingpong -p usnic -I 1000 -S 1024 192.168.0.123\f[R]
.PP
به‌طور مشخص، این دستور یک آزمون پینگ‌پنگ را با مشخصات زیر اجرا می‌کند:
.IP \[bu] 2
ارائه‌دهنده usNIC
.IP \[bu] 2
۱۰۰۰ تکرار
.IP \[bu] 2
اندازه پیام ۱۰۲۴ بایت
.IP \[bu] 2
گره سرور به نشانی 192.168.0.123
.SS یک آزمون طولانی‌تر
.SS سرور:
.PP
\f[V]server$ fi_pingpong -p usnic -I 10000 -S all\f[R]
.SS کلاینت:
.PP
\f[V]client$ fi_pingpong -p usnic -I 10000 -S all 192.168.0.123\f[R]
.SH "پیش‌فرض‌ها (DEFAULTS)"
.PP
هیچ ارائه‌دهنده پیش‌فرضی وجود ندارد؛ اگر ارائه‌دهنده‌ای از طریق سوئیچ \f[V]-p\f[R] مشخص نشود، آزمون یک مورد را از فهرست ارائه‌دهندگان موجود (همان‌طور که توسط fi_getinfo(3) بازگردانده می‌شود) انتخاب خواهد کرد.
.PP
اگر هیچ نوع endpoint مشخص نشده باشد، \(aqdgram\(aq استفاده می‌شود.
.PP
اندازه‌های آزموده‌شده پیش‌فرض عبارتند از: 64، 256، 1024، 4096، 65536 و 1048576.
آزمون تنها اندازه‌هایی را بررسی خواهد کرد که در محدوده حداکثر اندازه پیام endpoint انتخاب‌شده قرار داشته باشند.
.SH "خروجی (OUTPUT)"
.PP
هر آزمون پیام‌های داده‌ای تولید می‌کند که در محاسبات لحاظ می‌شوند.
به‌طور مشخص، آمارهای نمایش‌داده‌شده در انتها عبارتند از:
.IP \[bu] 2
\f[I]bytes\f[R] : تعداد بایت‌های هر پیام ارسالی
.IP \[bu] 2
\f[I]#sent\f[R] : تعداد پیام‌های (ping) ارسالی از کلاینت به سرور
.IP \[bu] 2
\f[I]#ack\f[R] : تعداد پاسخ‌های (pong) سرور که توسط کلاینت دریافت شده است
.IP \[bu] 2
\f[I]total\f[R] : میزان حافظه مبادله‌شده میان فرآیندها
.IP \[bu] 2
\f[I]time\f[R] : مدت‌زمان این آزمون تکی
.IP \[bu] 2
\f[I]MB/sec\f[R] : پهنای باند/توان عملیاتی محاسبه‌شده از روی \f[I]total\f[R] و \f[I]time\f[R]
.IP \[bu] 2
\f[I]usec/xfer\f[R] : میانگین زمان ارسال یک پیام خروجی (ping یا pong) بر حسب میکروثانیه
.IP \[bu] 2
\f[I]Mxfers/sec\f[R] : میانگین تعداد انتقال‌های پیام خروجی در هر ثانیه
.SH "همچنین ببینید (SEE ALSO)"
.PP
\f[V]fi_getinfo\f[R](3), \f[V]fi_endpoint\f[R](3) \f[V]fabric\f[R](7),
.SH "نویسندگان (AUTHORS)"
OpenFabrics.