.\" Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md
.TH "ib_acme" 1 "2014-06-16" "ib_acme" "ib_acme" ib_acme
.SH "نام (NAME)"
ib_acme \- ابزار آزمایش و پیکربندی برای IB ACM
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIib_acme\fR [-f addr_format] [-s src_addr] -d dest_addr [-v] [-c] [-e] [-P] [-S svc_addr] [-C repetitions]
.fi
.nf
\fIib_acme\fR [-A [addr_file]] [-O [opt_file]] [-D dest_dir] [-V]
.fi
.SH "توضیحات (DESCRIPTION)"
ابزار ib_acme در پیکربندی و آزمایش سرویس ibacm کمک می‌کند.
حالت استفاده اول از این سرویس، فعال بودن و عملکرد صحیح ibacm را
بررسی می‌کند. الگوی استفاده دوم به‌طور خودکار فایل‌های آدرس و پیکربندی
را برای سرویس ibacm ایجاد می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-f addr_format
قالب پارامترهای src_addr و dest_addr را مشخص می‌کند. قالب‌های معتبر
آدرس عبارتند از: «i» برای آدرس ip، «n» برای نام میزبان، «l» برای lid، «g» برای gid،
و «u» برای مشخص‌نشده. اگر گزینه \-f مشخص نشود،
قالب آدرس نامشخص فرض می‌شود. ib_acme از getaddrinfo یا
سازوکارهای دیگر برای تعیین قالب مورد استفاده آدرس بهره می‌گیرد.
.TP
\-s src_addr
آدرس مبدأ محلی مسیری که باید تحلیل شود را مشخص می‌کند. همان‌طور که
توسط گزینه addr_format تعیین می‌شود، آدرس مبدأ می‌تواند یک آدرس IP،
نام شبکه سیستم، یا LID باشد.
.TP
\-d dest_addr
آدرس مقصد مسیری که باید تحلیل شود را مشخص می‌کند. همان‌طور که
توسط گزینه addr_format تعیین می‌شود، آدرس مقصد می‌تواند یک آدرس IP،
نام شبکه سیستم، یا LID باشد.
.TP
\-v
مشخص می‌کند که اطلاعات مسیر تحلیل‌شده باید با IB SA فعال بررسی
و اعتبارسنجی شود. استفاده از گزینه \-v یک بررسی صحت ارائه می‌دهد تا اطمینان
حاصل شود که اطلاعات مسیر به‌دست‌آمده با توجه به پیکربندی فعلی کلاستر قابل استفاده است.
.TP
\-c
به سرویس ACM دستور می‌دهد که تنها اطلاعاتی را بازگرداند که در حال حاضر
در کَش محلی آن قرار دارد.
.TP
\-e [N]
یک (N = 1, 2, ...) یا همهٔ نقاط پایانی (endpoints) (N = 0 یا در صورت عدم وجود) را نمایش می‌دهد.
.TP
\-P [opt]
داده‌های عملکردی را از سرویس مقصد استعلام می‌کند. گزینه‌های معتبر عبارتند از:
«col» برای خروجی دادن داده‌های ترکیبی در قالب ستونی، «N» (N = 1, 2, ...) برای
خروجی دادن داده‌ها برای یک نقطه پایانی مشخص N، «all» برای خروجی دادن داده‌ها برای همهٔ
نقاط پایانی، و «s» برای خروجی دادن داده‌ها برای یک نقطه پایانی مشخص با آدرس ارائه‌شده توسط گزینه \-s.
.TP
\-S svc_addr
نام میزبان، آدرس IPv4 یا سوکت دامنه یونیکس سرویس ACM؛ پیش‌فرض: /run/ibacm.sock
.TP
\-C repetitions
تعداد تکرارها برای انجام عملیات تحلیل مسیر. برای سنجش
عملکرد جستجوهای کَش ACM استفاده می‌شود. پیش‌فرض 1 است.
.TP
\-A [addr_file]
با این گزینه، ابزار ib_acme به‌طور خودکار فایل پیکربندی آدرس
ibacm_addr.cfg را تولید می‌کند. فایل تولیدشده با استفاده از
نام میزبان سیستم ساخته می‌شود.
.TP
\-O [opt_file]
با این گزینه، ابزار ib_acme به‌طور خودکار فایل پیکربندی گزینه‌ها
ibacm_opts.cfg را تولید می‌کند. فایل تولیدشده در حال حاضر با استفاده از
اطلاعات ایستا ایجاد می‌شود.
.TP
\-D dest_dir
دایرکتوری مقصد را برای فایل‌های خروجی مشخص می‌کند.
.TP
\-V
خروجی پرگو (verbose) را فعال می‌کند. هنگامی که با گزینه‌های \-A یا \-O ترکیب شود،
ib_acme جزئیات بیشتری مانند اطلاعات آدرس تولیدشدهٔ ذخیره‌شده
در فایل ibacm_addr.cfg را نمایش می‌دهد.
.SH "نکات (NOTES)"
ابزار ib_acme دو عملکرد اصلی را انجام می‌دهد. با گزینه‌های \-A و \-O،
این ابزار به‌طور خودکار فایل‌های پیکربندی آدرس یا گزینه‌ها را تولید می‌کند.
فایل‌های تولیدشده متنی هستند و می‌توان آن‌ها را ویرایش کرد. هدف از این گزینه‌ها
ارائه روشی ساده برای پیکربندی اطلاعات آدرس و تنظیمات در تمامی
گره‌های یک کلاستر است.
.P
عملکرد دیگر ابزار ib_acme آزمایش سرویس ibacm است، از جمله کمک به
تأیید اینکه آیا این سرویس با توجه به پیکربندی فعلی کلاستر قابل استفاده است یا خیر.
ابزار ib_acme می‌تواند آدرس‌های IP، نام‌های شبکه، یا IB LIDها را به یک رکورد مسیر
تحلیل کند. سپس می‌تواند آن رکورد مسیر را با رکوردی که توسط SA به دست آمده
مقایسه کند. هنگامی که از این ابزار برای آزمایش سرویس ibacm استفاده می‌شود،
ib_acme این اثر جانبی را دارد که کَش‌های ibacm را بارگذاری می‌کند.
.P
با افزودن براکت‌های [] به انتهای نام یا آدرس مقصد پایه، می‌توان چندین مقصد عددی را
مشخص کرد. کاربران می‌توانند با استفاده از مثال زیر به عنوان راهنما، فهرستی از
محدوده‌های عددی را درون براکت‌ها مشخص کنند: node[1-3,5,7-8].
این کار منجر به آزمایش node1، node2، node3، node5، node7 و node8 خواهد شد.
.SH "همچنین ببینید (SEE ALSO)"
ibacm(7), ibacm(8)