SG_MODES(8) SG3_UTILS SG_MODES(8)

sg_modes - خواندن صفحه‌های حالت با دستور SCSI MODE SENSE

sg_modes [--all] [--ALL] [--control=PC] [--dbd] [--dbout] [--examine] [--flexible] [--help] [--hex] [--list] [--llbaa] [--maxlen=LEN] [--multiple] [--page=PG[,SPG]] [--raw] [-R] [--readwrite] [--six] [--verbose] [--version] [DEVICE]

sg_modes [-6] [-a] [-A] [-c=PC] [-d] [-D] [-e] [-f] [-h] [-H] [-l] [-L] [-m=LEN] [-M] [-p=PG[,SPG]] [-r] [-subp=SPG] [-v] [-V] [-w] [-?] [DEVICE]

این ابزار دستور SCSI MODE SENSE را به DEVICE ارسال کرده و پاسخ را در خروجی نمایش می‌دهد. دو نوع ۶ بایتی و ۱۰ بایتی (cdb) از دستور MODE SENSE وجود دارد که این ابزار به صورت پیش‌فرض از نوع ۱۰ بایتی استفاده می‌کند. استانداردهای SPC-4 (و همچنین استاندارد SPC-5) اعلام کرده‌اند که پیاده‌سازان باید از دستورهای SCSI MODE SELECT(6) و MODE SENSE(6) به نفع انواع ۱۰ بایتی (مانند MODE SENSE(10)) مهاجرت کنند. در پیش‌نویس نگارش ۷ از استاندارد SPC-6، دستورهای SCSI MODE SELECT(6) و MODE SENSE(6) حذف شده‌اند.

این ابزار هدرهای صفحه حالت و توصیف‌گرهای بلوک را رمزگشایی می‌کند، اما محتوای هر صفحه حالت را به صورت هگزادسیمال (hex) در خروجی می‌آورد. همچنین هیچ امکانی برای تغییر محتوای صفحه حالت یا داده‌های توصیف‌گر بلوک ندارد. محتوای صفحه‌های حالت را می‌توان با استفاده از ابزار sdparm رمزگشایی کرد و تغییر داد.

این ابزار از دو نحو خط فرمان پشتیبانی می‌کند؛ نحو ترجیحی ابتدا در خلاصه دستور نشان داده شده و در این بخش توضیح داده شده است. بخش بعدی درباره نحو قدیمی خط فرمان، گروه دوم گزینه‌ها را شرح می‌دهد.

اگر هیچ صفحه‌ای مشخص نشود (و --list نیز انتخاب نشده باشد)، گزینه --all پیش‌فرض در نظر گرفته می‌شود. گزینه --all تمام صفحه‌های حالت (اما نه زیرصفحه‌ها) را در یک پاسخ واحد درخواست می‌کند.

آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.

نمایش تمام صفحه‌های حالت گزارش‌شده توسط DEVICE در خروجی. این همان کاری است که کد صفحه 63 (0x3f) برای انجام آن تعریف شده است. هنگامی که یک بار استفاده شود، زیرصفحه‌های حالت دریافت نمی‌شوند. هنگامی که دو بار استفاده شود (مانند «-aa»)، تمام صفحه‌های حالت و زیرصفحه‌ها درخواست می‌شوند که معادل «--page=63,255» است.
دارای همان معنای دو بار استفاده از گزینه --all است؛ به این معنی که تمام صفحه‌های حالت و زیرصفحه‌ها دریافت می‌شوند. حالت پیش‌فرض، دریافت تمام صفحه‌های حالت بدون زیرصفحه‌های حالت است.
مقدار PC مقدار کنترل صفحه (page control) است. دستگاه حداکثر چهار نسخه مختلف از هر صفحه را نگهداری می‌کند:
0 : مقدارهای جاری (یعنی مقدارهایی که در حال حاضر فعال هستند)
1 : مقدارهای قابل تغییر
2 : مقدارهای پیش‌فرض (یعنی تنظیمات سازنده)
3 : مقدارهای ذخیره‌شده
مقدارهای قابل تغییر، ماسک‌های بیتی هستند که نشان می‌دهند کدام فیلدها را می‌توان با یک دستور MODE SELECT تغییر داد. مقدارهای ذخیره‌شده در دفعه بعدی که دستگاه خاموش و روشن (power cycle) یا بازنشانی (reset) شود دوباره اعمال خواهند شد. اگر این گزینه داده نشود، مقدارهای جاری [0] فرض می‌شوند.
غیرفعال کردن توصیف‌گرهای بلوک (disable block descriptors). به طور پیش‌فرض، توصیف‌گرهای بلوک (معمولاً یکی (برای دیسک‌ها) یا هیچ) در پاسخ MODE SENSE بازگردانده می‌شوند. این گزینه بیت «disable block descriptors» (DBD) را در cdb تنظیم می‌کند که به دستگاه دستور می‌دهد هیچ توصیف‌گر بلوکی را در پاسخ خود بازنگرداند. دستگاه‌های قدیمی‌تر ممکن است از این تنظیم پشتیبانی نکنند و کلید حسگر «illegal request» را برگردانند؛ یا ممکن است آن را نادیده بگیرند. جالب توجه اینکه مجموعه دستورهای Reduced Block Commands (یا RBC) الزامی می‌داند که این بیت تنظیم باشد.
غیرفعال کردن خروجی توصیف‌گرهای بلوک. صرف‌نظر از اینکه توصیف‌گرهای بلوک در پاسخ موجود باشند یا نه، در خروجی نمایش داده نمی‌شوند.
اگر گزینه --page=PG[,SPG] داده نشده باشد، تمام صفحه‌های حالت در محدوده 0 تا 62 (شامل هر دو) بررسی می‌شوند. اگر گزینه --page=PG[,SPG] داده شده باشد، آن‌گاه تمام زیرصفحه‌هایی که کد صفحه آن‌ها PG است بررسی می‌شوند (زیرصفحه‌های 0 تا 254 (شامل هر دو)). در صورت دریافت هرگونه پاسخ، نام صفحه (یا زیرصفحه) حالت یا در صورت مشخص نبودن نام، شماره آن (به صورت هگزادسیمال) چاپ می‌شود.
ابزار sdparm که صفحه‌های حالت و VPD را فهرست می‌کند نیز دارای یک گزینه --examine با عملکرد مشابه است.
برخی دستگاه‌ها، پل‌ها (bridges) و/یا درایورها تلاش می‌کنند ترجمه‌های ناپخته‌ای بین دستورهای MODE SENSE ۶ بایتی و ۱۰ بایتی بدون تصحیح پاسخ انجام دهند. این امر موجب تفسیر نادرست پاسخ خواهد شد (معمولاً با خطایی مبنی بر اینکه پاسخ معیوب یا بدفرم است). با این گزینه، طول پاسخ بررسی می‌شود و اگر نادرست به نظر برسد، پاسخ به گونه‌ای رمزگشایی می‌شود که گویی دستور دیگرِ mode sense (طول cdb دیگر) ارسال شده است.
چاپ پیام راهنمای استفاده و سپس خروج.
از آن‌جا که این ابزار ساختار پاسخ دستور MODE SENSE (یعنی هدر پارامتر آن، صفر یا چند توصیف‌گر بلوک و به دنبال آن صفر یا چند صفحه حالت) را نشان می‌دهد اما بیشتر محتوای پاسخ را به صورت هگزادسیمال نمایش می‌دهد؛ هنگامی که این گزینه یک بار استفاده شود، تنها تفاوت این است که پس از نام صفحه حالت، در صورت شناخته‌شده بودن، شماره صفحه (و شماره زیرصفحه) آن در قلاب به صورت هگزادسیمال می‌آید.
هنگامی که این گزینه دو بار داده شود، هر خط از خروجی هگزادسیمال دارای یک نمایش اسکی (ASCII) از آن مقادیر هگزادسیمال در پایان هر خط خواهد بود. هنگامی که این گزینه سه بار داده شود، نشانی هگزادسیمال که در ابتدای هر خط هگزادسیمال نمایش داده می‌شود حذف شده، هیچ نمایش اسکی از هگزادسیمال وجود نخواهد داشت و تمام خطوط متنی حذف می‌شوند. این کار یک خروجی هگزادسیمال ساده و قابل تجزیه باقی می‌گذارد که نشان‌دهنده پاسخ دستور MODE SENSE است. بخش‌های تشکیل‌دهنده آن پاسخ در خطوط جداگانه قرار می‌گیرند.
هنگامی که این گزینه چهار بار یا بیشتر داده شود (که برای فرمت قابل تجزیه توصیه می‌شود)، خطوط اطلاعاتی اسکی بازمی‌گردند، اما همگی با «#» آغاز می‌شوند که یک تجزیه‌کننده باید آن‌ها را نادیده بگیرد. خروجی به stdout ارسال می‌شود در حالی که هرگونه پیام خطا یا هشدار به stderr فرستاده می‌شود. بنابراین تغییر مسیر ساده خط فرمان یونیکس از stdout به یک پرونده (که در بیشتر شل‌های یونیکس با «>» انجام می‌شود) برای گرفتن خروجی کافی خواهد بود. همان‌طور که در بالا اشاره شد، می‌توان بعداً با استفاده از ابزار sdparm و گزینه «--inhex=FN» آن، آن پرونده هگزادسیمال را رمزگشایی کرد.
تمام کدهای متداول صفحه و زیرصفحه و نام‌های آن‌ها را که در مجموعه دستورهای مطابق با نوع جانبی DEVICE داده‌شده یافت می‌شوند، فهرست می‌کند. اگر نه DEVICE و نه --page=PG داده نشده باشد، کدهای صفحه و زیرصفحه متداول و نام‌های آن‌ها برای SBC (مانند یک دیسک) فهرست می‌شوند. اگر هیچ DEVICE داده نشده باشد اما --page=PG مشخص شده باشد، کدهای متداول صفحه و زیرصفحه و نام‌های آن‌ها برای مجموعه دستوری که نوع دستگاه جانبی آن با مقدار داده‌شده به PG مطابقت دارد فهرست می‌شوند. برای نمونه «sg_modes --list --page=1» صفحه‌ها و زیرصفحه‌های حالت دستوری را برای دستگاه‌های نواری فهرست می‌کند. علاوه بر این، اگر یک sub_page_code داده شود، به عنوان یک شناسه انتقال (transport identifier) تفسیر شده و کدهای صفحه حالت و نام‌های مخصوص انتقالِ دستور، در ادامه فهرست اصلی صفحه‌های حالت فهرست می‌شوند. سایر گزینه‌ها نادیده گرفته می‌شوند.
بیت Long LBA Accepted (LLBAA) را در cdb دستور MODE SENSE (10) تنظیم می‌کند. این بیت در cdb دستور MODE SENSE (6) تعریف نشده است، بنابراین تنظیم گزینه‌های «-L» و «--six» به عنوان خطا گزارش می‌شود. در صورت تنظیم بودن، ممکن است DEVICE با توصیف‌گرهای بلوک ۱۶ بایتی همان‌طور که توسط فیلد «LongLBA» در پاسخ مشخص می‌شود، پاسخ دهد. در بیشتر موارد نیازی به تنظیم این گزینه نیست.
آرگومان LEN حداکثر طول پاسخ بر حسب بایت است. این مقدار همان فیلد «allocation length» (طول تخصیص) در cdb است. هنگامی که مشخص نشود (یا LEN صفر باشد)، فیلد طول تخصیص برای MODE SENSE (10) روی 4096 یا برای MODE SENSE (6) روی 252 تنظیم می‌شود. آرگومان LEN باید نامنفی و برای MODE SENSE (10) حداکثر 65535 و برای MODE SENSE (6) حداکثر 255 باشد.
برای هر صفحه حالت (و زیرصفحه حالت)، تمام کنترل‌های صفحه موجود را دریافت می‌کند. همان‌طور که در گزینه --control=PC شرح داده شده، ممکن است حداکثر تا چهار کنترل صفحه وجود داشته باشد. هدر پارامتر حالت و توصیف‌گرهای بلوک به همان شیوه معمول بدون این گزینه در خروجی نمایش داده می‌شوند. پس از خروجی نام صفحه حالت (و شماره‌های آن)، خطی شامل کنترل صفحه جاری (current)، قابل تغییر (changeable)، پیش‌فرض (default) یا ذخیره‌شده (saved) قرار می‌گیرد و به دنبال آن مقدار کنترل صفحه به صورت هگزادسیمال می‌آید.
اگر گزینه --control=PC داده شده باشد، توسط این گزینه بازنویسی و لغو می‌شود.
تغییر به گزینه‌های سبک قدیمی‌تر. لطفاً به عنوان اولین گزینه استفاده شود.
کد صفحه‌ای که باید دریافت شود. مقدار PG دهدهی فرض می‌شود مگر اینکه با «0x» شروع شود یا پسوند «h» داشته باشد. این مقدار باید عددی بین 0 و 63 (شامل هر دو) باشد. هنگامی که داده نشود و به مقدار پیش‌فرض نیاز باشد، مقدار 63 (0x3f) که تمام صفحه‌های حالت را دریافت می‌کند، استفاده می‌شود.
به عنوان روشی جایگزین می‌توان یک سرسرواژه (acronym) برای صفحه حالت مشخص کرد. سرسرواژه‌های موجود را می‌توان با گزینه --page=xxx فهرست کرد. این سرسرواژه‌ها تقریباً مشابه سرسرواژه‌های استفاده‌شده برای صفحه‌های حالت در ابزار sdparm هستند.
مقدارهای کد صفحه و کد زیرصفحه که باید دریافت شوند. هر دو آرگومان دهدهی فرض می‌شوند مگر اینکه به عنوان هگزادسیمال علامت‌گذاری شده باشند. کد صفحه باید بین 0 و 63 (شامل هر دو) باشد. کد زیرصفحه باید بین 0 و 255 (شامل هر دو) باشد. مقدار پیش‌فرض برای کد زیرصفحه 0 است.
ارسال پاسخ به صورت باینری به stdout. پیام‌های خطا و هشدارها (در صورت وجود) به stderr ارسال می‌شوند. هنگامی که این گزینه دو بار استفاده شود (مانند «-rr»)، عملکردی مشابه «-R» خواهد داشت.
نمایش صفحه حالت انتخاب‌شده در stdout به صورت یک بایت در هر خط. هر خط شامل دو رقم هگزادسیمال است (برای نمونه «3e»). این خروجی می‌تواند (پس از ویرایش) به عنوان ورودی برای ابزار sg_wr_mode(8) مفید باشد.
باز کردن DEVICE در حالت «خواندنی-نوشتنی» (read-write). حالت پیش‌فرض باز کردن آن در حالت فقط‌خواندنی است.
-6, -s, --six
به طور پیش‌فرض این ابزار یک دستور ۱۰ بایتی MODE SENSE را به DEVICE ارسال می‌کند. با این حال برخی دستگاه‌های SCSI تنها از دستورهای ۶ بایتی MODE SENSE پشتیبانی می‌کنند (مانند درایوهای نوار مغناطیسی SCSI-2). این پارامتر استفاده از دستورهای ۶ بایتی MODE SENSE را اجبار می‌کند.
افزایش سطح پرگویی خروجی. می‌تواند چندین بار استفاده شود.
چاپ رشته نسخه و سپس خروج.

اگر ابزار عادی sg_modes با خطای «illegal command operation code» شکست خورد، گزینه «--six» (یا «-6») را امتحان کنید.

این ابزار پیش از ارسال دستور MODE SENSE، یک دستور SCSI INQUIRY را برای تعیین نوع دستگاه جانبی (مثلاً 0 -> Direct Access Device (دیسک)) اجرا می‌کند. این کار به رمزگشایی توصیف‌گر بلوک و صفحه‌های حالت کمک می‌کند.

این ابزار به طور پیش‌فرض DEVICE را در حالت فقط‌خواندنی (برای نمونه در یونیکس با پرچم O_RDONLY) باز می‌کند. اگر گزینه --readwrite داده شود، DEVICE را در حالت خواندنی-نوشتنی باز خواهد کرد.

در سری هسته‌های ۲.۴ لینوکس، DEVICE باید یک دستگاه عمومی SCSI (sg) باشد. در سری ۲.۶ دستگاه‌های بلوکی (مانند دیسک‌های SCSI و درایوهای DVD) نیز می‌توانند مشخص شوند. برای نمونه «sg_modes -a /dev/sda» در هسته‌های سری ۲.۶ کار خواهد کرد.

هیچ خروجی JSON از این ابزار وجود ندارد زیرا خروجی اصلی آن صفحه‌های حالت به صورت هگزادسیمال است. بنابراین جدا از نام صفحه حالت و ساختار آن، چیزی رمزگشایی نمی‌شود. ابزار sdparm محتوای صفحه حالت را رمزگشایی کرده و از خروجی JSON پشتیبانی می‌کند.

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

گزینه‌های این بخش تنها گزینه‌های موجود پیش از نسخه ۱.۲۳ ابزار sg3_utils بودند. از آن زمان این ابزار به طور پیش‌فرض از گزینه‌های جدیدتر خط فرمان استفاده می‌کند که می‌توان با به‌کارگیری --old (یا -O) به عنوان اولین گزینه، آن‌ها را لغو و بازنویسی کرد. برای روشی دیگر جهت اجبار به استفاده از این گزینه‌های قدیمی‌تر خط فرمان، بخش «متغیرهای محیطی» را ببینید.

-6
به طور پیش‌فرض این ابزار یک دستور ۱۰ بایتی MODE SENSE را به DEVICE ارسال می‌کند. این پارامتر استفاده از دستورهای ۶ بایتی MODE SENSE را اجبار می‌کند. به توضیحات --six در بخش اصلی مراجعه کنید.
به توضیحات --all در بخش اصلی مراجعه کنید.
نمایش تمام صفحه‌های حالت و زیرصفحه‌های پشتیبانی‌شده توسط DEVICE در خروجی. معادل «--all --all» در نحو جدید است.
مقدار PC مقدار کنترل صفحه است. به توضیحات --control=PC در بخش اصلی مراجعه کنید.
به توضیحات --dbd در بخش اصلی مراجعه کنید.
به توضیحات --dbout در بخش اصلی مراجعه کنید.
به توضیحات --examine در بخش اصلی مراجعه کنید.
به توضیحات --flexible در بخش اصلی مراجعه کنید.
رفتار پیش‌فرض، رمزگشایی شماره‌های شناخته‌شده صفحه حالت (و شماره‌های زیرصفحه) به متن است. با این گزینه، شماره‌های صفحه حالت (و شماره‌های زیرصفحه) به صورت هگزادسیمال در خروجی نمایش داده می‌شوند.
عملکردی مشابه با گزینه «-h» دارد.
به توضیحات --list در بخش اصلی مراجعه کنید.
به توضیحات --llbaa در بخش اصلی مراجعه کنید.
تغییر به گزینه‌های سبک جدیدتر.
به توضیحات --maxlen=LEN در بخش اصلی مراجعه کنید.
به توضیحات --multiple در بخش اصلی مراجعه کنید.
مقدار PG کد صفحه‌ای است که باید دریافت شود. باید یک عدد هگزادسیمال بین 0 و 3f (شامل هر دو، 0 تا 63 دهدهی) باشد. مقدار پیش‌فرض در صورت نیاز 3f (دریافت تمام صفحه‌های حالت) است. توجه داشته باشید که سرسرواژه برای مقادیر صفحه و/یا زیرصفحه در این قالب قدیمی‌تر پذیرفته نمی‌شود (زیرا هر سرسرواژه‌ای که با حروف «a» تا «f» شروع شود مبهم است؛ می‌تواند یک عدد هگزادسیمال یا یک سرسرواژه باشد).
مقدارهای کد صفحه و کد زیرصفحه که باید دریافت شوند. کد صفحه باید یک عدد هگزادسیمال بین 0 و 3f (شامل هر دو) باشد. کد زیرصفحه باید یک عدد هگزادسیمال بین 0 و ff (شامل هر دو) باشد. مقدار پیش‌فرض برای کد زیرصفحه 0 است.
نمایش صفحه حالت انتخاب‌شده در stdout به صورت یک بایت در هر خط. هر خط شامل دو رقم هگزادسیمال است (برای نمونه «3e»). این خروجی می‌تواند (پس از ویرایش) به عنوان ورودی برای ابزار sg_wr_mode(8) مفید باشد.
کد زیرصفحه‌ای که باید دریافت شود. باید یک عدد هگزادسیمال بین 0 و 0xff (شامل هر دو) باشد. مقدار پیش‌فرض 0 است.
افزایش سطح پرگویی خروجی.
چاپ رشته نسخه و سپس خروج.
به توضیحات --readwrite در بخش اصلی مراجعه کنید.
-?
نمایش پیام راهنمای استفاده و سپس خروج. همه پارامترهای دیگر نادیده گرفته می‌شوند.

از زمان نگارش ۱.۲۳ از sg3_utils، متغیر محیطی SG3_UTILS_OLD_OPTS می‌تواند مشخص شود. هنگامی که این متغیر وجود داشته باشد، این ابزار انتظار گزینه‌های قدیمی‌تر خط فرمان را خواهد داشت؛ بنابراین وجود این متغیر محیطی معادل استفاده از --old (یا -O) به عنوان اولین گزینه خط فرمان است.

تمام صفحه‌های حالت (بدون زیرصفحه‌ها) را می‌توان به صورت زیر در قالب هگزادسیمال در یک پرونده ذخیره کرد:


# sg_modes -a -HHHH /dev/sdb > modes_sdeb.hex

اگر خطایی رخ دهد، پیام‌ها به stderr ارسال می‌شوند، بنابراین در کنسول ظاهر خواهند شد و نه درون پرونده modes_sdeb.hex. با این وجود در صورت وقوع خطا ممکن است محتویات modes_sdeb.hex مفید نباشد.

گزینه «-HHHH» خروجی هگزادسیمال را همراه با خطوط توضیحات که با نویسه «#» آغاز می‌شوند تولید می‌کند. هر توضیح، بلوک پس از خود را شرح می‌دهد. اگر همه‌چیز درست پیش رود، پرونده modes_sdeb.hex برای رمزگشایی توسط ابزار sdparm مناسب خواهد بود:


# sdparm -a --inhex=modes_sdeb.hex

برای اطلاعات بیشتر به صفحه راهنمای sdparm(8) مراجعه کنید.
برای استخراج هم‌زمان صفحه‌ها و زیرصفحه‌های حالت، از این دستور استفاده کنید:


# sg_modes -aa -HHHH /dev/sdb > modes_sdeb.hex

نیازی به هیچ تغییری در فراخوانی sdparm مرتبط نیست. نمونه‌ای از این خروجی در دایرکتوری inhex از بسته sg3_utils، در پرونده‌ای به نام modes_sdeb.hex موجود است. این پرونده با استفاده از این ابزار روی درایور scsi_debug در لینوکس ایجاد شده است.

هر صفحه حالت (و زیرصفحه) دارای حداکثر چهار «کنترل صفحه» (page control) است: جاری (current)، قابل تغییر (changeable)، پیش‌فرض (default) و ذخیره‌شده (saved). سه مورد آخر ممکن است توسط دستگاه پشتیبانی شوند یا نشوند. تمام کنترل‌های صفحه موجود برای همه صفحه‌ها و زیرصفحه‌های حالت را می‌توان با این دستور در یک پرونده هگزادسیمال قرار داد:


# sg_modes -aa -M -HHHH /dev/sdb > modes_mm_sdeb.hex

مجدداً، هیچ تغییری در فراخوانی sdparm مرتبط نیاز نیست. نمونه‌ای از این خروجی در دایرکتوری inhex از بسته sg3_utils در پرونده‌ای به نام modes_mm_sdeb.hex وجود دارد.

نوشته‌شده توسط Douglas Gilbert

گزارش باگ‌ها را به <dgilbert at interlog dot com> بفرستید.

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

sdparm,sdparm_json(sdparm), sg_wr_mode(8), sginfo(8), sgmode(scsirastools), scsiinfo(net), scu(net), seatools(seagate)

تمام این ابزارها امکاناتی برای تغییر پارامترهای صفحه حالت (یا توصیف‌گر بلوک) ارائه می‌دهند.

2026-05-01 sg3_utils-1.49