نام (NAME)

scsi_logging_level - دسترسی به اطلاعات سطح لاگ‌گیری SCSI در لینوکس

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

scsi_logging_level [--all=LEV] [--create] [--error=LEV] [--get] [--help] [--highlevel=LEV] [--hlcomplete=LEV] [--hlqueue=LEV] [--ioctl=LEV] [--llcomplete=LEV] [--llqueue=LEV] [--lowlevel=LEV] [--midlevel=LEV] [--mlcomplete=LEV] [--mlqueue=LEV] [--scan=LEV] [--set] [--timeout=LEV] [--version]

توضیحات (DESCRIPTION)

این اسکریپت شل bash به سطح لاگ‌گیری زیرسیستم SCSI لینوکس دسترسی پیدا می‌کند. مقادیر فعلی می‌توانند نمایش داده شوند (مثلاً با --get) یا تغییر یابند (مثلاً با --set). برای تنظیم سطح لاگ‌گیری، معمولاً به دسترسی‌های مدیر سیستم (کاربر ارشد) نیاز خواهد بود.

یکی از این گزینه‌ها: --create، --get یا --set الزامی است. تنها یکی از آن‌ها می‌تواند مشخص شود.

گزینه‌ها (OPTIONS)

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

-a, --all=LEV: مقدار LEV برای تمام فیلدهای SCSI_LOG استفاده می‌شود.
-c, --create: گزینه‌ها پردازش شده و در فیلدهای داخلی قرار می‌گیرند و نمایش داده می‌شوند، اما هیچ سطح لاگ‌گیری در هسته لینوکس تغییر نمی‌کند.
-E, --error=LEV: مقدار LEV در فیلد SCSI_LOG_ERROR قرار می‌گیرد.
-g, --get: سطوح فعلی لاگ‌گیری SCSI را از هسته لینوکس دریافت کرده و آن‌ها را نمایش می‌دهد.
-h, --help: پیام راهنمای نحوه استفاده را چاپ کرده و سپس خارج می‌شود.
-H, --highlevel=LEV: مقدار LEV در فیلدهای SCSI_LOG_HLQUEUE و SCSI_LOG_HLCOMPLETE قرار می‌گیرد.
--hlcomplete=LEV: مقدار LEV در فیلد SCSI_LOG_HLCOMPLETE قرار می‌گیرد.
--hlqueue=LEV: مقدار LEV در فیلد SCSI_LOG_HLQUEUE قرار می‌گیرد.
-I, --ioctl=LEV: مقدار LEV در فیلد SCSI_LOG_IOCTL قرار می‌گیرد.
--llcomplete=LEV: مقدار LEV در فیلد SCSI_LOG_LLCOMPLETE قرار می‌گیرد.
--llqueue=LEV: مقدار LEV در فیلد SCSI_LOG_LLQUEUE قرار می‌گیرد.
-L, --lowlevel=LEV: مقدار LEV در فیلدهای SCSI_LOG_LLQUEUE و SCSI_LOG_LLCOMPLETE قرار می‌گیرد.
-M, --midlevel=LEV: مقدار LEV در فیلدهای SCSI_LOG_MLQUEUE و SCSI_LOG_MLCOMPLETE قرار می‌گیرد.
--mlcomplete=LEV: مقدار LEV در فیلد SCSI_LOG_MLCOMPLETE قرار می‌گیرد.
--mlqueue=LEV: مقدار LEV در فیلد SCSI_LOG_MLQUEUE قرار می‌گیرد.
-S, --scan=LEV: مقدار LEV در فیلد SCSI_LOG_SCAN قرار می‌گیرد.
-s, --set: فیلدهای مشخص‌شده در گزینه‌های این دستور را به کار می‌برد و تلاش می‌کند آن‌ها را بر سطوح لاگ‌گیری زیرسیستم SCSI لینوکس اعمال کند. معمولاً برای انجام این کار دسترسی‌های مدیر سیستم (کاربر ارشد) لازم است.
-T, --timeout=LEV: مقدار LEV در فیلد SCSI_LOG_TIMEOUT قرار می‌گیرد.
-v, --version: اطلاعات نسخه را نمایش داده و سپس خارج می‌شود.

نکات (NOTES)

گزینه‌های --get و --set به شبه‌فایل /proc/sys/dev/scsi/logging_level دسترسی دارند.

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

وضعیت خروج این اسکریپت در صورت موفقیت 0 است. هر وضعیت خروج دیگری نشان‌دهنده وقوع خطا است.

مثال‌ها (EXAMPLES)

دستور زیر مقدار SCSI_LOG_ERROR را در هسته لینوکس روی سطح 5 تنظیم می‌کند. این کار به دسترسی ریشه (root) نیاز دارد:

scsi_logging_level -s -E 5

برای اینکه با سایر درایورهای لایه بالایی (ULDs) زیرسیستم SCSI که به احتمال زیاد هم‌زمان فعال خواهند بود تداخلی ایجاد نشود، درایور sg لینوکس از SCSI_LOG_TIMEOUT برای اهداف لاگ‌گیری استفاده می‌کند. برای مشاهده اشکال‌زدایی کامل و ردگیری (trace) از درایور sg استفاده کنید از:

scsi_logging_level -s -T 7

خروجی درایور sg ناشی از این عمل به لاگ‌های سیستم ارسال خواهد شد (مانند /var/log/syslog). برای کاهش حجم خروجی از عددی کمتر از 7 استفاده کنید. استفاده از 0 ردگیری و اشکال‌زدایی را غیرفعال می‌کند.

برای فعال کردن حداکثر لاگ‌گیری زیرسیستم SCSI استفاده کنید از:

scsi_logging_level -s -a 7

بهتر است این کار روی سیستمی انجام شود که از دستگاه فرمانی SCSI برای نگهداری فایل‌سیستم ریشه، یا فایل‌سیستمی که لاگ سیستم را نگه می‌دارد، استفاده نمی‌کند. توجه داشته باشید که دیسک‌های SATA و حافظه‌های متصل از طریق USB تقریباً همیشه از زیرسیستم SCSI استفاده می‌کنند.

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

نوشته‌شده توسط IBM. تغییرات جزئی توسط Douglas Gilbert.

گزارش اشکالات (REPORTING BUGS)

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

حق نشر (COPYRIGHT)

این نرم‌افزار از بسته‌ای از شرکت IBM به نام s390-tools-1.6.2 که در وبگاه "developerworks" آن شرکت قرار دارد به دست آمده است. جدیدترین نسخه آن بسته در حال حاضر 1.8.3 است.