Scroll to navigation

smartpqi(4) Device Drivers Manual smartpqi(4)

الاسم

smartpqi - سواق SCSI لوحدات تخزين Microchip الذكية

موجز

modprobe smartpqi [disable_device_id_wildcards={0|1}] [disable_heartbeat={0|1}] [disable_ctrl_shutdown={0|1}] [lockup_action={none|reboot|panic}] [expose_ld_first={0|1}] [hide_vsep={0|1}] [disable_managed_interrupts={0|1}] [ctrl_ready_timeout={0|[30,1800]}]

الوصف

smartpqi هو سواق SCSI لمتحكمات تخزين Microchip الذكية.

عمليات ioctl() المدعومة

للتوافق مع التطبيقات المكتوبة لسواقات cciss(4) و hpsa(4)، فإن العديد من عمليات ioctl(2) المدعومة في سواق hpsa -وليس جميعها- مدعومة أيضًا في سواق smartpqi. تُوصف هياكل البيانات المستخدمة في هذه العمليات في ملف مصدر نواة لينكس include/linux/cciss_ioctl.h.

تقوم هذه العمليات جميعًا بالشيء نفسه تمامًا، وهو جعل السواق يعيد فحص الأجهزة الجديدة. يؤدي هذا نفس عمل الكتابة في سمة المضيف rescan الخاصة بـ smartpqi.
تعيد هذه العملية نطاق PCI، والناقل، والجهاز، والوظيفة، و"معرف اللوحة" (معرف نظام PCI الفرعي).
تعيد هذه العملية إصدار السواق في أربعة بايتات، مرمزة كالتالي:

(major_version << 28) | (minor_version << 24) |

(release << 16) | revision

تسمح بتمرير أوامر BMIC و CISS إلى المتحكم.

خيارات التمهيد

تعطل دعم رموز البدل لمعرف الجهاز. القيمة المبدئية هي 0 (رموز البدل مفعلة).
تعطل دعم فحص نبضات قلب المتحكم. تُستخدم هذه المعلمة لأغراض التنقيح. القيمة المبدئية هي 0 (فحص نبضات قلب المتحكم مفعل).
تعطل دعم إيقاف تشغيل المتحكم في حالة توقف المتحكم. القيمة المبدئية هي 0 (سيُوقف تشغيل المتحكم).
تحدد الإجراء الذي يتخذه السواق عند كشف توقف المتحكم. الإجراء المبدئي هو none.
معلمة الإجراء
none جعل المتحكم غير متصل فقط
reboot إعادة تشغيل النظام
panic panic للنظام
يعرض هذا الخيار الأجهزة المنطقية لنظام التشغيل قبل الأجهزة الفيزيائية. القيمة المبدئية هي 0 (تُعرض الأجهزة الفيزيائية أولًا).
يعطل هذا الخيار عرض SEP الوهمي لنظام التشغيل. القيمة المبدئية هي 0 (يُعرض SEP الوهمي).
يعطل استخدام السواق للمقاطعات المدارة من نواة لينكس للمتحكمات. توزع ميزة المقاطعات المدارة المقاطعات آليًا على جميع وحدات المعالجة المركزية المتاحة وتعين تقارب SMP. القيمة المبدئية هي 0 (المقاطعات المدارة مفعلة).
يحدد هذا الخيار المهلة بالثواني لانتظار السواق حتى يصبح المتحكم جاهزًا. النطاق الصالح هو 0 أو [30, 1800]. القيمة المبدئية هي 0، مما يجعل السواق يستخدم مهلة قدرها 180 ثانية.

الملفات

عقد الجهاز

يُوصَل إلى محركات الأقراص عبر سواق أقراص SCSI‏ (sd)، ومحركات الأشرطة عبر سواق أشرطة SCSI‏ (st)، ومتحكم RAID عبر سواق SCSI العام (sg)، مع عقد جهاز تسمى /dev/sd* و /dev/st* و /dev/sg* على التوالي.

ملفات سمات المضيف الخاصة بـ SmartPQI في /sys

/sys/class/scsi_host/host*/rescan
سمة المضيف rescan هي سمة للكتابة فقط. ستؤدي الكتابة في هذه السمة إلى جعل السواق يفحص الأجهزة الجديدة أو المتغيرة أو المزالة (مثل محركات الأشرطة الموصولة أثناء التشغيل، أو الأحجام المنطقية التي ضُبطت حديثًا أو حُذفت) وإشعار الطبقة المتوسطة لـ SCSI بأي تغييرات كُشفت. عادةً ما يُقدح هذا الإجراء آليًا بواسطة تغييرات الضبط، لذا لا ينبغي للمستخدم عادةً الكتابة في هذا الملف. قد يكون القيام بذلك مفيدًا عند توصيل أجهزة أثناء التشغيل مثل محركات الأشرطة أو صناديق تخزين كاملة تحتوي على أحجام منطقية مضبوطة مسبقًا.
/sys/class/scsi_host/host*/lockup_action
سمة المضيف lockup_action هي سمة للقراءة والكتابة. ستجعل هذه السمة السواق ينفذ إجراءً محددًا في الحالة غير المرجحة لكشف توقف المتحكم. انظر OPTIONS أعلاه لشرح قيم lockup_action.
/sys/class/scsi_host/host*/driver_version
سمة driver_version للقراءة فقط. تحتوي هذه السمة على إصدار سواق smartpqi.
على سبيل المثال:

$ cat /sys/class/scsi_host/host1/driver_version
1.1.2-126
    

/sys/class/scsi_host/host*/firmware_version
سمة firmware_version للقراءة فقط. تحتوي هذه السمة على إصدار البرمجيات الثابتة للمتحكم.
على سبيل المثال:

$ cat /sys/class/scsi_host/host1/firmware_version
1.29-112
    

/sys/class/scsi_host/host*/model
سمة model للقراءة فقط. تحتوي هذه السمة على سلسلة تعريف المنتج للمتحكم.
على سبيل المثال:

$ cat /sys/class/scsi_host/host1/model
1100-16i
    

/sys/class/scsi_host/host*/serial_number
سمة serial_number للقراءة فقط. تحتوي هذه السمة على الرقم التعريفي الفريد للمتحكم.
على سبيل المثال:

$ cat /sys/class/scsi_host/host1/serial_number
6A316373777
    

/sys/class/scsi_host/host*/vendor
سمة vendor للقراءة فقط. تحتوي هذه السمة على سلسلة تعريف المورد للمتحكم.
على سبيل المثال:

$ cat /sys/class/scsi_host/host1/vendor
Adaptec
    

/sys/class/scsi_host/host*/enable_stream_detection
سمة enable_stream_detection للقراءة والكتابة. تفعل/تعطل هذه السمة كشف التدفق في السواق. يمكن أن يؤدي تفعيل كشف التدفق إلى تحسين أداء الكتابة المتسلسلة للأحجام التي تدعم ioaccel. انظر قسم سمة القرص ssd_smart_path_enabled لمزيد من التفاصيل حول الأحجام المفعل بها ioaccel. القيمة المبدئية هي 1 (كشف التدفق مفعل).
مثال للتفعيل:

$ echo 1 > /sys/class/scsi_host/host1/enable_stream_detection
    

/sys/class/scsi_host/host*/enable_r5_writes
سمة enable_r5_writes للقراءة والكتابة. تفعل/تعطل هذه السمة عمليات كتابة RAID 5 للأحجام المفعل بها ioaccel. يمكن أن يؤدي التفعيل إلى تحسين أداء الكتابة المتسلسلة. انظر قسم سمة القرص ssd_smart_path_enabled لمزيد من التفاصيل حول الأحجام المفعل بها ioaccel. القيمة المبدئية هي 1 (كتابة RAID 5 مفعلة).
مثال للتفعيل:

$ echo 1 > /sys/class/scsi_host/host1/enable_r5_writes
    

/sys/class/scsi_host/host*/enable_r6_writes
سمة enable_r6_writes للقراءة والكتابة. تفعل/تعطل هذه السمة عمليات كتابة RAID 6 للأحجام المفعل بها ioaccel. يمكن أن يؤدي التفعيل إلى تحسين أداء الكتابة المتسلسلة. انظر قسم سمة القرص ssd_smart_path_enabled لمزيد من التفاصيل حول الأحجام المفعل بها ioaccel. القيمة المبدئية هي 1 (كتابة RAID 6 مفعلة).
مثال للتفعيل:

$ echo 1 > /sys/class/scsi_host/host1/enable_r6_writes
    

ملفات سمات القرص الخاصة بـ SmartPQI في /sys

في مواصفات الملفات أدناه، يرمز c إلى رقم متحكم SCSI المناسب، و b هو رقم الناقل، و t رقم الهدف، و l هو رقم الوحدة المنطقية (LUN).

/sys/class/scsi_disk/c:b:t:l/device/raid_level
سمة raid_level للقراءة فقط. تحتوي هذه السمة على مستوى RAID للحجم المنطقي.
على سبيل المثال:

$ cat /sys/class/scsi_disk/4:0:0:0/device/raid_level
RAID 0
    

/sys/class/scsi_disk/c:b:t:l/device/sas_address
سمة sas_address للقراءة فقط. تحتوي هذه السمة على عنوان SAS للجهاز.
على سبيل المثال:

$ cat /sys/class/scsi_disk/1:0:3:0/device/sas_address
0x5001173d028543a2
    

/sys/class/scsi_disk/c:b:t:l/device/ssd_smart_path_enabled
سمة ssd_smart_path_enabled للقراءة فقط. هذه السمة مخصصة للأحجام المفعل بها ioaccel. (Ioaccel هو مسار تسليم بديل للسواق يسمح له بإرسال طلبات الإدخال/الإخراج مباشرة إلى أجهزة SCSI الخلفية، متجاوزًا البرمجيات الثابتة للمتحكم. يؤدي هذا إلى زيادة في الأداء. تُستخدم هذه الطريقة لأقراص HBA وللأحجام المنطقية المكونة من أقراص SSD). تحتوي على 1 إذا كان ioaccel مفعلًا للحجم و 0 خلاف ذلك.
على سبيل المثال:

$ cat /sys/class/scsi_disk/1:0:3:0/device/ssd_smart_path_enabled
0
    

/sys/class/scsi_disk/c:b:t:l/device/lunid
سمة lunid للقراءة فقط. تحتوي هذه السمة على معرف SCSI LUN للجهاز.
على سبيل المثال:

$ cat /sys/class/scsi_disk/13:1:0:3/device/lunid
0x0300004000000000
    

/sys/class/scsi_disk/c:b:t:l/device/unique_id
سمة unique_id للقراءة فقط. تحتوي هذه السمة على معرف مكون من 16 بايت يحدد الجهاز بشكل فريد داخل المتحكم.
على سبيل المثال:

$ cat /sys/class/scsi_disk/13:1:0:3/device/unique_id
600508B1001C6D4723A8E98D704FDB94
    

/sys/class/scsi_disk/c:b:t:l/device/path_info
سمة path_info للقراءة فقط. تحتوي هذه السمة على c:b:t:l للجهاز بالإضافة إلى نوع الجهاز وما إذا كان الجهاز نشطًا (Active) أم غير نشط (Inactive). إذا كان الجهاز جهاز HBA، فسيعرض path_info أيضًا المنفذ (PORT)، والصندوق (BOX)، والفتحة (BAY) الموصول بها الجهاز.
على سبيل المثال:

$ cat /sys/class/scsi_disk/13:1:0:3/device/path_info
[13:1:0:3]    Direct-Access     Active
$ cat /sys/class/scsi_disk/12:0:9:0/device/path_info
[12:0:9:0]  Direct-Access   PORT: C1 BOX: 1 BAY: 14 Inactive
[12:0:9:0]  Direct-Access   PORT: C0 BOX: 1 BAY: 14 Active
    

/sys/class/scsi_disk/c:b:t:l/device/raid_bypass_cnt
سمة raid_bypass_cnt للقراءة فقط. تحتوي هذه السمة على عدد طلبات الإدخال/الإخراج التي مرت عبر مسار ioaccel للأحجام المفعل بها ioaccel. انظر قسم سمة القرص ssd_smart_path_enabled لمزيد من التفاصيل حول الأحجام المفعل بها ioaccel.
على سبيل المثال:

$ cat /sys/class/scsi_disk/13:1:0:3/device/raid_bypass_cnt
0x300
    

/sys/class/scsi_disk/c:b:t:l/device/sas_ncq_prio_enable
سمة sas_ncq_prio_enable للقراءة والكتابة. تفعل هذه السمة دعم أولوية SATA NCQ. تعمل هذه السمة فقط عندما يدعم الجهاز NCQ وتستطيع البرمجيات الثابتة للمتحكم التعامل مع الإدخال/الإخراج بسمة أولوية NCQ.
على سبيل المثال:

$ echo 1 > /sys/class/scsi_disk/13:1:0:3/device/sas_ncq_prio_enable
    

الإصدارات

أُضيف سواق smartpqi في لينكس 4.9.

ملاحظات

ضبط

لضبط متحكم تخزين Microchip ذكي، راجع دليل المستخدم الخاص بالمتحكم، والذي يمكن العثور عليه بالبحث عن المتحكم المحدد في https://www.microchip.com/design-centers/storage.

التاريخ

استُبدل /sys/class/scsi_host/host*/version بمدخلين في sysfs:

/sys/class/scsi_host/host*/driver_version
/sys/class/scsi_host/host*/firmware_version

انظر أيضًا

cciss(4)، hpsa(4)، sd(4)، st(4)، sg(4)

Documentation/ABI/testing/sysfs-bus-pci-devices-cciss في شجرة مصدر نواة لينكس.

ترجمة

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.

8 فبراير 2026 صفحات دليل لينكس (لم تصدر بعد)