.\" Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md
.TH SRP_DAEMON 8 "September 5, 2006" "OpenFabrics" "USER COMMANDS"

.SH "نام (NAME)"
srp_daemon \- شناسایی اهداف SRP در یک فابریک InfiniBand

.SH "خلاصه دستور (SYNOPSIS)"
.B srp_daemon\fR [\fB\-vVcaeon\fR] [\fB\-d \fIumad-device\fR | \fB\-i \fIinfiniband-device\fR [\fB\-p \fIport-num\fR] | \fB\-j \fIdev:port\fR] [\fB\-t \fItimeout(ms)\fR] [\fB\-r \fIretries\fR] [\fB\-R \fIrescan-time\fR] [\fB\-f \fIrules-file\fR]

.SH "توضیحات (DESCRIPTION)"
.PP
اهداف پروتکل SCSI RDMA در InfiniBand (به اختصار SRP) را در یک فابریک IB شناسایی کرده و به آن‌ها متصل می‌شود.
.PP
هر نمونه از
.B srp_daemon
روی یک درگاه محلی عمل می‌کند. هنگام بالا آمدن، یک اسکن مجدد کامل از فابریک انجام می‌دهد و سپس منتظر یک رویداد
.B srp_daemon
می‌ماند. یک رویداد
.B srp_daemon
می‌تواند پیوستن یک ماشین جدید به فابریک، تغییر در قابلیت‌های یک ماشین، تغییر در SA، یا منقضی شدن یک مهلت زمانی از پیش تعیین‌شده باشد.
.PP
هنگامی که یک ماشین جدید به فابریک می‌پیوندد،
.B srp_daemon
بررسی می‌کند که آیا آن یک هدف SRP است یا خیر. هنگام وجود تغییر در قابلیت‌ها،
.B srp_daemon
بررسی می‌کند که آیا ماشین به یک هدف SRP تبدیل شده است یا خیر. هنگام رخ دادن تغییر در SA یا انقضای مهلت زمانی،
.B srp_daemon
یک اسکن مجدد کامل از فابریک انجام می‌دهد.
.PP
برای هر هدفی که
.B srp_daemon
می‌یابد، بررسی می‌کند که آیا طبق قوانین خود (فایل قوانین پیش‌فرض
.BR /etc/srp_daemon.conf
است) باید به این هدف متصل شود و آیا پیش‌تر به درگاه محلی متصل شده است یا خیر. اگر باید به این هدف متصل شود و هنوز متصل نشده باشد،
.B srp_daemon
می‌تواند جزئیات هدف را چاپ کند یا به آن متصل شود.

.SH "گزینه‌ها (OPTIONS)"
.PP
.TP
\fB\-v\fR
چاپ خروجی پرجزئیات‌تر.
.TP
\fB\-V\fR
چاپ خروجی بسیار پرجزئیات‌تر (حالت اشکال‌زدایی).
.TP
\fB\-i\fR \fIinfiniband-device\fR
کار روی \fIinfiniband-device\fR. این گزینه نباید همراه با \fB\-d\fR یا \fB\-j\fR استفاده شود.
.TP
\fB\-p\fR \fIport-num\fR
کار روی درگاه \fIport-num\fR (پیش‌فرض 1). این گزینه باید همراه با \fB\-i\fR استفاده شود و نباید همراه با \fB\-d\fR یا \fB\-j\fR استفاده شود.
.TP
\fB\-j\fR \fIdev:port\fR
کار روی شماره درگاه \fIport\fR از دستگاه InfiniBand با نام \fIdev\fR. این گزینه نباید همراه با \fB\-d\fR، \fB\-i\fR یا \fB\-p\fR استفاده شود.
.TP
\fB\-d\fR \fIumad-device\fR
استفاده از فایل دستگاه \fIumad-device\fR (پیش‌فرض \fB/dev/infiniband/umad0\fR). این گزینه نباید همراه با \fB\-i\fR، \fB\-p\fR یا \fB\-j\fR استفاده شود.
.TP
\fB\-c\fR
تولید خروجی مناسب برای ارسال از طریق لوله (pipe) مستقیم به یک فایل \fB/sys/class/infiniband_srp/srp\-<device>\-<port>/add_target\fR.
.TP
\fB\-a\fR
تمام اهداف موجود در فابریک را چاپ می‌کند، نه فقط اهدافی که از طریق درگاه محلی متصل نیستند. این رفتار مشابه رفتار \fBibsrpdm\fR است.
.TP
\fB\-e\fR
دستور اتصال را اجرا می‌کند؛ یعنی اتصال به هدف را برقرار می‌سازد.
.TP
\fB\-o\fR
فقط یک اسکن مجدد انجام داده و همانند \fBibsrpdm\fR خارج می‌شود.
.TP
\fB\-R\fR \fIrescan-time\fR
اجبار به اسکن مجدد کامل هر \fIrescan-time\fR ثانیه یک‌بار. اگر \fB\-R\fR مشخص نشود، هیچ اسکن مجددی بر اساس مهلت زمانی انجام نخواهد شد.
.TP
\fB\-T\fR \fIretry-timeout\fR
تلاش مجدد برای اتصال به هدف موجود پس از \fIretry-timeout\fR ثانیه. اگر \fB\-R\fR مشخص نشود، از مهلت زمانی ۵ ثانیه استفاده می‌کند. اگر \fIretry-timeout\fR برابر 0 باشد، برای اتصال مجدد تلاشی نمی‌کند. دلیل تلاش مجدد \fBsrp_daemon\fR برای اتصال به هدف این است که ممکن است سناریوی نادری رخ دهد که در آن \fBsrp_daemon\fR برای افزودن یک هدف تلاش کند، در حالی که هدف در آستانه حذف شدن است ولی هنوز حذف نشده است.
.TP
\fB\-f\fR \fIrules-file\fR
تصمیم‌گیری برای این‌که به کدام اهداف متصل شود، بر اساس قوانین موجود در \fIrules-file\fR.
اگر \fB\-f\fR مشخص نشود، از فایل قوانین پیش‌فرض \fB/etc/srp_daemon.conf\fR استفاده می‌شود.
هر خط در \fIrules-file\fR یک قانون است که بر اساس نویسه نخست خط (\fBa\fR برای مجاز یا \fBd\fR برای غیرمجاز)، می‌تواند اجازه اتصال یا عدم اجازه اتصال باشد. باقی‌مانده خط مقادیر \fBid_ext\fR، \fBioc_guid\fR، \fBdgid\fR و \fBservice_id\fR است. لطفاً برای نمونه‌ای از این فایل به بخش مثال‌ها نگاه کنید. \fBsrp_daemon\fR مجاز یا غیرمجاز بودن هر هدف را بر اساس نخستین قانونی که با هدف تطابق داشته باشد مشخص می‌کند. اگر هیچ قانونی با هدف تطابق نداشته باشد، هدف مجاز شناخته شده و متصل خواهد شد. در یک قانون مجاز، تعیین ویژگی‌ها برای اتصال به هدف امکان‌پذیر است. ویژگی‌های پشتیبانی‌شده شامل \fBmax_cmd_per_lun\fR و \fBmax_sect\fR هستند.
.TP
\fB\-t\fR \fItimeout\fR
استفاده از مهلت زمانی \fItimeout\fR میلی‌ثانیه برای پاسخ‌های MAD (پیش‌فرض: ۵ ثانیه).
.TP
\fB\-r\fR \fIretries\fR
انجام \fIretries\fR بار تلاش مجدد برای هر ارسال به MAD (پیش‌فرض: ۳ تلاش مجدد).
.TP
\fB\-n\fR
قالب جدید \- استفاده از \fIinitiator_ext\fR در دستور اتصال نیز.
.TP
\fB\--systemd\fR
فعال‌سازی یکپارچه‌سازی با systemd.

.SH "فایل‌ها (FILES)"
/etc/srp_daemon.conf \-
فایل پیکربندی قوانین پیش‌فرض که مشخص می‌کند به کدام اهداف متصل شود. می‌تواند با استفاده از گزینه \fB\-f\fR \fIrules-file\fR لغو و بازنویسی شود.
هر خط در این فایل یک قانون است که بر اساس نویسه نخست خط (\fBa\fR یا \fBd\fR به ترتیب)، می‌تواند اجازه اتصال یا عدم اجازه اتصال باشد. باقی‌مانده خط مقادیر \fBid_ext\fR، \fBioc_guid\fR، \fBdgid\fR و \fBservice_id\fR است. لطفاً برای نمونه‌ای از این فایل به بخش مثال‌ها نگاه کنید. \fBsrp_daemon\fR مجاز یا غیرمجاز بودن هر هدف را بر اساس نخستین قانونی که با هدف مطابقت داشته باشد تعیین می‌کند. اگر هیچ قانونی با هدف مطابقت نداشته باشد، هدف مجاز دانسته شده و متصل خواهد شد. در یک قانون مجاز، تعیین ویژگی‌ها برای اتصال به هدف امکان‌پذیر است. ویژگی‌های پشتیبانی‌شده عبارتند از \fBmax_cmd_per_lun\fR و \fBmax_sect\fR.

.SH "مثال‌ها (EXAMPLES)"
srp_daemon -e -i mthca0 -p 1 -R 60 (اتصال به اهداف قابل دسترسی از طریق درگاه 1 از mthca0. انجام یک اسکن مجدد کامل در هر دقیقه)

srp_daemon -o -c -a		    (چاپ دستورات اتصال برای اهداف موجود در فابریک و خروج \- مشابه ibsrpdm)

srp_daemon -e -f rules.txt	    (اتصال به اهداف مجاز در فایل قوانین rules.txt)

.nf
نمونه‌ای برای فایل پیکربندی قوانین (مانند /etc/srp_daemon.conf):
------------------------------------------------------------------------
# Rules file example
# This is a comment
# disallow the following dgid
d       dgid=fe800000000000000002c90200402bd5
# allow target with the following ioc_guid
a       ioc_guid=00a0b80200402bd7
# allow target with the following id_ext and ioc_guid. And setting max_cmd_per_lun to 31.
a       id_ext=200500A0B81146A1,ioc_guid=00a0b80200402bef,max_cmd_per_lun=31
# disallow all the rest
d
.fi

.SH "همچنین ببینید (SEE ALSO)"
.BR ibsrpdm (8)

.SH "نویسندگان (AUTHORS)"
.TP
Roland Dreier
.RI < rolandd@cisco.com >
.TP
Ishai Rabinovitz
.RI < ishai@mellanox.co.il >