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 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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