| 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.
- CCISS_DEREGDISK
- CCISS_REGNEWDISK
- CCISS_REGNEWD
- تقوم هذه العمليات جميعًا بالشيء نفسه تمامًا، وهو جعل السواق يعيد فحص الأجهزة الجديدة. يؤدي هذا نفس عمل الكتابة في سمة المضيف rescan الخاصة بـ smartpqi.
- CCISS_GETPCIINFO
- تعيد هذه العملية نطاق PCI، والناقل، والجهاز، والوظيفة، و"معرف اللوحة" (معرف نظام PCI الفرعي).
- CCISS_GETDRIVVER
- تعيد هذه العملية إصدار السواق في أربعة بايتات، مرمزة كالتالي:
-
(major_version << 28) | (minor_version << 24) |
(release << 16) | revision
- CCISS_PASSTHRU
- تسمح بتمرير أوامر BMIC و CISS إلى المتحكم.
خيارات التمهيد¶
- disable_device_id_wildcards={0|1}
- تعطل دعم رموز البدل لمعرف الجهاز. القيمة المبدئية هي 0 (رموز البدل مفعلة).
- disable_heartbeat={0|1}
- تعطل دعم فحص نبضات قلب المتحكم. تُستخدم هذه المعلمة لأغراض التنقيح. القيمة المبدئية هي 0 (فحص نبضات قلب المتحكم مفعل).
- disable_ctrl_shutdown={0|1}
- تعطل دعم إيقاف تشغيل المتحكم في حالة توقف المتحكم. القيمة المبدئية هي 0 (سيُوقف تشغيل المتحكم).
- lockup_action={none|reboot|panic}
- تحدد
الإجراء
الذي يتخذه
السواق عند
كشف توقف
المتحكم.
الإجراء
المبدئي هو
none.
معلمة الإجراء none جعل المتحكم غير متصل فقط reboot إعادة تشغيل النظام panic panic للنظام - expose_ld_first={0|1}
- يعرض هذا الخيار الأجهزة المنطقية لنظام التشغيل قبل الأجهزة الفيزيائية. القيمة المبدئية هي 0 (تُعرض الأجهزة الفيزيائية أولًا).
- hide_vsep={0|1}
- يعطل هذا الخيار عرض SEP الوهمي لنظام التشغيل. القيمة المبدئية هي 0 (يُعرض SEP الوهمي).
- disable_managed_interrupts={0|1}
- يعطل استخدام السواق للمقاطعات المدارة من نواة لينكس للمتحكمات. توزع ميزة المقاطعات المدارة المقاطعات آليًا على جميع وحدات المعالجة المركزية المتاحة وتعين تقارب SMP. القيمة المبدئية هي 0 (المقاطعات المدارة مفعلة).
- ctrl_ready_timeout={0|[30,1800]}
- يحدد هذا الخيار المهلة بالثواني لانتظار السواق حتى يصبح المتحكم جاهزًا. النطاق الصالح هو 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 | صفحات دليل لينكس (لم تصدر بعد) |