ktf

KTF - إطار اختبار kernel

KTF هو kernel صغير وبسيط ، والذي يتيح كتابة اختبارات البرمجيات منخفضة المستوى لبنية الماكينة المدعومة (حاليًا: x86-64).

ميزات نظرة عامة

• بنية الماكينة: x86-64 ، x86-32 في الخبز
• دعم SMP مع صفحات Per-CPU الأساسية
• (جدا) إدارة الذاكرة الفعلية الأساسية (PMM) وإدارة الذاكرة الظاهرية (VMM)
• تخصيص ألواح أساسي للغاية
• دعم APIC المحلي
• طاولات MP الأولية تحليل
• تحليل جداول ACPI الأساسية
• سائق UART بسيط
• (جدا) سائق VGA بسيط

بعض الميزات أخرى في صنع. تحقق من القضايا.

ابدء

البداية السريعة هي تشغيل الأوامر التالية. سيتم تنفيذ محتوى اختبارات الملف/test.c. ملاحظة ، سيتم حظر الأمر الأخير.

بناء ktf.iso من الصفر ، في حاوية Docker.

 make clean
make docker:ktf.iso

قم بتشغيل الصورة الناتجة:

 make boot

بناء التعليمات

متطلبات

قد تحتاج إلى تثبيت ما يلي (إلا إذا كان لديك بالفعل):

• GRUB2 Bootloader أدوات-حزمة grub2-common (مثل apt install grub2-common )
• أدوات توليد ISO-حزمة xorriso و grub-pc-bin و mtools (على سبيل المثال apt install xorriso grub-pc-bin mtools )

بناء صورة kernel (على سبيل المثال لاستخدامه مع QEMU)

• محلي

 make

• عامل ميناء

 make docker:all

جيل ISO قابل للتمهيد (على سبيل المثال للتمهيد KTF كضيف تحت Xen أو على آلة المعدن العاري)

• محلي

 make ktf.iso

• عامل ميناء

 make docker:ktf.iso

يقوم الأمر make بإنشاء ملف kernel64.bin متعددة القدمين المتوافقة مع ملف ELF المتوافق مع QEMU مباشرة. يأخذ أمر make ktf.iso kernel64.bin ، ويضعه في التسلسل الهرمي grub/boot/ Directory ويقوم بإنشاء ktf.iso من grub/ (باستخدام grub/boot/grub/grub.cfg كتكوين الافتراضي الافتراضي).

فيدورا

تقوم KTF ببناء وتشغيل فيدورا ، لكنك ستحتاج إلى تعديل بعض الأوامر. إنشاء ملف makeConf.local مع المحتوى التالي (تم اختباره مع Fedora 32):

 DIST=$(shell grep NAME= /etc/os-release | cut -d= -f2)
ifeq ($(DIST),Fedora)
GRUB_FILE := grub2-file
GRUB_MKIMAGE := grub2-mkimage
GRUB_MODULES += normal
QEMU_BIN := qemu-kvm
DOCKER_MOUNT_OPTS := :Z
endif

تشغيل النواة

Qemu (kvm أم لا)

يحتوي Main Makefile على العديد من الأهداف التي تجعل التمهيد KTF مع QEMU أسهل. يكتشف Makefile إذا كان نظام المضيف Linux ويمكّن دعم KVM إذا كان الأمر كذلك. يمكن العثور على المعلمات الافتراضية لـ QEMU في Makefile تحت متغير QEMU_PARAMS .

لتشغيل التمهيد:

 make boot

لتصحيح الأخطاء:

 make boot_debug

لتصحيح الأخطاء مع GDB Run:

 make gdb

ضيف Xen

استخدم مثال تكوين مجال الضيوف التالي للتمهيد KTF مع Xen:

 name = "kernel64"
builder = "hvm"
memory = 1024

serial = [ 'file:/tmp/kernel.log' , 'pty' ]

disk = [ '/home/user/ktf.iso,,hdc,cdrom' ]

on_reboot = "destroy"

vcpus = 1

تحتاج إلى إنشاء ISO قابل للتمهيد لهذا الغرض.

إضافة اختبارات جديدة

يمكن إضافة اختبارات جديدة عن طريق إضافة وظيفة جديدة في ملف في مجلد tests . يجب أن يكون كل توقيع اختبار هو نفسه مثل test_fn المنصوص عليه في test.h يمكن تمكين الاختبارات في grub.cfg عن طريق إضافة الخيار مع tests المفاتيح والقيم قائمة مفصولة بأسماء الوظائف ، مثل tests=test1,test2,unit_tests .

أسلوب

يتم تعريف نمط هذا المشروع في ملف .clang-format في الدليل الرئيسي لهذا المستودع.

استخدم الأمر التالي لتطبيق النمط تلقائيًا على الملف الذي تعدله:

clang-format -style=file -Werror -i MODIFIED_FILE

لمزيد من المعلومات ، راجع: https://clang.llvm.org/docs/clangformat.html

يستخدم هذا المشروع https://github.com/doozyx/clang-format-lint- action سير العمل للكشف عن عدم تطابق النمط تلقائيًا. لمزيد من المعلومات ، راجع: https://github.com/marketplace/actions/clang-format-lint

تشغيل سير عمل Clang-Format محليًا

بناء حاوية clang-format-lint

docker build -t clang-format-lint github.com/DoozyX/clang-format-lint-action

يجب أن يتم ذلك مرة واحدة فقط.

تصحيح ملفاتك

make style

تشغيل سير العمل المسح الواحد محليًا

بناء حاوية ktf-one-line-scan

• أولاً ، قم بتنزيل الصورة الأساسية one-line-scan

docker build -t one-line-scan 
    https://raw.githubusercontent.com/awslabs/one-line-scan/master/tools/Dockerfile

• قم بإنشاء صورة محددة من طراز KTF ، بما في ذلك الأدوات اللازمة للبناء

 docker build -t ktf-one-line-scan 
    --build-arg USER_ID=$(id -u) 
    --build-arg GROUP_ID=$(id -g) 
    --build-arg USER=$USER 
    --file tools/docker/OnelineScanDockerfile .

يجب أن يتم ذلك مرة واحدة فقط.

مسح دليل العمل الحالي الخاص بك

• لكل افتراضي ، فحوصات مسح خط واحد ضد الفرق بين HEAD origin/mainline

make onelinescan

الاعتمادات والسمات

• أجزاء من مشروع KTF مستوحاة من المشروع XTF واستنادا إليه [1] التي طورها أندرو كوبر من Citrix.

[1] http://xenbits.xenproject.org/docs/xtf/

حماية

انظر المساهمة لمزيد من المعلومات.

مجتمع

يتواصل المشاركون ومستخدمي KTF في Slack. أنشأنا مساحة عمل الركود ونشارك بنشاط الأفكار والأخطاء وأي شيء يتعلق بـ KTF هناك. لا تتردد في الانضمام إلينا: رابط دعوة الركود

رخصة

تم ترخيص هذا المشروع بموجب ترخيص BSD 2-Cause.