SG_REFERRALS(8)                    SG3_UTILS                   SG_REFERRALS(8)

نام (NAME)
       sg_referrals - ارسال دستور SCSI REPORT REFERRALS

خلاصه دستور (SYNOPSIS)
       sg_referrals [--help] [--hex] [--lba=LBA] [--maxlen=LEN]
       [--one-segment] [--raw] [--readonly] [--verbose] [--version] DEVICE

توضیحات (DESCRIPTION)
       دستور SCSI REPORT REFERRALS را به DEVICE ارسال کرده و پاسخ را نمایش
       می‌دهد. این دستور در (پیش‌نویس) نگارش ۲۴ استاندارد SBC-3 معرفی شد و
       دستگاه‌هایی که از ارجاعات (referrals) پشتیبانی می‌کنند باید از این دستور
       نیز پشتیبانی کنند.

       عملکرد پیش‌فرض، رمزگشایی پاسخ برای تمام توصیف‌کننده‌های ارجاع سگمنت داده
       کاربر (user data segment referral descriptors) است. مقدار خروجی را
       می‌توان با گزینه‌های --lba و --one-segment کاهش داد.

گزینه‌ها (OPTIONS)
       آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.

       -h, --help
              نمایش پیام راهنما و سپس خروج.

       -H, --hex
              چاپ پاسخ این دستور به صورت هگزادسیمال ASCII.

       -l, --lba=LBA
              که در آن LBA آدرس بلوک منطقی (Logical Block Address) در نخستین
              سگمنت داده کاربر است که DEVICE باید داده‌های پارامتر ارجاعات را
              برای آن گزارش دهد.

       -m, --maxlen=LEN
              که در آن LEN (حداکثر) طول پاسخ بر حسب بایت است. این مقدار در
              فیلد "allocation length" (طول تخصیص) از cdb قرار می‌گیرد. اگر
              داده نشود، از 256 استفاده می‌شود. مقدار 256 فضای کافی برای سرآیند
              پاسخ و توصیف‌کننده‌های سگمنت داده کاربر است.

       -s, --one-segment
              تنها سگمنت داده کاربرِ مشخص‌شده توسط پارامتر LBA را گزارش می‌دهد.

       -r, --raw
              خروجی پاسخ به صورت باینری (به stdout).

       -R, --readonly
              دستگاه DEVICE را به صورت فقط‌خواندنی باز می‌کند (مثلاً در یونیکس با
              پرچم O_RDONLY). حالت پیش‌فرض، باز کردن آن به صورت خواندن-نوشتن
              است.

       -v, --verbose
              افزایش سطح پرگویی (یعنی خروجی اشکال‌زدایی). خروجی‌های اضافی ناشی
              از این گزینه به stderr فرستاده می‌شوند.

       -V, --version
              چاپ رشته نسخه و سپس خروج.

نکات (NOTES)
       برای بررسی و بحث پیرامون ارجاعات (referrals) به بخش ۴.۲۵ از سند
       sbc3r25.pdf در https://www.t10.org (یا بخش مربوطه در پیش‌نویس‌های بعدی)
       مراجعه کنید.

وضعیت خروج (EXIT STATUS)
       وضعیت خروج sg_referrals در صورت موفقیت 0 است. در غیر این صورت به صفحه
       راهنمای sg3_utils(8) مراجعه کنید.

نویسندگان (AUTHORS)
       نوشته‌شده توسط Douglas Gilbert و Hannes Reinecke.

گزارش باگ‌ها (REPORTING BUGS)
       گزارش باگ‌ها به <dgilbert at interlog dot com>.

حق نشر (COPYRIGHT)
       Copyright © 2009-2014 Douglas Gilbert and Hannes Reinecke
       این نرم‌افزار تحت مجوز BSD-2-Clause توزیع شده است. هیچ تضمینی وجود
       ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

همچنین ببینید (SEE ALSO)
       sg_vpd(8)

sg3_utils-1.39                      مه 2014                    SG_REFERRALS(8)