.TH SG_MAP "8" "2026-06-25" "sg3_utils\-1.49" SG3_UTILS
.SH "نام (NAME)"
sg_map \- نمایش نگاشت میان دستگاه‌های sg در لینوکس و سایر دستگاه‌های SCSI
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_map
[\fI\-a\fR] [\fI\-h\fR] [\fI\-i\fR] [\fI\-n\fR] [\fI\-scd\fR] [\fI\-sd\fR]
[\fI\-sr\fR] [\fI\-st\fR] [\fI\-V\fR] [\fI\-x\fR]
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
گاهی اوقات تشخیص این‌که نام یک دستگاه sg (مانند /dev/sg0) به کدام دستگاه SCSI اشاره دارد دشوار است. این دستور در میان دستگاه‌های sg پیمایش کرده و نام دستگاه متناظر دیسک، cdrom یا نوار (tape) مبتنی بر SCSI را (در صورت وجود) پیدا می‌کند. اسکنرها نمونه‌ای از دستگاه‌های SCSI هستند که به جز نام دستگاه sg خود، هیچ نام دستگاه SCSI جایگزینی ندارند.
.PP
این ابزار منسوخ شده است و سال‌هاست که به‌روزرسانی نشده است؛ تنها اشکالات بسیار مشهود آن برطرف خواهند شد. مگر در شرایطی که از نسخه بسیار قدیمی لینوکس (مانند سری ۲.۴ یا قبل از آن) استفاده شود، لطفاً از ابزاری مانند
.BR lsscsi (8)
یا امکانات ارائه‌شده توسط
.BR udev (8)
استفاده کنید.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-a\fR
فرض می‌کند دستگاه‌های sg دارای نام‌های الفبایی هستند و میان
.BR /dev/sga ،
.B /dev/sgb
و غیره پیمایش می‌کند. حالت پیش‌فرض، پویش عددی است. توجه داشته باشید که گره‌های دستگاه sg با شاخص الفبایی از زمان سری ۲.۲ هسته لینوکس منسوخ شده‌اند.
.TP
\fB\-h\fR
پیام راهنمای نحوه استفاده را چاپ کرده و خارج می‌شود.
.TP
\fB\-i\fR
علاوه بر این، یک پرس‌وجوی استاندارد INQUIRY انجام می‌دهد و رشته‌های سازنده (vendor)، محصول (product) و نسخه بازبینی (revision) را برای دستگاه‌های یافت‌شده در خروجی نمایش می‌دهد.
.TP
\fB\-n\fR
فرض می‌کند دستگاه‌های sg دارای نام‌های عددی هستند و میان
.BR /dev/sg0 ،
.B /dev/sg1
و غیره پیمایش می‌کند. حالت پیش‌فرض، پویش عددی است.
.TP
\fB\-scd\fR
نگاشت‌ها را به نام دستگاه‌های cdrom مبتنی بر SCSI به شکل
.BR /dev/scd0 ،
.B /dev/scd1
و غیره نمایش می‌دهد.
.TP
\fB\-sd\fR
نگاشت‌ها را به نام دستگاه‌های دیسک SCSI نمایش می‌دهد.
.TP
\fB\-sr\fR
نگاشت‌ها را به نام دستگاه‌های cdrom مبتنی بر SCSI به شکل
.BR /dev/sr0 ،
.B /dev/sr1
و غیره نمایش می‌دهد.
.TP
\fB\-st\fR
نگاشت‌ها را به نام دستگاه‌های نوار مغناطیسی (tape) مبتنی بر SCSI را نمایش می‌دهد.
.TP
\fB\-V\fR
رشته نسخه برنامه را چاپ کرده و سپس بی‌درنگ خارج می‌شود.
.TP
\fB\-x\fR
پس از نمایش نام هر دستگاه فعال sg، پنج عدد نمایش داده می‌شود:
.IR <host_number>\ <bus>\ <scsi_id>\ <lun>\ <scsi_type>
.SH "نکات (NOTES)"
اگر هیچ گزینه‌ای که با
.B \-s
آغاز شود داده نشود، نگاشت به تمام نام‌های دستگاه‌های دیسک، cdrom و نوار SCSI نمایش داده می‌شود.
.PP
در صورتی که سیستم‌فایل دستگاه (devfs) موجود باشد، خطی برای اطلاع‌رسانی این موضوع در خروجی نمایش می‌یابد. سلسله‌مراتب بومی SCSI در devfs برقراری ارتباط میان نام یک دستگاه sg و هر نام دستگاه متناظر دیسک، cdrom یا نوار را آسان می‌سازد. این امر نیاز به این دستور را برطرف می‌کند. با این حال بسیاری از برنامه‌ها همچنان در مکان‌های سنتی خود به دنبال نام دستگاه‌های SCSI لینوکس می‌گردند. [سامانه devfs یک دیمن سازگاری به نام devfsd ارائه می‌دهد که پیکربندی پیش‌فرض آن، نام‌های دستگاه‌های لینوکس را در مکان‌های سنتی‌شان بازمی‌گرداند.]
.PP
در اغلب اوقات اطلاعات نگاشت را می‌توان با مشاهده خروجی دستور «sg_map» به دست آورد. با این وجود، اگر دستگاه‌هایی پس از راه‌اندازی سیستم اضافه شده باشند، این خروجی ممکن است گمراه‌کننده باشد.
.PP
در سری ۲.۶ هسته لینوکس، چیزی نزدیک به نگاشت نمایش‌داده‌شده توسط این ابزار را می‌توان با تحلیل sysfs پیدا کرد. تفاوت اصلی در این است که تحلیل sysfs، نگاشت میان گره‌های sg و سایر گره‌های دستگاه‌های SCSI را بر حسب شماره‌های ماژور (اصلی) و مینور (فرعی) نشان می‌دهد. در حالی که ماژور ۸، مینور ۱۶ معمولاً
.B /dev/sdb
خواهد بود، اما این موضوع لزوماً همواره برقرار نیست. امکانات مرتبط با udev ممکن است نام گره دستگاه دیگری را به ماژور ۸، مینور ۱۶ اختصاص دهند. این نسخه از
.B sg_map
گسترش یافته است تا با نام‌های گره‌های دستگاه دیسک پراکنده به شکل
.RI "/dev/sd" <str>
سازگار باشد که در آن
.I <str>
می‌تواند یکی از [a\-z,aa\-zz,aaa\-zzz] باشد. برای روشی دقیق‌تر (یعنی با پویش کمتر دایرکتوری‌ها) جهت نگاشت میان نام دستگاه‌های sg و نام‌های سطح بالاتر، از جمله یافتن نام‌های تعریف‌شده توسط کاربر، به ابزار
.B sg_map26
مراجعه کنید.
.PP
این ابزار در زمانی نوشته شده است که اتصال گرم (hotplugging) دستگاه‌های SCSI در لینوکس پشتیبانی نمی‌شد. این برنامه از یک الگوریتم ساده برای پویش گره‌های دستگاه sg به ترتیب صعودی عددی یا الفبایی استفاده می‌کرد که پس از وقوع ۵ خطای متوالی متوقف می‌شد.
.PP
در سری ۲.۶ هسته لینوکس، این ابزار از sysfs استفاده می‌کند تا مشخص کند کدام گره‌های دستگاه sg فعال هستند و تنها همان‌ها را بررسی می‌کند. بنابراین ممکن است «شکاف‌های» بزرگی در شماره‌گذاری گره‌های دستگاه sg وجود داشته باشد (برای نمونه پس از حذف یک آداپتور) و با این حال همه گره‌های فعال دستگاه sg فهرست شوند. این ابزار فرض می‌کند گره‌های دستگاه sg با استفاده از قراردادهای معمول نام‌گذاری شده‌اند و بازه
.B /dev/sg0
تا
.B /dev/sg4095
(شامل هر دو) را جستجو می‌کند.
.SH "مثال‌ها (EXAMPLES)"
سیستم فرضی دارای یک دیسک SCSI، یک نویسنده سی‌دی (cd writer) و یک پخش‌کننده دی‌وی‌دی است:
.PP
.nf
   $ sg_map
   # Note: the devfs pseudo file system is present
   /dev/sg0  /dev/sda
   /dev/sg1  /dev/sr0
   /dev/sg2  /dev/sr1
.fi
.PP
برای یافتن اینکه کدام نام دستگاه sg با دیسک مطابقت دارد:
.PP
.nf
   $ sg_map \-sd
   # Note: the devfs pseudo file system is present
   /dev/sg0  /dev/sda
   /dev/sg1
   /dev/sg2
.fi
.PP
گزینه
.B \-x
خروجی زیر را ارائه می‌دهد:
.PP
.nf
   sg_map \-x
   # Note: the devfs pseudo file system is present
   /dev/sg0  1 0 1 0  0  /dev/sda
   /dev/sg1  2 0 4 0  5  /dev/sr0
   /dev/sg2  2 0 6 0  5  /dev/sr1
.fi
.PP
هنگامی که یک اسکنر SCSI اضافه می‌شود خروجی به صورت زیر خواهد بود:
.PP
.nf
   $ sg_map
   # Note: the devfs pseudo file system is present
   /dev/sg0  /dev/sda
   /dev/sg1  /dev/sr0
   /dev/sg2  /dev/sr1
   /dev/sg3
.fi
.PP
با روش حذف،
.B /dev/sg3
باید همان اسکنر باشد.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج
.B sg_map
در صورت موفقیت 0 است. در غیر این صورت به صفحه راهنمای
.BR sg3_utils (8)
مراجعه کنید.
.SH "نویسنده (AUTHOR)"
نوشته‌شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش اشکالات به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2000\-2026 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز GPL نسخه ۲ توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا تناسب با یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.BR sg_map26 (8),
.BR scsi_info (8),
.BR scsidev (8),
.BR devfsd (8),
.BR lsscsi (8),
.BR udev (7)