.TH SG_SCAN "8" "May 2013" "sg3_utils\-1.36" SG3_UTILS
.SH "نام (NAME)"
sg_scan \- دستگاه‌های sg (یا دستگاه‌های SCSI/ATAPI/ATA) را پویش کرده و نتایج را چاپ می‌کند
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_scan
[\fI\-a\fR]
[\fI\-i\fR]
[\fI\-n\fR]
[\fI\-w\fR]
[\fI\-x\fR]
[\fIDEVICE\fR]*
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
اگر نام هیچ
\fIDEVICE\fR
(دستگاهی) مشخص نشده باشد،
.B sg_scan
دستگاه‌های sg را پویش کرده و برای هر دستگاه sg که در حال حاضر به یک دستگاه SCSI متصل است، یک سطر اطلاعات چاپ می‌کند. اگر یک یا چند
\fIDEVICE\fR
داده شده باشد، تنها همان دستگاه‌ها پویش می‌شوند.
هر دستگاه با پرچم
.B O_NONBLOCK
باز می‌شود تا پویش روی دستگاهی که پردازه دیگری قفل
.B O_EXCL
روی آن دارد، معلق (hang) نشود.
.PP
انتظار می‌رود هر نام
\fIDEVICE\fR
داده‌شده (تا حدی) با مدل معماری ذخیره‌سازی (SAM، به www.t10.org مراجعه کنید) سازگار باشد. هر نام دستگاه مرتبط با زیرسیستم SCSI لینوکس (مانند
.B /dev/sda
و
.BR /dev/st0m )
مناسب است. همچنین نام‌های دستگاه مرتبط با دستگاه‌های ATAPI (مانند بیشتر درایوهای CD/DVD و درایوهای نوار مغناطیسی ATAPI) مناسب هستند. اگر دستگاه در دسته‌های بالا قرار نگیرد، دستور
.B ATA IDENTIFY
امتحان می‌شود.
.PP
در هسته‌های سری 2.6 و 3 لینوکس، ابزار
.B lsscsi
می‌تواند مفید باشد. این ابزار علاوه بر ارائه اطلاعات بیشتر (از طریق داده‌کاوی در سیستم‌فایل مجازی sysfs)، نیازی به دسترسی‌های ریشه (مدیر سیستم) برای اجرا ندارد، در حالی که این ابزار معمولاً به آن نیاز دارد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR
انجام پویش الفبایی (یعنی sga، sgb، sgc). توجه داشته باشید که گره‌های دستگاه sg با شاخص الفبایی از سری 2.2 هسته لینوکس به بعد منسوخ شده‌اند.
.TP
\fB\-i\fR
ارسال دستور SCSI INQUIRY و خروجی دادن نتایج در سطر دوم (با تورفتگی). اگر دستگاه یک دیسک ATA باشد، اطلاعات حاصل از دستور ATA IDENTIFY خروجی داده می‌شود.
.TP
\fB\-n\fR
انجام پویش عددی (یعنی sg0، sg1 و...) [پیش‌فرض].
.TP
\fB\-w\fR
استفاده از پرچم خواندن/نوشتن (read/write) هنگام باز کردن دستگاه sg (پیش‌فرض فقط‌خواندنی است).
.TP
\fB\-x\fR
خروجی دادن اطلاعات تکمیلی درباره صف‌بندی (queueing).
.SH "نکات (NOTES)"
این ابزار در زمانی نوشته شده است که اتصال گرم (hotplugging) دستگاه‌های SCSI در لینوکس پشتیبانی نمی‌شد. این ابزار از یک الگوریتم ساده برای پویش گره‌های دستگاه sg به ترتیب صعودی عددی یا الفبایی استفاده می‌کرد که پس از رخ دادن ۴ خطای متوالی متوقف می‌شد.
.PP
در سری 2.6 هسته لینوکس، این ابزار از sysfs برای یافتن گره‌های فعال دستگاه sg استفاده می‌کند و تنها آن‌ها را بررسی می‌نماید. بنابراین ممکن است «شکاف‌های» بزرگی در شماره‌گذاری گره‌های دستگاه sg وجود داشته باشد (برای نمونه پس از حذف یک آداپتور) و با این حال همچنان تمامی گره‌های فعال دستگاه sg فهرست شوند. این ابزار فرض می‌کند گره‌های دستگاه sg طبق قواعد نام‌گذاری معمول نام‌گذاری شده‌اند و بازه
.B /dev/sg0
تا
.B /dev/sg4095
را به‌طور کامل جستجو می‌کند.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج
.B sg_scan
در صورت موفقیت برابر 0 است. در غیر این صورت به صفحه راهنمای
.BR sg3_utils (8)
مراجعه کنید.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط D. Gilbert و F. Jansen
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 1999\-2013 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز GPL نسخه ۲ توزیع می‌شود. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.BR lsscsi (8)