HWDB(7)

الاسم
hwdb -قاعدة بيانات العتاد

الوصف

قاعدة بيانات العتاد هي مخزن مفتاح-قيمة لربط مفاتيح شبيهة بـ modalias بقيم شبيهة بخواص udev. تُستخدم بشكل رئيسي بواسطة udev لإضافة الخواص ذات الصلة إلى الأجهزة المتطابقة، ولكن يمكن أيضًا الاستعلام عنها مباشرة.

ملفات قاعدة بيانات العتاد

تُقرأ ملفات hwdb من الملفات الموجودة في دليل hwdb النظامي /usr/lib/udev/hwdb.d ودليل الإدارة المحلي /etc/udev/hwdb.d. تُفرز جميع ملفات hwdb وتُعالج بشكل جماعي بترتيب معجمي، بغض النظر عن الدلائل التي توجد فيها. ومع ذلك، تحل الملفات ذات الأسماء المتطابقة محل بعضها البعض. للملفات في /etc/ الأولوية القصوى وتتفوق على الملفات التي تحمل الاسم نفسه في /usr/lib/. يمكن استخدام هذا لتجاوز ملف hwdb المقدم من النظام بملف محلي إذا لزم الأمر؛ رابط رمزي في /etc/ بنفس اسم ملف hwdb في /usr/lib/، يشير إلى /dev/null، يعطل ملف hwdb هذا بالكامل. يجب أن تحتوي ملفات hwdb على الامتداد .hwdb؛ ويتم تجاهل الامتدادات الأخرى.

يحتوي كل ملف hwdb على سجلات بيانات تتكون من مطابقات وأزواج مفتاح-قيمة مرتبطة. يبدأ كل سجل في hwdb بسلسلة مطابقة واحدة أو أكثر، تحدد نمط glob shell لمقارنة سلسلة البحث به. تُحدد أسطر مطابقة متعددة في أسطر متتالية. يُقارن كل سطر مطابقة بشكل فردي، ويتم دمجها بواسطة OR. يجب أن يبدأ كل سطر مطابقة من الحرف الأول من السطر.

تتكون أنماط المطابقة من أحرف حرفية، وأحرف بدل على غرار shell:

    • النجمة "*" تطابق أي عدد من الأحرف

    • علامة الاستفهام "?" تطابق حرفًا واحدًا

    • قائمة الأحرف "[chars]" تطابق أحد الأحرف chars المدرجة بين "[" و"]". يمكن تحديد نطاق بشرطة مثل "[first-last]". يمكن عكس المطابقة باستخدام علامة الإقحام "[^...]".

تتبع أسطر المطابقة بسطر واحد أو أكثر من أزواج المفتاح-القيمة، والتي يتم التعرف عليها بمسافة بادئة. يُفصل اسم المفتاح والقيمة بواسطة "=". يشير السطر الفارغ إلى نهاية السجل. تُتجاهل الأسطر التي تبدأ بـ "#".

في حالة تطابق سجلات متعددة مع سلسلة بحث معينة، يتم دمج أزواج المفتاح-القيمة من جميع السجلات. إذا تم تحديد مفتاح عدة مرات، تُستخدم القيمة من السجل ذي الأولوية الأعلى (يمكن أن يكون لكل مفتاح قيمة واحدة فقط). تكون الأولوية أعلى عندما يكون السجل في ملف يُرتب لاحقًا معجميًا، وفي حالة السجلات في نفس الملف، تكون السجلات اللاحقة ذات أولوية أعلى.

يُقرأ محتوى جميع ملفات hwdb بواسطة systemd-hwdb(8) ويُجمع في قاعدة بيانات ثنائية موجودة في /etc/udev/hwdb.bin، أو بدلاً من ذلك /usr/lib/udev/hwdb.bin إذا أردت شحن قاعدة البيانات المجمعة في صورة غير قابلة للتغيير. أثناء وقت التشغيل، تُستخدم قاعدة البيانات الثنائية فقط.

أمثلة

مثال 1. الصيغة العامة لملفات hwdb

    # /usr/lib/udev/hwdb.d/example.hwdb
    # يمكن وضع التعليقات قبل أي سجل. وهذا مكان مناسب
    # لوصف الغرض من هذا الملف، ونوع الخصائص
    # التي يحددها، وقواعد الترتيب.
    # سجل يحتوي على ثلاث مطابقات وخاصية واحدة
    mouse:*:name:*Trackball*:*
    mouse:*:name:*trackball*:*
    mouse:*:name:*TrackBall*:*
     ID_INPUT_TRACKBALL=1
    # يمكن أيضًا كتابة القاعدة أعلاه بشكل
    # يطابق Tb و tb و TB و tB:
    mouse:*:name:*[tT]rack[bB]all*:*
     ID_INPUT_TRACKBALL=1
    # سجل يحتوي على مطابقة واحدة وخمس خصائص
    mouse:usb:v046dp4041:name:Logitech MX Master:*
     MOUSE_DPI=1000@166
     MOUSE_WHEEL_CLICK_ANGLE=15
     MOUSE_WHEEL_CLICK_ANGLE_HORIZONTAL=26
     MOUSE_WHEEL_CLICK_COUNT=24
     MOUSE_WHEEL_CLICK_COUNT_HORIZONTAL=14

مثال 2. تجاوز الخواص

    # /usr/lib/udev/hwdb.d/60-keyboard.hwdb
    evdev:atkbd:dmi:bvn*:bvr*:bd*:svnAcer*:pn*:*
     KEYBOARD_KEY_a1=help
     KEYBOARD_KEY_a2=setup
     KEYBOARD_KEY_a3=battery
    # البحث عن اسم المورد ”Acer“ وأي اسم منتج يبدأ بـ ”X123“
    evdev:atkbd:dmi:bvn*:bvr*:bd*:svnAcer:pnX123*:*
     KEYBOARD_KEY_a2=wlan
    # /etc/udev/hwdb.d/70-keyboard.hwdb
    # disable wlan key on all at keyboards
    evdev:atkbd:*
     KEYBOARD_KEY_a2=reserved
     PROPERTY_WITH_SPACES=some string

إذا تألفت hwdb من هذين الملفين، فإن لوحة مفاتيح بسلسلة البحث "evdev:atkbd:dmi:bvnAcer:bvr:bdXXXXX:bd08/05/2010:svnAcer:pnX123:" ستطابق جميع السجلات الثلاثة، وتنتهي بالخواص التالية:

    KEYBOARD_KEY_a1=help
    KEYBOARD_KEY_a2=reserved
    KEYBOARD_KEY_a3=battery
    PROPERTY_WITH_SPACES=some string

انظر أيضًا

systemd-hwdb(8)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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