.TH SG_GET_CONFIG "8" "December 2012" "sg3_utils\-1.35" SG3_UTILS
.SH "نام (NAME)"
sg_get_config \- ارسال دستور SCSI GET CONFIGURATION (MMC\-4 به بعد)
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_get_config
[\fI\-\-brief\fR] [\fI\-\-current\fR] [\fI\-\-help\fR] [\fI\-\-hex\fR]
[\fI\-\-inner\-hex\fR] [\fI\-\-list\fR] [\fI\-\-raw\fR] [\fI\-\-readonly\fR]
[\fI\-\-rt=RT\fR] [\fI\-\-starting=FC\fR] [\fI\-\-verbose\fR]
[\fI\-\-version\fR] \fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
یک دستور SCSI GET CONFIGURATION را به \fIDEVICE\fR ارسال کرده و پاسخ را رمزگشایی می‌کند. پاسخ شامل ویژگی‌ها (features) و نمایه‌های (profiles) دستگاه است. معمولاً این دستگاه‌ها پخش‌کننده‌های CD، DVD، HD\-DVD و BD هستند که ممکن است رسانه‌ای در آن‌ها قرار داشته باشد یا نداشته باشد. این دستگاه‌ها ممکن است از طریق رابط‌های ارتباطی ATAPI، USB یا IEEE 1394 متصل شده باشند. در چنین مواردی، آن‌ها فقط از این جهت دستگاه‌های «SCSI» هستند که از مجموعه «دستورات چندرسانه‌ای» (MMC یا Multi\-Media command) استفاده می‌کنند. MMC یک مجموعه دستور تخصصی SCSI است که تعریف آن را می‌توان در وب‌سایت https://www.t10.org یافت.
.PP
این ابزار بر اساس پیش‌نویس استانداردهای MMC\-4 و نسخه‌های بعد از آن توسعه یافته است. برای اطلاعات بیشتر درباره پارامترها و نمایه‌های ویژگی‌های خاص، به بخش ۵ با عنوان «ویژگی‌ها و نمایه برای دستگاه‌های چندرسانه‌ای» (Features and Profile for Multi_Media devices) مراجعه کنید. دفترچه راهنمای ارائه‌شده توسط سازنده محصول نیز ممکن است مفید باشد.
.PP
از آنجا که رایترهای مدرن DVD و BD از ویژگی‌ها و نمایه‌های متعددی پشتیبانی می‌کنند، خروجی رمزگشایی‌شده از این ابزار می‌تواند بسیار حجیم باشد. روش‌های مختلفی برای کاستن از حجم خروجی وجود دارد. اگر از گزینه \fI\-\-brief\fR استفاده شود، فقط نام ویژگی‌ها نمایش داده شده و پارامترهای آن‌ها رمزگشایی نمی‌شوند. از سوی دیگر، اگر فقط یک ویژگی مد نظر باشد، این ترکیب از گزینه‌ها مناسب است: «\-\-rt=2 \-\-starting=\fIFC\fR». راهکار دیگر، نمایش تنها ویژگی‌های مربوط به رسانه موجود در درایو (یعنی ویژگی‌های «فعلی» یا "current") با استفاده از گزینه «\-\-rt=1» است.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز اجباری هستند.
.TP
\fB\-b\fR, \fB\-\-brief\fR
نام ویژگی‌ها را نشان می‌دهد اما پارامترهای آن ویژگی‌ها را رمزگشایی نمی‌کند.
در صورت استفاده به همراه \fI\-\-list\fR، نام ویژگی‌های شناخته‌شده را نمایش می‌دهد اما نام نمایه‌های شناخته‌شده را نمایش نمی‌دهد.
.TP
\fB\-c\fR, \fB\-\-current\fR
ویژگی‌هایی را که به عنوان فعلی (current) علامت‌گذاری شده‌اند خروجی می‌دهد. این گزینه معادل '\-\-rt=1' است.
.TP
\fB\-h\fR, \fB\-\-help\fR
پیام راهنمای استفاده را نمایش داده و سپس خارج می‌شود.
.TP
\fB\-H\fR, \fB\-\-hex\fR
پاسخ را به صورت هگزادسیمال نمایش می‌دهد (پاسخ را رمزگشایی نمی‌کند).
.TP
\fB\-i\fR, \fB\-\-inner\-hex\fR
تا سطح نام ویژگی رمزگشایی کرده و سپس داده‌های هر ویژگی را به صورت هگزادسیمال نمایش می‌دهد.
.TP
\fB\-l\fR, \fB\-\-list\fR
فهرست تمام نام‌های ویژگی‌ها و نمایه‌های شناخته‌شده را نمایش می‌دهد. نام دستگاه (در صورت ارائه) نادیده گرفته می‌شود.
صرفاً نام ویژگی‌ها و نمایه‌هایی (به همراه مقادیر هگزادسیمال آن‌ها) را که این ابزار می‌شناسد فهرست می‌کند. اگر \fI\-\-brief\fR نیز ارائه شود، فقط نام ویژگی‌ها فهرست می‌شوند.
.TP
\fB\-q\fR, \fB\-\-readonly\fR
دستگاه \fIDEVICE\fR را به جای حالت پیش‌فرض خواندن\-نوشتن، به صورت فقط‌خواندنی باز می‌کند. درایور sg در لینوکس برای دستور SCSI GET CONFIGURATION به دسترسی خواندن\-نوشتن نیاز دارد، اما سایر روش‌های دسترسی ممکن است به دسترسی فقط‌خواندنی احتیاج داشته باشند.
.TP
\fB\-r\fR, \fB\-\-rt\fR=\fIRT\fR
که در آن \fIRT\fR فیلدی با همین نام در cdb دستور GET CONFIGURATION است.
مقادیر مجاز 0، 1، 2 یا 3 هستند. عملکرد دستور به مقدار مشخص‌شده در گزینه \fI\-\-starting=FC\fR نیز بستگی دارد. مقدار پیش‌فرض 0 است.
هنگامی که \fIRT\fR برابر با 0 باشد، تمام ویژگی‌ها صرف‌نظر از فعلی بودن یا نبودن بازگردانده می‌شوند (ویژگی‌هایی که کد ویژگی آن‌ها بزرگ‌تر یا مساوی مقدار \fIFC\fR داده‌شده به \fI\-\-starting=\fR باشد). هنگامی که \fIRT\fR برابر با 1 باشد، تمام ویژگی‌های فعلی بازگردانده می‌شوند (ویژگی‌هایی که کد ویژگی آن‌ها بزرگ‌تر یا مساوی \fIFC\fR باشد). هنگامی که \fIRT\fR برابر با 2 باشد، ویژگی‌ای که کد آن برابر با \fIFC\fR است (در صورت وجود) بازگردانده می‌شود. هنگامی که \fIRT\fR برابر با 3 باشد، پاسخ رزرو شده است (احتمالاً منجر به خطای "illegal field in cdb" خواهد شد). برای ساده‌سازی، معانی مقادیر \fIRT\fR به شرح زیر است:
    \fB0\fR : تمام ویژگی‌ها، چه فعلی و چه غیرفعلی
    \fB1\fR : فقط ویژگی‌های فعلی
    \fB2\fR : فقط ویژگی با کد \fIFC\fR
    \fB3\fR : رزرو شده
.TP
\fB\-R\fR, \fB\-\-raw\fR
پاسخ را به صورت باینری (در stdout) خروجی می‌دهد. توجه داشته باشید که شکل کوتاه این گزینه برخلاف بیشتر ابزارهای دیگر این بسته که از \fI\-r\fR استفاده می‌کنند، \fI\-R\fR است.
.TP
\fB\-s\fR, \fB\-\-starting\fR=\fIFC\fR
که در آن \fIFC\fR مقدار کد ویژگی (feature code) است. این گزینه ارتباط نزدیکی با گزینه \fI\-\-rt=RT\fR دارد. مقدار \fIFC\fR در محدوده بین 0 تا 65535 (0xffff) است. مقدار پیش‌فرض آن 0 است. مقداری که با "0x" شروع شود (یا پسوند 'h' داشته باشد) به صورت هگزادسیمال تفسیر می‌شود.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
سطح پرگویی خروجی (یعنی خروجی اشکال‌زدایی) را افزایش می‌دهد.
.TP
\fB\-V\fR, \fB\-\-version\fR
رشته نسخه را چاپ کرده و سپس خارج می‌شود.
.SH "نکات (NOTES)"
چندین نسخه از پیش‌نویس استانداردهای MMC وجود دارد: MMC [1997]،‏ MMC\-2 [2000]،‏ MMC\-3 [2002]،‏ MMC\-4 و MMC\-5. سه مورد نخست اکنون استانداردهای ANSI INCITS هستند که سال تبدیل شدن آن‌ها به استاندارد در قلاب‌ها مشخص شده است. پیش‌نویس دقیقاً پیش از استانداردسازی را می‌توان در https://www.t10.org یافت. در نسخه اولیه استاندارد MMC، دستور GET CONFIGURATION وجود نداشت و اطلاعات مربوطه از «صفحه حالت قابلیت‌های CD و وضعیت مکانیکی» (صفحه حالت 0x2a) به دست می‌آمد. این صفحه بعداً به «صفحه حالت قابلیت‌های MM و وضعیت مکانیکی» تغییر نام یافت و در MMC\-4 و MMC\-5 منسوخ اعلام شد. دستور GET CONFIGURATION در MMC\-2 معرفی شد و جایگزینی برای آن صفحه حالت گردید. ویژگی‌های جدیدتر نظیر پشتیبانی از نوع رسانه "BD" (بلوری) تنها با استفاده از دستور GET CONFIGURATION قابل دسترسی هستند. بنابراین، پخش‌کننده‌های قدیمی‌تر CD ممکن است از دستور GET CONFIGURATION پشتیبانی نکنند که در این صورت می‌توان صفحه حالت "MM capabilities ..." را با ابزارهای sdparm(8)،‏ sginfo(8) یا sg_modes(8) بررسی کرد.
.PP
در سری هسته‌های ۲.۴ لینوکس، \fIDEVICE\fR باید یک دستگاه SCSI generic (sg) باشد. در سری ۲.۶ دستگاه‌های بلوکی (block devices) را نیز می‌توان مشخص کرد. برای نمونه، دستور "sg_get_config /dev/hdc" در هسته‌های سری ۲.۶ تا زمانی که dev/hdc/ یک دستگاه ATAPI باشد به درستی کار خواهد کرد. در هسته‌های سری ۲.۶ رایترهای خارجی DVD که از طریق USB متصل شده‌اند را می‌توان به عنوان مثال با "sg_get_config /dev/scd1" مورد پرس‌وجو قرار داد.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_get_config در صورت موفقیت برابر با 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش باگ‌ها به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2004\-2012 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع شده است. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.B sginfo(8), sg_modes(8), sg_inq(8), sg_prevent(8),
.B sg_start(8) [همگی در sg3_utils],
.B sdparm(8)