.TH SG_IDENT "8" "آگوست 2018" "sg3_utils\-1.43" "راهنمای پارچ لینوکس"
.SH "نام (NAME)"
sg_ident \- ارسال دستور SCSI REPORT/SET IDENTIFYING INFORMATION
.SH "خلاصه دستور (SYNOPSIS)"
.B sg_ident
[\fI\-\-ascii\fR] [\fI\-\-clear\fR] [\fI\-\-help\fR] [\fI\-\-itype=IT\fR]
[\fI\-\-raw\fR] [\fI\-\-set\fR] [\fI\-\-verbose\fR] [\fI\-\-version\fR]
\fIDEVICE\fR
.SH "توضیحات (DESCRIPTION)"
دستور SCSI با نام REPORT IDENTIFYING INFORMATION یا SET IDENTIFYING INFORMATION را به
.I DEVICE
ارسال می‌کند. پیش از استاندارد SPC\-4 (نگارش ۷)، این دستورات به ترتیب REPORT DEVICE IDENTIFIER و SET DEVICE IDENTIFIER نامیده می‌شدند. دستگاه‌های SCSI پشتیبانی‌کننده از این دو دستور، به کاربران اجازه می‌دهند اطلاعات شناسایی را بنویسند (تنظیم کنند) و در آینده آن را بازیابی کنند. این اطلاعات پایدار است (روی رسانه غیرفرار درون دستگاه SCSI ذخیره می‌شود و پس از قطع برق باقی می‌ماند).
.PP
معمولاً فضای اختصاص‌یافته برای این اطلاعات محدود است: استاندارد SPC\-4 (نگارش ۷) مشخص می‌کند که برای اطلاعات نوع ۰، حداقل طول ۶۴ بایت و حداکثر ۵۱۲ بایت است. برای سایر انواع اطلاعات (۱ تا ۱۲۶)، حداکثر طول ۲۵۶ بایت است. همچنین انواع اطلاعات ۱ تا ۱۲۶ باید حاوی یک رشته متنی UTF\-8 ختم‌شده به تهی (null) باشند.
.PP
رفتار پیش‌فرض در صورت نبود گزینه‌ها، اجرای دستور Report Identifying Information با نوع اطلاعات پیش‌فرض صفر است. اطلاعات به‌طور پیش‌فرض در قالب ASCII\-HEX (تا ۱۶ بایت در هر خط) با نمایش ASCII در سمت راست نمایش داده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های بلند برای گزینه‌های کوتاه نیز الزامی هستند.
.TP
\fB\-A\fR, \fB\-\-ascii\fR
دستور Report Identifying Information را اجرا کرده و در صورت وجود، آن را به عنوان رشته اسکی (یا UTF\-8) در خروجی استاندارد چاپ می‌کند.
.TP
\fB\-C\fR, \fB\-\-clear\fR
دستور Set Identifying Information را با طول صفر فراخوانی می‌کند که اطلاعات موجود را پاک خواهد کرد.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش پیام راهنما و سپس خروج.
.TP
\fB\-i\fR, \fB\-\-itype\fR=\fIIT\fR
که در آن
.I IT
نوع اطلاعات است (پیش‌فرض صفر). بیشینه مقدار ۱۲۷ است که نمی‌تواند با \fI\-\-set\fR یا \fI\-\-clear\fR استفاده شود. نوع ۱۲۷ فهرستی از انواع اطلاعات در دسترس و طول آن‌ها را برمی‌گرداند.
.TP
\fB\-r\fR, \fB\-\-raw\fR
اطلاعات بازگردانده شده را به صورت باینری به خروجی استاندارد می‌فرستد.
.TP
\fB\-S\fR, \fB\-\-set\fR
ابتدا ورودی استاندارد را تا رسیدن به EOF می‌خواند، سپس دستور Set Identifying Information را فراخوانی کرده و داده‌های ورودی را (بین ۱ تا ۵۱۲ بایت) روی دستگاه ثبت می‌کند.
.TP
\fB\-v\fR, \fB\-\-verbose\fR
افزایش سطح جزئیات خروجی اشکال‌زدایی.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش اطلاعات نسخه و خروج.
.PP
این ابزار به کاربران امکان می‌دهد اطلاعات شناسایی خود را بر روی دستگاه‌های SCSI ذخیره کنند. سایر شناسه‌های دائمی مانند شناسه سازنده در پاسخ INQUIRY یا شماره سریال سخت‌افزاری توسط کاربر قابل تغییر نیستند.
.SH "مثال‌ها (EXAMPLES)"
برای مشاهده اطلاعات موجود با نوع ۰ بدون هیچ گزینه‌ای:
.PP
.nf
  # sg_ident /dev/sdb
   00     31 32 33 34 35 36 37 38  39 30          1234567890
.fi
.PP
اگر اطلاعات متنی اسکی باشد:
.PP
.nf
  # sg_ident \-\-ascii /dev/sdb
  1234567890
.fi
.PP
کپی اطلاعات در یک پرونده، پاک کردن آن و ثبت مجدد:
.PP
.nf
  # sg_ident \-\-raw /dev/sdb > t
  # sg_ident \-\-clear /dev/sdb
  # cat t | sg_ident \-\-set /dev/sdb
.fi
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج sg_ident در صورت موفقیت برابر با 0 است. در غیر این صورت به صفحه راهنمای sg3_utils(8) مراجعه فرمایید.
.SH "نویسندگان (AUTHORS)"
نوشته شده توسط Douglas Gilbert.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش اشکالات به <dgilbert at interlog dot com>.
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2005\-2018 Douglas Gilbert
.br
این نرم‌افزار تحت مجوز BSD\-2\-Clause توزیع می‌شود. هیچ ضمانتی وجود ندارد؛ حتی برای قابلیت فروش یا مناسب بودن برای یک هدف خاص.
.SH "همچنین ببینید (SEE ALSO)"
.BR sg_vpd (sg3_utils),
.BR sg_rmsn (sg3_utils),
.BR sg_get_config (sg3_utils)