نام (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)

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

sg_vpd(8)