.TH SCSI_LOGGING_LEVEL "8" "December 2022" "sg3_utils\-1.48" SG3_UTILS
.SH "نام (NAME)"
scsi_logging_level \- دسترسی به اطلاعات سطح لاگ‌گیری SCSI در لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
.B scsi_logging_level
[\fI\-\-all=LEV\fR] [\fI\-\-create\fR] [\fI\-\-error=LEV\fR] [\fI\-\-get\fR]
[\fI\-\-help\fR] [\fI\-\-highlevel=LEV\fR] [\fI\-\-hlcomplete=LEV\fR]
[\fI\-\-hlqueue=LEV\fR] [\fI\-\-ioctl=LEV\fR] [\fI\-\-llcomplete=LEV\fR]
[\fI\-\-llqueue=LEV\fR] [\fI\-\-lowlevel=LEV\fR] [\fI\-\-midlevel=LEV\fR]
[\fI\-\-mlcomplete=LEV\fR] [\fI\-\-mlqueue=LEV\fR] [\fI\-\-scan=LEV\fR]
[\fI\-\-set\fR] [\fI\-\-timeout=LEV\fR] [\fI\-\-version\fR]
.SH "توضیحات (DESCRIPTION)"
.\" Add any additional description here
این اسکریپت شل bash به سطح لاگ‌گیری زیرسیستم SCSI لینوکس دسترسی پیدا می‌کند. مقادیر فعلی می‌توانند نمایش داده شوند (مثلاً با \fI\-\-get\fR) یا تغییر یابند (مثلاً با \fI\-\-set\fR). برای تنظیم سطح لاگ‌گیری، معمولاً به دسترسی‌های مدیر سیستم (کاربر ارشد) نیاز خواهد بود.
.PP
یکی از این گزینه‌ها: \fI\-\-create\fR، \fI\-\-get\fR یا \fI\-\-set\fR الزامی است. تنها یکی از آن‌ها می‌تواند مشخص شود.
.SH "گزینه‌ها (OPTIONS)"
آرگومان‌های گزینه‌های طولانی برای گزینه‌های کوتاه نیز الزامی هستند.
.TP
\fB\-a\fR, \fB\-\-all\fR=\fILEV\fR
مقدار \fILEV\fR برای تمام فیلدهای SCSI_LOG استفاده می‌شود.
.TP
\fB\-c\fR, \fB\-\-create\fR
گزینه‌ها پردازش شده و در فیلدهای داخلی قرار می‌گیرند و نمایش داده می‌شوند، اما هیچ سطح لاگ‌گیری در هسته لینوکس تغییر نمی‌کند.
.TP
\fB\-E\fR, \fB\-\-error\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_ERROR قرار می‌گیرد.
.TP
\fB\-g\fR, \fB\-\-get\fR
سطوح فعلی لاگ‌گیری SCSI را از هسته لینوکس دریافت کرده و آن‌ها را نمایش می‌دهد.
.TP
\fB\-h\fR, \fB\-\-help\fR
پیام راهنمای نحوه استفاده را چاپ کرده و سپس خارج می‌شود.
.TP
\fB\-H\fR, \fB\-\-highlevel\fR=\fILEV\fR
مقدار \fILEV\fR در فیلدهای SCSI_LOG_HLQUEUE و SCSI_LOG_HLCOMPLETE قرار می‌گیرد.
.TP
\fB\-\-hlcomplete\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_HLCOMPLETE قرار می‌گیرد.
.TP
\fB\-\-hlqueue\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_HLQUEUE قرار می‌گیرد.
.TP
\fB\-I\fR, \fB\-\-ioctl\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_IOCTL قرار می‌گیرد.
.TP
\fB\-\-llcomplete\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_LLCOMPLETE قرار می‌گیرد.
.TP
\fB\-\-llqueue\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_LLQUEUE قرار می‌گیرد.
.TP
\fB\-L\fR, \fB\-\-lowlevel\fR=\fILEV\fR
مقدار \fILEV\fR در فیلدهای SCSI_LOG_LLQUEUE و SCSI_LOG_LLCOMPLETE قرار می‌گیرد.
.TP
\fB\-M\fR, \fB\-\-midlevel\fR=\fILEV\fR
مقدار \fILEV\fR در فیلدهای SCSI_LOG_MLQUEUE و SCSI_LOG_MLCOMPLETE قرار می‌گیرد.
.TP
\fB\-\-mlcomplete\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_MLCOMPLETE قرار می‌گیرد.
.TP
\fB\-\-mlqueue\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_MLQUEUE قرار می‌گیرد.
.TP
\fB\-S\fR, \fB\-\-scan\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_SCAN قرار می‌گیرد.
.TP
\fB\-s\fR, \fB\-\-set\fR
فیلدهای مشخص‌شده در گزینه‌های این دستور را به کار می‌برد و تلاش می‌کند آن‌ها را بر سطوح لاگ‌گیری زیرسیستم SCSI لینوکس اعمال کند. معمولاً برای انجام این کار دسترسی‌های مدیر سیستم (کاربر ارشد) لازم است.
.TP
\fB\-T\fR, \fB\-\-timeout\fR=\fILEV\fR
مقدار \fILEV\fR در فیلد SCSI_LOG_TIMEOUT قرار می‌گیرد.
.TP
\fB\-v\fR, \fB\-\-version\fR
اطلاعات نسخه را نمایش داده و سپس خارج می‌شود.
.SH "نکات (NOTES)"
گزینه‌های \fI\-\-get\fR و \fI\-\-set\fR به شبه‌فایل
/proc/sys/dev/scsi/logging_level
دسترسی دارند.
.SH "وضعیت خروج (EXIT STATUS)"
وضعیت خروج این اسکریپت در صورت موفقیت 0 است. هر وضعیت خروج دیگری نشان‌دهنده وقوع خطا است.
.SH "مثال‌ها (EXAMPLES)"
دستور زیر مقدار SCSI_LOG_ERROR را در هسته لینوکس روی سطح 5 تنظیم می‌کند. این کار به دسترسی ریشه (root) نیاز دارد:
.PP
.nf
  scsi_logging_level \-s \-E 5
.fi
.PP
برای اینکه با سایر درایورهای لایه بالایی (ULDs) زیرسیستم SCSI که به احتمال زیاد هم‌زمان فعال خواهند بود تداخلی ایجاد نشود، درایور sg لینوکس از SCSI_LOG_TIMEOUT برای اهداف لاگ‌گیری استفاده می‌کند. برای مشاهده اشکال‌زدایی کامل و ردگیری (trace) از درایور sg استفاده کنید از:
.PP
.nf
  scsi_logging_level \-s \-T 7
.fi
.PP
خروجی درایور sg ناشی از این عمل به لاگ‌های سیستم ارسال خواهد شد (مانند /var/log/syslog). برای کاهش حجم خروجی از عددی کمتر از 7 استفاده کنید. استفاده از 0 ردگیری و اشکال‌زدایی را غیرفعال می‌کند.
.PP
برای فعال کردن حداکثر لاگ‌گیری زیرسیستم SCSI استفاده کنید از:
.PP
.nf
  scsi_logging_level \-s \-a 7
.fi
.PP
بهتر است این کار روی سیستمی انجام شود که از دستگاه فرمانی SCSI برای نگهداری فایل‌سیستم ریشه، یا فایل‌سیستمی که لاگ سیستم را نگه می‌دارد، استفاده نمی‌کند. توجه داشته باشید که دیسک‌های SATA و حافظه‌های متصل از طریق USB تقریباً همیشه از زیرسیستم SCSI استفاده می‌کنند.
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط IBM. تغییرات جزئی توسط Douglas Gilbert.
.SH "گزارش اشکالات (REPORTING BUGS)"
اشکالات را به <dgilbert at interlog dot com> گزارش دهید.
.SH "حق نشر (COPYRIGHT)"
Copyright \(co IBM Corp. 2006
.br
این نرم‌افزار تحت مجوز GPL نسخه ۲ توزیع شده است. هیچ تضمینی وجود ندارد؛ حتی برای قابلیت تجاری یا مناسب بودن برای یک هدف خاص.
.PP
این نرم‌افزار از بسته‌ای از شرکت IBM به نام s390\-tools\-1.6.2 که در وبگاه "developerworks" آن شرکت قرار دارد به دست آمده است. جدیدترین نسخه آن بسته در حال حاضر 1.8.3 است.