.TH SG_REFERRALS "8" "مه 2014" "sg3_utils\-1.39" SG3_UTILS
.SH "نام (NAME)"
sg_referrals \- ارسال دستور SCSI REPORT REFERRALS
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_referrals
[\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-lba=LBA\fR] [\fI\-\-maxlen=LEN\fR]
[\fI\-\-one\-segment\fR] [\fI\-\-raw\fR] [\fI\-\-readonly\fR]
[\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
دستور SCSI REPORT REFERRALS را به \fIDEVICE\fR ارسال کرده و پاسخ را نمایش می‌دهد. این دستور در (پیش‌نویس) نگارش ۲۴ استاندارد SBC\-3 معرفی شد و دستگاه‌هایی که از ارجاعات (referrals) پشتیبانی می‌کنند باید از این دستور نیز پشتیبانی کنند.
.PP
عملکرد پیش‌فرض، رمزگشایی پاسخ برای تمام توصیف‌کننده‌های ارجاع سگمنت داده کاربر (user data segment referral descriptors) است. مقدار خروجی را می‌توان با گزینه‌های \fI\-\-lba\fR و \fI\-\-one\-segment\fR کاهش داد.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنما و سپس خروج.
.TP
\fB\-H\fR, \fB\-\-hex\fR
چاپ پاسخ این دستور به صورت هگزادسیمال ASCII.
.TP
\fB\-l\fR, \fB\-\-lba\fR=\fILBA\fR
که در آن \fILBA\fR آدرس بلوک منطقی (Logical Block Address) در نخستین سگمنت داده کاربر است که \fIDEVICE\fR باید داده‌های پارامتر ارجاعات را برای آن گزارش دهد.
.TP
\fB\-m\fR, \fB\-\-maxlen\fR=\fILEN\fR
که در آن \fILEN\fR (حداکثر) طول پاسخ بر حسب بایت است. این مقدار در فیلد "allocation length" (طول تخصیص) از cdb قرار می‌گیرد. اگر داده نشود، از 256 استفاده می‌شود. مقدار 256 فضای کافی برای سرآیند پاسخ و توصیف‌کننده‌های سگمنت داده کاربر است.
.TP
\fB\-s\fR, \fB\-\-one\-segment\fR
تنها سگمنت داده کاربرِ مشخص‌شده توسط پارامتر \fILBA\fR را گزارش می‌دهد.
.TP
\fB\-r\fR, \fB\-\-raw\fR
خروجی پاسخ به صورت باینری (به stdout).
.TP
\fB\-R\fR, \fB\-\-readonly\fR
دستگاه \fIDEVICE\fR را به صورت فقط‌خواندنی باز می‌کند (مثلاً در یونیکس با پرچم O_RDONLY). حالت پیش‌فرض، باز کردن آن به صورت خواندن\-نوشتن است.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح پرگویی (یعنی خروجی اشکال‌زدایی). خروجی‌های اضافی ناشی از این گزینه به stderr فرستاده می‌شوند.
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ رشته نسخه و سپس خروج.
.SH "نکات (NOTES)"
برای بررسی و بحث پیرامون ارجاعات (referrals) به بخش ۴.۲۵ از سند sbc3r25.pdf در https://www.t10.org (یا بخش مربوطه در پیش‌نویس‌های بعدی) مراجعه کنید.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_referrals در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Douglas Gilbert و Hannes Reinecke.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
Copyright \(co 2009\-2014 Douglas Gilbert and Hannes Reinecke
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع شده است. هیچ تضمینی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sg_vpd(8)