MCKEY(1) librdmacm MCKEY(1)

mckey - راه‌اندازی چندپخشی RDMA CM و آزمون انتقال ساده داده

mckey -m multicast_address [-s] [-b bind_address] [-c connections]
		[-C message_count] [-S message_size] [-p port_space]
mckey -m multicast_address -s [-b bind_address] [-c connections]
		[-C message_count] [-S message_size] [-p port_space]
mckey -M unmapped_multicast_address -b bind_address [-s] [-c connections]
		[-C message_count] [-S message_size] [-p port_space]

مجموعه‌ای از مسیرهای ارتباطی چندپخشی RDMA را میان گره‌ها با استفاده از librdmacm برقرار می‌کند، به‌صورت اختیاری دیتاگرام‌ها را به گره‌های گیرنده انتقال می‌دهد و سپس ارتباط را خاتمه می‌دهد.

نشانی IP چندپخشی برای پیوستن.
نشانی چندپخشی ویژه انتقال RDMA برای پیوستن.
ارسال دیتاگرام‌ها به گروه چندپخشی.
نشانی شبکه محلی برای مقیدسازی (bind).
تعداد QPها برای پیوستن به گروه چندپخشی. (پیش‌فرض: 1)
تعداد پیام‌ها برای انتقال روی هر اتصال. (پیش‌فرض: 10)
اندازه هر پیام منتقل‌شده، بر حسب بایت. این مقدار باید کوچک‌تر از MTU انتقال زیربنایی RDMA باشد، در غیر این صورت خطایی رخ خواهد داد. (پیش‌فرض: 100)
پیوستن به گروه چندپخشی به‌عنوان عضو کامل فقط-ارسال (send-only full-member). در غیر این صورت، عضویت در گروه به‌عنوان عضو کامل انجام می‌شود.
جلوگیری از بازگشت (loopback) پیام‌های چندپخشی. سایر دریافت‌کنندگان روی سیستم محلی، پیام‌های چندپخشی را دریافت نخواهند کرد. در غیر این صورت تمام پیام‌های چندپخشی به میزبانی که از آن منشأ گرفته‌اند نیز ارسال می‌شوند و شنوندگان محلی (و احتمالاً خود فرایند ارسال‌کننده) پیام‌ها را دریافت خواهند کرد. -p port_space فضای پورت ارتباطی دیتاگرام. می‌تواند فضای پورت RDMA UDP (0x0111) یا IPoIB (0x0002) باشد. (پیش‌فرض: RDMA_PS_UDP)

کاربرد پایه‌ای این است که mckey -m multicast_address روی یک سیستم سرور اجرا شود، سپس mckey -m multicast_address -s روی یک سیستم کلاینت به اجرا درآید.

شناسه‌های GID چندپخشی یکتای تخصیص‌یافته توسط Infiniband SA را می‌توان با فراخوانی mckey با یک MGID یا نشانی IP صفر دریافت کرد (برای نمونه، -M 0 یا -m 0.0.0.0). نشانی تخصیص‌یافته نمایش داده می‌شود تا کلاینت‌های mckey بتوانند به گروه ایجادشده بپیوندند.

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

rdma_cm(7), ucmatose(1), udaddy(1), rping(1)

2007-05-15 librdmacm