.\" Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md
.TH "UDPONG" 1 "2017-04-28" "librdmacm" "librdmacm" librdmacm
.SH "نام (NAME)"
udpong \- آزمون پینگ‌پنگ جریان دیتاگرام غیرقابل‌اعتماد بر بستر RDMA
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIudpong\fR [-s server_address] [-b bind_address]
			[-B buffer_size] [-C transfer_count]
			[-S transfer_size] [-p server_port] [-T test_option]
.fi
.SH "توضیحات (DESCRIPTION)"
از جریان دیتاگرام غیرقابل‌اعتماد بر بستر پروتکل RDMA‏ (rsocket) برای برقراری اتصال و تبادل داده میان یک برنامه کلاینت و سرور استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-s server_address
نام شبکه یا نشانی IP سیستم سرور که منتظر اتصال‌ها است. نام یا نشانی استفاده‌شده باید از طریق یک دستگاه RDMA مسیریابی شود. این گزینه باید توسط کلاینت مشخص شود.
.TP
\-b bind_address
نشانی شبکه محلی برای متصل شدن (bind).
.TP
\-B buffer_size
اندازه بافرهای شبکه مربوط به ارسال و دریافت را تعیین می‌کند.
.TP
\-C transfer_count
تعداد پیام‌ها برای انتقال از کلاینت به سرور و بازگشت مجدد آن در هر تکرار. (پیش‌فرض: 1000)
.TP
\-S transfer_size
اندازه هر انتقال ارسال، به بایت. (پیش‌فرض: 1000)
.TP
\-p server_port
شماره درگاه (port) سرور.
.TP
\-T test_option
پارامترهای آزمون را تعیین می‌کند. گزینه‌های دردسترس عبارتند از:
.P
s | socket  \- استفاده از فراخوانی‌های استاندارد سوکت برای انتقال داده
.P
a | async \- استفاده از عملیات ناهمگام (مانند select / poll)
.P
b | blocking \- استفاده از فراخوانی‌های مسدودکننده (blocking)
.P
n | nonblocking \- استفاده از فراخوانی‌های غیرمسدودکننده (non-blocking)
.P
e | echo \- سرور تمام پیام‌ها را بازتاب (echo) می‌دهد
.SH "نکات (NOTES)"
کاربرد پایه به این صورت است که ابتدا udpong روی یک سیستم سرور اجرا شود، سپس دستور udpong \-s server_name روی سیستم کلاینت اجرا گردد. دستور udpong مجموعه‌ای از آزمون‌های کارایی تأخیر (latency) و پهنای باند را اجرا خواهد کرد. مشخص کردن یک transfer_count یا transfer_size متفاوت، آزمون سفارشی‌شده‌ای را اجرا خواهد کرد که برای پارامترهای نامشخص از مقادیر پیش‌فرض استفاده می‌کند.
.P
از آنجا که این آزمون منابع RDMA را به فضای کاربری (userspace) نگاشت می‌کند، کاربران باید اطمینان حاصل کنند که منابع سیستمی و مجوزهای لازم را در اختیار دارند. برای جزئیات بیشتر به فایل README مربوط به libibverbs مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
rdma_cm(7)