نام (NAME)

sg_scan - دستگاه‌های sg (یا دستگاه‌های SCSI/ATAPI/ATA) را پویش کرده و نتایج را چاپ می‌کند

خلاصه دستور (SYNOPSIS)

sg_scan [-a] [-i] [-n] [-w] [-x] [DEVICE]*

توضیحات (DESCRIPTION)

اگر نام هیچ DEVICE (دستگاهی) مشخص نشده باشد، sg_scan دستگاه‌های sg را پویش کرده و برای هر دستگاه sg که در حال حاضر به یک دستگاه SCSI متصل است، یک سطر اطلاعات چاپ می‌کند. اگر یک یا چند DEVICE داده شده باشد، تنها همان دستگاه‌ها پویش می‌شوند. هر دستگاه با پرچم O_NONBLOCK باز می‌شود تا پویش روی دستگاهی که پردازه دیگری قفل O_EXCL روی آن دارد، معلق (hang) نشود.

انتظار می‌رود هر نام DEVICE داده‌شده (تا حدی) با مدل معماری ذخیره‌سازی (SAM، به www.t10.org مراجعه کنید) سازگار باشد. هر نام دستگاه مرتبط با زیرسیستم SCSI لینوکس (مانند /dev/sda و /dev/st0m) مناسب است. همچنین نام‌های دستگاه مرتبط با دستگاه‌های ATAPI (مانند بیشتر درایوهای CD/DVD و درایوهای نوار مغناطیسی ATAPI) مناسب هستند. اگر دستگاه در دسته‌های بالا قرار نگیرد، دستور ATA IDENTIFY امتحان می‌شود.

در هسته‌های سری 2.6 و 3 لینوکس، ابزار lsscsi می‌تواند مفید باشد. این ابزار علاوه بر ارائه اطلاعات بیشتر (از طریق داده‌کاوی در سیستم‌فایل مجازی sysfs)، نیازی به دسترسی‌های ریشه (مدیر سیستم) برای اجرا ندارد، در حالی که این ابزار معمولاً به آن نیاز دارد.

گزینه‌ها (OPTIONS)

-a

انجام پویش الفبایی (یعنی sga، sgb، sgc). توجه داشته باشید که گره‌های دستگاه sg با شاخص الفبایی از سری 2.2 هسته لینوکس به بعد منسوخ شده‌اند.

-i

ارسال دستور SCSI INQUIRY و خروجی دادن نتایج در سطر دوم (با تورفتگی). اگر دستگاه یک دیسک ATA باشد، اطلاعات حاصل از دستور ATA IDENTIFY خروجی داده می‌شود.

-n

انجام پویش عددی (یعنی sg0، sg1 و...) [پیش‌فرض].

-w

استفاده از پرچم خواندن/نوشتن (read/write) هنگام باز کردن دستگاه sg (پیش‌فرض فقط‌خواندنی است).

-x

خروجی دادن اطلاعات تکمیلی درباره صف‌بندی (queueing).

نکات (NOTES)

این ابزار در زمانی نوشته شده است که اتصال گرم (hotplugging) دستگاه‌های SCSI در لینوکس پشتیبانی نمی‌شد. این ابزار از یک الگوریتم ساده برای پویش گره‌های دستگاه sg به ترتیب صعودی عددی یا الفبایی استفاده می‌کرد که پس از رخ دادن ۴ خطای متوالی متوقف می‌شد.

در سری 2.6 هسته لینوکس، این ابزار از sysfs برای یافتن گره‌های فعال دستگاه sg استفاده می‌کند و تنها آن‌ها را بررسی می‌نماید. بنابراین ممکن است «شکاف‌های» بزرگی در شماره‌گذاری گره‌های دستگاه sg وجود داشته باشد (برای نمونه پس از حذف یک آداپتور) و با این حال همچنان تمامی گره‌های فعال دستگاه sg فهرست شوند. این ابزار فرض می‌کند گره‌های دستگاه sg طبق قواعد نام‌گذاری معمول نام‌گذاری شده‌اند و بازه /dev/sg0 تا /dev/sg4095 را به‌طور کامل جستجو می‌کند.

وضعیت خروج (EXIT STATUS)

وضعیت خروج sg_scan در صورت موفقیت برابر 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه کنید.

نویسندگان (AUTHORS)

نوشته‌شده توسط D. Gilbert و F. Jansen

حق نشر (COPYRIGHT)

حق نشر © 1999-2013 Douglas Gilbert
این نرم‌افزار تحت مجوز GPL نسخه ۲ توزیع می‌شود. هیچ‌گونه ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.

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

lsscsi(8)