نام (NAME)

sg_ident - ارسال دستور SCSI REPORT/SET IDENTIFYING INFORMATION

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

sg_ident [--ascii] [--clear] [--help] [--itype=IT] [--raw] [--set] [--verbose] [--version] DEVICE

توضیحات (DESCRIPTION)

دستور SCSI با نام REPORT IDENTIFYING INFORMATION یا SET IDENTIFYING INFORMATION را به DEVICE ارسال می‌کند. پیش از استاندارد SPC-4 (نگارش ۷)، این دستورات به ترتیب REPORT DEVICE IDENTIFIER و SET DEVICE IDENTIFIER نامیده می‌شدند. دستگاه‌های SCSI پشتیبانی‌کننده از این دو دستور، به کاربران اجازه می‌دهند اطلاعات شناسایی را بنویسند (تنظیم کنند) و در آینده آن را بازیابی کنند. این اطلاعات پایدار است (روی رسانه غیرفرار درون دستگاه SCSI ذخیره می‌شود و پس از قطع برق باقی می‌ماند).

معمولاً فضای اختصاص‌یافته برای این اطلاعات محدود است: استاندارد SPC-4 (نگارش ۷) مشخص می‌کند که برای اطلاعات نوع ۰، حداقل طول ۶۴ بایت و حداکثر ۵۱۲ بایت است. برای سایر انواع اطلاعات (۱ تا ۱۲۶)، حداکثر طول ۲۵۶ بایت است. همچنین انواع اطلاعات ۱ تا ۱۲۶ باید حاوی یک رشته متنی UTF-8 ختم‌شده به تهی (null) باشند.

رفتار پیش‌فرض در صورت نبود گزینه‌ها، اجرای دستور Report Identifying Information با نوع اطلاعات پیش‌فرض صفر است. اطلاعات به‌طور پیش‌فرض در قالب ASCII-HEX (تا ۱۶ بایت در هر خط) با نمایش ASCII در سمت راست نمایش داده می‌شود.

گزینه‌ها (OPTIONS)

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

-A, --ascii: دستور Report Identifying Information را اجرا کرده و در صورت وجود، آن را به عنوان رشته اسکی (یا UTF-8) در خروجی استاندارد چاپ می‌کند.
-C, --clear: دستور Set Identifying Information را با طول صفر فراخوانی می‌کند که اطلاعات موجود را پاک خواهد کرد.
-h, --help: نمایش پیام راهنما و سپس خروج.
-i, --itype=IT: که در آن IT نوع اطلاعات است (پیش‌فرض صفر). بیشینه مقدار ۱۲۷ است که نمی‌تواند با --set یا --clear استفاده شود. نوع ۱۲۷ فهرستی از انواع اطلاعات در دسترس و طول آن‌ها را برمی‌گرداند.
-r, --raw: اطلاعات بازگردانده شده را به صورت باینری به خروجی استاندارد می‌فرستد.
-S, --set: ابتدا ورودی استاندارد را تا رسیدن به EOF می‌خواند، سپس دستور Set Identifying Information را فراخوانی کرده و داده‌های ورودی را (بین ۱ تا ۵۱۲ بایت) روی دستگاه ثبت می‌کند.
-v, --verbose: افزایش سطح جزئیات خروجی اشکال‌زدایی.
-V, --version: نمایش اطلاعات نسخه و خروج.

این ابزار به کاربران امکان می‌دهد اطلاعات شناسایی خود را بر روی دستگاه‌های SCSI ذخیره کنند. سایر شناسه‌های دائمی مانند شناسه سازنده در پاسخ INQUIRY یا شماره سریال سخت‌افزاری توسط کاربر قابل تغییر نیستند.

مثال‌ها (EXAMPLES)

برای مشاهده اطلاعات موجود با نوع ۰ بدون هیچ گزینه‌ای:

# sg_ident /dev/sdb
 00     31 32 33 34 35 36 37 38  39 30          1234567890

اگر اطلاعات متنی اسکی باشد:

# sg_ident --ascii /dev/sdb
1234567890

کپی اطلاعات در یک پرونده، پاک کردن آن و ثبت مجدد:

# sg_ident --raw /dev/sdb > t
# sg_ident --clear /dev/sdb
# cat t | sg_ident --set /dev/sdb

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

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

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

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

گزارش باگ‌ها (REPORTING BUGS)

گزارش اشکالات به <dgilbert at interlog dot com>.

حق نشر (COPYRIGHT)

حق نشر © 2005-2018 Douglas Gilbert
این نرم‌افزار تحت مجوز BSD-2-Clause توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا مناسب بودن برای یک هدف خاص.

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

sg_vpd(sg3_utils), sg_rmsn(sg3_utils), sg_get_config(sg3_utils)