.TH SG_READ_ATTR "8" "December 2020" "sg3_utils\-1.46" SG3_UTILS
.SH "نام (NAME)"
sg_read_attr \- ارسال دستور SCSI READ ATTRIBUTE
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_read_attr
[\fI\-\-cache\fR] [\fI\-\-enumerate\fR] [\fI\-\-ea=EA\fR]
[\fI\-\-filter=FL\fR] [\fI\-\-first=FAI\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR]
[\fI\-\-in=FN\fR] [\fI\-\-lvn=LVN\fR] [\fI\-\-maxlen=LEN\fR] [\fI\-\-pn=PN\fR]
[\fI\-\-quiet\fR] [\fI\-\-raw\fR] [\fI\-\-readonly\fR] [\fI\-\-sa=SA\fR]
[\fI\-\-verbose\fR] [\fI\-\-version\fR] \fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
دستور SCSI READ ATTRIBUTE را به \fIDEVICE\fR ارسال می‌کند و داده‌های بازگردانده‌شده را نمایش می‌دهد. این دستور در بازنگری ۱ از استاندارد SPC\-3 معرفی شد و بنابراین برای تمام دستگاه‌های SCSI قابل اعمال است. در عمل عمدتاً برای سامانه‌های نوار مغناطیسی (tape) استفاده می‌شود. این ابزار بر اساس پیش‌نویس استاندارد SPC\-5، بازنگری ۱۷ (spc5r17.pdf) تهیه شده است.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.
.TP
\fB\-c\fR, \fB\-\-cache\fR
بیت CACHE را در cdb دستور READ ATTRIBUTE تنظیم می‌کند. این کار به سرور دستگاه دستور می‌دهد که ویژگی‌های کش‌شده را بازگرداند. به‌طور پیش‌فرض این بیت پاک است (صفر است) که به سرور دستگاه دستور می‌دهد ویژگی‌های کش‌شده را بازنگرداند.
.TP
\fB\-e\fR, \fB\-\-enumerate\fR
تمام ویژگی‌ها و اکشن‌های سرویس شناخته‌شده را برمی‌شمارد (فهرست می‌کند). ویژگی‌ها شامل یک شناسه، طول، قالب و نام مطابق با تعریف T10 هستند. اگر \fIDEVICE\fR مشخص شده باشد، نادیده گرفته می‌شود.
.TP
\fB\-E\fR, \fB\-\-ea\fR=\fIEA\fR
که در آن \fIEA\fR آدرس عنصری (element address) است که در cdb دستور READ ATTRIBUTE قرار می‌گیرد. این فیلد تنها در پیش‌نویس‌های SMC\-2 و SMC\-3 برای تعویض‌کننده‌های رسانه (medium changers) که معمولاً با کتابخانه‌های نوار در ارتباط هستند یافت می‌شود. به‌طور پیش‌فرض این فیلد روی صفر تنظیم شده است.
.TP
\fB\-f\fR, \fB\-\-filter\fR=\fIFL\fR
که در آن \fIFL\fR یک شناسه ویژگی در بازه 0 تا 65535 یا \-1 است. شناسه‌های ویژگی معمولاً به صورت هگزادسیمال مشخص می‌شوند که در این صورت عدد هگز باید با پیشوند "0x" یا پسوند "h" همراه باشد. مقدار "\-1" مقدار پیش‌فرض است و به معنای «تطابق با همه» می‌باشد؛ برای سایر مقادیر \fIFL\fR فقط ویژگی مطابق خروجی داده می‌شود.
.TP
\fB\-F\fR, \fB\-\-first\fR=\fIFAI\fR
که در آن \fIFAI\fR فیلد «نخستین شناسه ویژگی» (first attribute identifier) در cdb است. به نظر می‌رسد هدف این فیلد این است که تنها ویژگی‌هایی بازگردانده شوند که شناسه‌های آن‌ها برابر یا بزرگ‌تر از \fIFAI\fR باشد. مقدار پیش‌فرض \fIFAI\fR صفر است. ویژگی‌ها به ترتیب صعودی شناسه بازگردانده می‌شوند.
.TP
\fB\-h\fR, \fB\-\-help\fR
پیام راهنمای استفاده را چاپ کرده و خارج می‌شود.
.TP
\fB\-H\fR, \fB\-\-hex\fR
پاسخ را به صورت هگزادسیمال به خروجی استاندارد می‌فرستد. هنگام یک بار استفاده، کل پاسخ به صورت هگزادسیمال ASCII همراه با آدرس در ابتدای هر خط (شروع از 0) چاپ می‌شود. هنگام دو بار استفاده، هر توصیف‌کننده ویژگی در پاسخ، جداگانه به صورت هگزادسیمال چاپ می‌شود. هنگام سه بار استفاده، کل پاسخ به صورت هگزادسیمال بدون آدرس در ابتدای خطوط چاپ می‌شود.
.br
خروجی تولیدشده توسط '\-HHH' (یا سه بار استفاده از \fI\-\-hex\fR) می‌تواند به یک فایل هدایت شود. آن فایل در قالبی مناسب برای استفاده توسط \fI\-\-in=FN\fR در فراخوانی‌های بعدی خواهد بود.
.TP
\fB\-i\fR, \fB\-\-in\fR=\fIFN\fR
با \fIFN\fR به عنوان نام یک فایل (یا '\-' برای stdin) رفتار می‌شود که حاوی داده‌های هگزادسیمال ASCII یا باینری نماینده پاسخ دستور READ ATTRIBUTE با اکشن سرویس 0x0 (یعنی دریافت مقادیر ویژگی‌ها) است. هنگامی که این گزینه داده شود، \fIDEVICE\fR (در صورت مشخص شدن) نادیده گرفته می‌شود.
.br
به‌طور پیش‌فرض فرض می‌شود \fIFN\fR حاوی داده‌های هگزادسیمال ASCII مرتب‌شده به صورت بایت‌هایی است که با فاصله، تب یا کاما جدا شده‌اند. تمام نویسه‌ها از «#» (شامل خود آن) تا انتهای خط نادیده گرفته می‌شوند. اگر گزینه \fI\-\-raw\fR نیز داده شود، فرض می‌شود \fIFN\fR حاوی داده‌های باینری است. هنگامی که گزینه \fI\-\-raw\fR داده شود، پس از پردازش ورودی، متغیر داخلی raw مجدداً روی 0 تنظیم می‌شود تا هیچ تأثیری بر خروجی نداشته باشد.
.br
از آنجا که پاسخ READ ATTRIBUTE شامل شماره اکشن سرویسی که این پاسخ در برابر آن صادر شده نیست، باید \fI\-\-sa=SA\fR داده شود (در غیر این صورت اکشن سرویس 0 یعنی مقادیر ویژگی‌ها فرض می‌شود).
.TP
\fB\-l\fR, \fB\-\-lvn\fR=\fILVN\fR
که در آن \fILVN\fR در فیلد «شماره حجم منطقی» (logical volume number) در cdb قرار می‌گیرد. مقدار پیش‌فرض صفر است؛ در صورتی که دستگاه تنها یک حجم داشته باشد، شماره حجم منطقی الزامی است که صفر باشد.
.TP
\fB\-m\fR, \fB\-\-maxlen\fR=\fILEN\fR
که در آن \fILEN\fR (حداکثر) طول پاسخ به بایت است. این مقدار در فیلد "allocation length" از cdb قرار می‌گیرد. اگر مشخص نشود (یا \fILEN\fR صفر باشد)، از 8192 استفاده می‌شود. حداکثر مقدار مجاز برای \fILEN\fR برابر با 1048576 است.
.TP
\fB\-p\fR, \fB\-\-pn\fR=\fIPN\fR
که در آن \fIPN\fR در فیلد «شماره پارتیشن» (partition number) در cdb قرار می‌گیرد. اگر \fIDEVICE\fR تنها یک پارتیشن داشته باشد، شماره پارتیشن آن باید صفر باشد. مقدار پیش‌فرض \fIPN\fR صفر است.
.TP
\fB\-q\fR, \fB\-\-quiet\fR
این گزینه مقدار اطلاعات خروجی را کاهش می‌دهد. برای مثال هنگام یک بار استفاده (\fISA\fR=0)، خط سرآیندی را که نمایش ویژگی‌ها را اعلام می‌کند پنهان می‌سازد؛ هنگامی که دو بار استفاده شود نام هر ویژگی را پنهان می‌کند و تنها مقادیر (یا رشته‌های) ویژگی متناظر را باقی می‌گذارد.
.TP
\fB\-r\fR, \fB\-\-raw\fR
پاسخ SCSI (یعنی بافر data\-out) را به صورت باینری (به خروجی استاندارد) می‌فرستد.
.TP
\fB\-R\fR, \fB\-\-readonly\fR
دستگاه \fIDEVICE\fR را به صورت فقط‌خواندنی باز می‌کند (مثلاً در یونیکس با پرچم O_RDONLY). حالت پیش‌فرض باز کردن آن به صورت خواندن\-نوشتن است.
.TP
\fB\-s\fR, \fB\-\-sa\fR=\fISA\fR
که در آن \fISA\fR در فیلد «اکشن سرویس» (service action) در cdb قرار می‌گیرد. مقادیر 0 تا 63 پذیرفته می‌شوند و مقدار پیش‌فرض 0 است. مستند spc5r08.pdf پنج اکشن سرویس را تعریف می‌کند: 0 برای مقادیر ویژگی‌ها (attribute values)؛ 1 برای فهرست ویژگی‌ها (نام‌ها، نه مقادیر)؛ 2 برای فهرست حجم‌های منطقی؛ 3 برای فهرست پارتیشن‌ها؛ 4 برای SMC\-3 رزرو شده است؛ و 5 برای فهرست ویژگی‌های پشتیبانی‌شده.
.br
همچنین می‌توان برای \fISA\fR از یک کوته‌نوشت استفاده کرد. این کوته‌نوشت برای اکشن‌های سرویس 0 تا 5 به ترتیب باید یکی از "av"، "al"، "lvl"، "pn"، "smc" یا "sa" باشد. کوته‌نوشت‌ها را می‌توان با حروف بزرگ نیز وارد کرد.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
سطح پرگویی خروجی (یعنی خروجی اشکال‌زدایی) را افزایش می‌دهد.
.TP
\fB\-V\fR, \fB\-\-version\fR
رشته نسخه را چاپ کرده و سپس خارج می‌شود.
.SH "نکات (NOTES)"
به نظر می‌رسد تنها سامانه‌های نوار مغناطیسی دستور SCSI READ ATTRIBUTE را پیاده‌سازی کرده‌اند. بخش عمده‌ای از تعریف آن در استاندارد SPC آمده است، بنابراین سایر انواع دستگاه‌ها نیز می‌توانند از آن استفاده کنند.
.PP
بسیاری از اطلاعات ارائه‌شده توسط READ ATTRIBUTE را می‌توان در صفحاتی که با LOG SENSE بازگردانده می‌شوند (ابزار sg_logs را ببینید) و در صفحات VPD بازگردانده‌شده توسط دستور INQUIRY نیز یافت.
.SH "مثال‌ها (EXAMPLES)"
برای فهرست کردن ویژگی‌های یک درایو نوار مغناطیسی که \fIDEVICE\fR آن /dev/sg1 است، می‌توان از دستور زیر استفاده کرد:
.PP
  # sg_read_attr \-s al /dev/sg1
  Attribute list:
    Remaining capacity in partition [MiB]
    Maximum capacity in partition [MiB]
    TapeAlert flags
    Load count
    MAM space remaining [B]
    Assigning organization
    Format density code
    ...
.PP
برای بررسی تعداد پارتیشن‌ها:
.PP
  # sg_read_attr \-s pl /dev/sg1
  Partition number list:
    First partition number: 0
    Number of partitions available: 2
.PP
و برای مشاهده مقادیر ویژگی‌ها (که اکشن سرویس پیش‌فرض است):
.PP
  # sg_read_attr /dev/sg1
  Attribute values:
    Remaining capacity in partition [MiB]: 1386103
    Maximum capacity in partition [MiB]: 1386103
    TapeAlert flags: 0
    ....
.PP
برای هدایت پاسخ مقادیر ویژگی‌ها به یک فایل جهت رمزگشایی در آینده:
.PP
  # sg_read_attr \-HHH /dev/sg1 > av.hex
.PP
و بعداً پاسخی که در فایل av.hex نگهداری می‌شود می‌تواند با دستور زیر رمزگشایی شود:
.PP
  # sg_read_attr \-s av \-\-in=av.hex
  Attribute values:
    Remaining capacity in partition [MiB]: 1386103
    Maximum capacity in partition [MiB]: 1386103
    TapeAlert flags: 0
    ....
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_read_attr در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
Copyright \(co 2016\-2020 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع شده است. هیچ تضمینی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sg_vpd,sg_logs(sg3_utils)