نام (NAME)

riostream - آزمون پینگ‌پنگ جریان داده با رونویسی صفر (zero-copy) بر بستر RDMA

خلاصه دستور (SYNOPSIS)

riostream [-s server_address] [-b bind_address] [-B buffer_size]
			[-I iterations] [-C transfer_count]
			[-S transfer_size] [-p server_port] [-T test_option]

توضیحات (DESCRIPTION)

از پروتکل ارسال جریانی بر بستر RDMA‏ (rsocket) برای برقراری اتصال و تبادل داده میان یک برنامه کلاینت و سرور استفاده می‌کند.

گزینه‌ها (OPTIONS)

-s server_address: نام شبکه یا نشانی IP سیستم سرور که در انتظار اتصالات ورودی است. نام یا نشانی استفاده‌شده باید از طریق یک دستگاه RDMA مسیریابی شود. این گزینه باید توسط کلاینت مشخص شود.
-b bind_address: نشانی شبکه محلی برای مقید شدن (bind) به آن.
-B buffer_size: اندازه بافرهای شبکه برای ارسال و دریافت را مشخص می‌کند.
-I iterations: تعداد دفعاتی که تعداد پیام‌های مشخص‌شده میان کلاینت و سرور تبادل خواهند شد (پیش‌فرض: 1000).
-C transfer_count: تعداد پیام‌هایی که در هر تکرار، از کلاینت به سرور انتقال یافته و بازگردانده می‌شوند (پیش‌فرض: 1).
-S transfer_size: اندازه هر انتقال ارسالی بر حسب بایت (پیش‌فرض: 1000). در صورتی که 'all' مشخص شود، rstream مجموعه‌ای از آزمون‌ها را با اندازه‌های گوناگون اجرا خواهد کرد.
-p server_port: شماره پورت سرور.
-T test_option: پارامترهای آزمون را تعیین می‌کند. گزینه‌های موجود عبارتند از:

a | async - از عملیات ناهمگام استفاده می‌کند (مانند select / poll)

b | blocking - از فراخوانی‌های مسدودکننده (blocking) استفاده می‌کند

n | nonblocking - از فراخوانی‌های غیرمسدودکننده (non-blocking) استفاده می‌کند

v | verify - صحت داده‌های انتقال‌یافته را اعتبارسنجی می‌کند

نکات (NOTES)

کاربرد پایه این ابزار به این صورت است که ابتدا riostream روی یک سیستم سرور اجرا شود، سپس دستور riostream -s server_name بر روی سیستم کلاینت اجرا گردد. به‌طور پیش‌فرض، riostream مجموعه‌ای از آزمون‌های کارایی تأخیر (latency) و پهنای باند را اجرا خواهد کرد. با مشخص کردن مقادیر متفاوت برای iterations، transfer_count، یا transfer_size، آزمونی سفارشی‌سازی‌شده اجرا می‌شود که برای مقادیر مشخص‌نشده، از مقادیر پیش‌فرض استفاده خواهد کرد.

از آنجا که این آزمون منابع RDMA را به فضای کاربری (userspace) نگاشت می‌کند، کاربران باید اطمینان حاصل کنند که منابع سیستمی و مجوزهای لازم را در اختیار دارند. برای جزئیات بیشتر به فایل README در libibverbs مراجعه کنید.

همچنین ببینید (SEE ALSO)

rdma_cm(7) rstream(1)