.\" Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md
.TH "RIOSTREAM" 1 "2012-10-24" "librdmacm" "librdmacm" librdmacm
.SH "نام (NAME)"
riostream \- آزمون پینگ‌پنگ جریان داده با رونویسی صفر (zero-copy) بر بستر RDMA
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIriostream\fR [-s server_address] [-b bind_address] [-B buffer_size]
			[-I iterations] [-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
\-I iterations
تعداد دفعاتی که تعداد پیام‌های مشخص‌شده میان کلاینت و سرور تبادل خواهند شد (پیش‌فرض: 1000).
.TP
\-C transfer_count
تعداد پیام‌هایی که در هر تکرار، از کلاینت به سرور انتقال یافته و بازگردانده می‌شوند (پیش‌فرض: 1).
.TP
\-S transfer_size
اندازه هر انتقال ارسالی بر حسب بایت (پیش‌فرض: 1000). در صورتی که 'all' مشخص شود، rstream مجموعه‌ای از آزمون‌ها را با اندازه‌های گوناگون اجرا خواهد کرد.
.TP
\-p server_port
شماره پورت سرور.
.TP
\-T test_option
پارامترهای آزمون را تعیین می‌کند. گزینه‌های موجود عبارتند از:
.P
a | async \- از عملیات ناهمگام استفاده می‌کند (مانند select / poll)
.P
b | blocking \- از فراخوانی‌های مسدودکننده (blocking) استفاده می‌کند
.P
n | nonblocking \- از فراخوانی‌های غیرمسدودکننده (non-blocking) استفاده می‌کند
.P
v | verify \- صحت داده‌های انتقال‌یافته را اعتبارسنجی می‌کند
.SH "نکات (NOTES)"
کاربرد پایه این ابزار به این صورت است که ابتدا riostream روی یک سیستم سرور اجرا شود، سپس دستور riostream \-s server_name بر روی سیستم کلاینت اجرا گردد. به‌طور پیش‌فرض، riostream مجموعه‌ای از آزمون‌های کارایی تأخیر (latency) و پهنای باند را اجرا خواهد کرد. با مشخص کردن مقادیر متفاوت برای iterations، transfer_count، یا transfer_size، آزمونی سفارشی‌سازی‌شده اجرا می‌شود که برای مقادیر مشخص‌نشده، از مقادیر پیش‌فرض استفاده خواهد کرد.
.P
از آنجا که این آزمون منابع RDMA را به فضای کاربری (userspace) نگاشت می‌کند، کاربران باید اطمینان حاصل کنند که منابع سیستمی و مجوزهای لازم را در اختیار دارند. برای جزئیات بیشتر به فایل README در libibverbs مراجعه کنید.
.SH "همچنین ببینید (SEE ALSO)"
rdma_cm(7) rstream(1)