.TH SG_REP_DENSITY "8" "June 2023" "sg3_utils\-1.48" SG3_UTILS
.SH "نام (NAME)"
sg_rep_density \- ارسال دستور SCSI REPORT DENSITY SUPPORT
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_rep_density
[\fI\-\-help\fR] [\fI\-\-hex\fR] [\fI\-\-inhex=FN\fR] [\fI\-\-maxlen=LEN\fR]
[\fI\-\-media\fR] [\fI\-\-raw\fR] [\fI\-\-readonly\fR] [\fI\-\-typem\fR]
[\fI\-\-verbose\fR] [\fI\-\-version\fR]
\fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
دستور SCSI REPORT DENSITY را به \fIDEVICE\fR ارسال کرده و داده‌های بازگردانده‌شده را نمایش می‌دهد. این دستور مختص درایو نوار (tape drive) است. این دستور در پیش‌نویس استاندارد SSC\-5، بازنگری ۶ (ssc5r06.pdf) وجود دارد. این دستور در استاندارد SSC\-2 نیز موجود بود (ANSI INCITS 380\-2003).
.PP
به‌طور پیش‌فرض، این ابزار توصیف‌گرهای کد چگالی پشتیبانی‌شده توسط \fIDEVICE\fR (مانند یک درایو نوار) را درخواست کرده و پاسخ را رمزگشایی می‌کند. اگر گزینه \fI\-\-typem\fR مشخص شود، توصیف‌گرهای نوع رسانه پشتیبانی‌شده توسط \fIDEVICE\fR را واکشی کرده و پاسخ را رمزگشایی می‌کند. هنگامی که گزینه \fI\-\-media\fR مشخص شود، توصیف‌گرهای کد چگالی یا نوع رسانه پشتیبانی‌شده توسط رسانه درون \fIDEVICE\fR (مانند یک کارتریج نوار) واکشی می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنمای نحوه استفاده و سپس خروج.
.TP
\fB\-H\fR, \fB\-\-hex\fR
خروجی دادن پاسخ به صورت هگزادسیمال در خروجی استاندارد (stdout). با یک بار استفاده، کل پاسخ به صورت هگزادسیمال ASCII نمایش داده می‌شود که در ابتدای هر خط با یک نشانی (شروع از 0) مشخص شده است. با دو بار استفاده، کل پاسخ به صورت هگزادسیمال بدون نشانی در ابتدای هر خط خروجی داده می‌شود.
.br
سه بار استفاده از این گزینه، خروجی‌ای تولید می‌کند که می‌توان آن را به یک فایل هدایت کرد و بعداً با استفاده از گزینه \fI\-\-inhex=FN\fR به یک اجرای دیگر تحویل داد.
.TP
\fB\-i\fR, \fB\-\-inhex\fR=\fIFN\fR
که در آن \fIFN\fR نام فایلی است که فرض می‌شود محتویات آن هگزادسیمال ASCII است. اگر \fIDEVICE\fR نیز مشخص شده باشد، \fIDEVICE\fR نادیده گرفته می‌شود، یک هشدار صادر شده و ابزار با رمزگشایی فایل \fIFN\fR ادامه می‌دهد. برای اطلاعات بیشتر به بخش "HEX, BINARY AND JSON FORMATS" در صفحه راهنمای sg3_utils مراجعه کنید. اگر گزینه \fI\-\-raw\fR نیز مشخص شده باشد، محتوای \fIFN\fR به صورت باینری پردازش می‌شود.
.TP
\fB\-m\fR, \fB\-\-maxlen\fR=\fILEN\fR
که در آن \fILEN\fR (حداکثر) طول پاسخ بر حسب بایت است. این مقدار در فیلد "allocation length" از cdb قرار می‌گیرد. در صورت مشخص نشدن (یا اگر \fILEN\fR صفر باشد)، از 8192 استفاده می‌شود. حداکثر مقدار مجاز برای \fILEN\fR برابر 65535 است.
.TP
\fB\-M\fR, \fB\-\-media\fR
بیت MEDIA را در cdb تنظیم می‌کند که باعث می‌شود کدهای چگالی (یا انواع رسانه) پشتیبانی‌شده توسط کارتریج نوار موجود در درایو در پاسخ قرار گیرند. رفتار پیش‌فرض درخواست کدهای چگالی (یا انواع رسانه) پشتیبانی‌شده توسط خود درایو نوار است.
.br
اگر هیچ «رسانه‌ای» (مانند کارتریج نوار) در درایو وجود نداشته باشد، دستور SCSI با کلید حس (sense key) "not ready" با خطا مواجه خواهد شد.
.TP
\fB\-r\fR, \fB\-\-raw\fR
خروجی دادن پاسخ SCSI (یعنی بافر data\-out) به صورت باینری (در stdout)، مگر اینکه گزینه \fI\-\-inhex=FN\fR داده شده باشد.
.br
هنگام استفاده همراه با گزینه \fI\-\-inhex=FN\fR، محتوای \fIFN\fR به جای هگزادسیمال به صورت باینری پردازش می‌شود.
.TP
\fB\-R\fR, \fB\-\-readonly\fR
باز کردن \fIDEVICE\fR به صورت فقط‌خواندنی (مانند پرچم O_RDONLY در یونیکس). حالت پیش‌فرض، باز کردن آن به صورت خواندن\-نوشتن است.
.TP
\fB\-t\fR, \fB\-\-typem\fR
بیت MEDIUM TYPE را در cdb تنظیم می‌کند که باعث می‌شود انواع رسانه پشتیبانی‌شده توسط درایو نوار (یا کارتریج نوار) در پاسخ قرار گیرند. حالت پیش‌فرض درخواست کدهای چگالی است.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح پرگویی (یعنی خروجی اشکال‌زدایی).
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ رشته نسخه و سپس خروج.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_rep_density در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها را به <dgilbert at interlog dot com> ارسال کنید.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2022\-2023 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع شده است. هیچ تضمینی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sg3_utils(sg3_utils)