.\" Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md
.TH "MCKEY" 1 "2007-05-15" "librdmacm" "librdmacm" librdmacm
.SH "نام (NAME)"
mckey \- راه‌اندازی چندپخشی RDMA CM و آزمون انتقال ساده داده
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fImckey\fR -m multicast_address [-s] [-b bind_address] [-c connections]
		[-C message_count] [-S message_size] [-p port_space]
\fImckey\fR -m multicast_address -s [-b bind_address] [-c connections]
		[-C message_count] [-S message_size] [-p port_space]
\fImckey\fR -M unmapped_multicast_address -b bind_address [-s] [-c connections]
		[-C message_count] [-S message_size] [-p port_space]
.fi
.SH "توضیحات (DESCRIPTION)"
مجموعه‌ای از مسیرهای ارتباطی چندپخشی RDMA را میان گره‌ها با استفاده از librdmacm برقرار می‌کند، به‌صورت اختیاری دیتاگرام‌ها را به گره‌های گیرنده انتقال می‌دهد و سپس ارتباط را خاتمه می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-m multicast_address
نشانی IP چندپخشی برای پیوستن.
.TP
\-M unmapped_multicast_address
نشانی چندپخشی ویژه انتقال RDMA برای پیوستن.
.TP
\-s
ارسال دیتاگرام‌ها به گروه چندپخشی.
.TP
\-b bind_address
نشانی شبکه محلی برای مقیدسازی (bind).
.TP
\-c connections
تعداد QPها برای پیوستن به گروه چندپخشی. (پیش‌فرض: 1)
.TP
\-C message_count
تعداد پیام‌ها برای انتقال روی هر اتصال. (پیش‌فرض: 10)
.TP
\-S message_size
اندازه هر پیام منتقل‌شده، بر حسب بایت. این مقدار باید کوچک‌تر از MTU انتقال زیربنایی RDMA باشد، در غیر این صورت خطایی رخ خواهد داد. (پیش‌فرض: 100)
.TP
\-o
پیوستن به گروه چندپخشی به‌عنوان عضو کامل فقط-ارسال (send-only full-member). در غیر این صورت، عضویت در گروه به‌عنوان عضو کامل انجام می‌شود.
.TP
.TP
\-l
جلوگیری از بازگشت (loopback) پیام‌های چندپخشی. سایر دریافت‌کنندگان روی سیستم محلی، پیام‌های چندپخشی را دریافت نخواهند کرد. در غیر این صورت تمام پیام‌های چندپخشی به میزبانی که از آن منشأ گرفته‌اند نیز ارسال می‌شوند و شنوندگان محلی (و احتمالاً خود فرایند ارسال‌کننده) پیام‌ها را دریافت خواهند کرد.
\-p port_space
فضای پورت ارتباطی دیتاگرام. می‌تواند فضای پورت RDMA UDP (0x0111) یا IPoIB (0x0002) باشد. (پیش‌فرض: RDMA_PS_UDP)
.SH "نکات (NOTES)"
کاربرد پایه‌ای این است که mckey -m multicast_address روی یک سیستم سرور اجرا شود، سپس mckey -m multicast_address -s روی یک سیستم کلاینت به اجرا درآید.
.P
شناسه‌های GID چندپخشی یکتای تخصیص‌یافته توسط Infiniband SA را می‌توان با فراخوانی mckey با یک MGID یا نشانی IP صفر دریافت کرد (برای نمونه، \-M 0 یا \-m 0.0.0.0). نشانی تخصیص‌یافته نمایش داده می‌شود تا کلاینت‌های mckey بتوانند به گروه ایجادشده بپیوندند.
.P
از آنجا که این آزمون منابع RDMA را به فضای کاربری (userspace) نگاشت می‌کند، کاربران باید اطمینان حاصل کنند که منابع سیستمی و مجوزهای لازم را دارند. برای جزئیات تکمیلی، فایل README مربوط به libibverbs را ببینید.
.SH "همچنین ببینید (SEE ALSO)"
rdma_cm(7), ucmatose(1), udaddy(1), rping(1)