مكتبة عزل LoongArch64

libloong هي مكتبة محاكاة LoongArch عالية الأداء 64 بت مصممة للتضمين والبرمجة النصية عالية التردد. بُنيت على أساس libriscv، وتوفر أفضل أداء لمفسر 64 بت متاح، مع الحفاظ على قاعدة شفرة مدمجة بحوالي 18 ألف سطر وبدون تبعيات.

يمكنك أيضًا تشغيل برامج LoongArch64 Linux في واجهة سطر الأوامر.

عالمية: على عكس JITs التي تتطلب توليد شفرة خاص بالمنصة وغير متوفرة على المنصات المقفلة، تعمل libloong في أي مكان. يشمل ذلك Nintendo Switch (1 & 2) و iOS والبيئات الأخرى.
قياسية: تشغيل ثنائيات Linux القياسية.
زمن انتقال فائق الانخفاض: غالبًا ما تعاني الأجهزة الافتراضية التقليدية مثل Lua أو Java من تكلفة استدعاء عالية (~150ns). تحقق libloong ~4ns تكلفة استدعاء من الأصلي إلى الضيف، مما يجعلها مناسبة للبرمجة النصية لمحركات الألعاب ذات الحلقات الساخنة.

مؤشرات الأداء

في اختبارات أداء المفسر CoreMark 1.0 (ديسمبر 2025)، يتصدر libloong فئة 64 بت على Ryzen 7950X، واصلاً بشكل موثوق إلى نتيجة 3000+.

نتائج مفسر CoreMark 1.0

المفسر	البنية	النتيجة
libloong	LoongArch 64 بت	3045
libriscv	RISC-V 64 بت	2865
stitch	Wasm	2743
wasm3	Wasm	2368
wasmer (WAMR)	Wasm	2314
wasmi	Wasm	1967

الأوضاع المتقدمة: بينما يعد المفسر هو المحور الأساسي للقابلية للنقل، تتضمن libloong JIT خفيف يصل إلى 38% من الأداء الأصلي (15.5k CoreMark) ومترجم ثنائي مدمج يصل إلى ~77% من الأداء الأصلي (31.9k CoreMark).

الميزات

الروابط: واجهة برمجة تطبيقات C++ أصلية مع روابط Rust و Go.
دعم المتجهات: دعم كامل لمجموعات تعليمات LSX و LASX.
أمان الذاكرة: عزل صارم للذاكرة مع مناطق ذاكرة مقنعة اختيارية.
إدارة الحالة: دعم من الدرجة الأولى للإيقاف المؤقت والاستئناف وتسلسل حالة الآلة.
التنفيذ الديناميكي: يمكن تحميل وتنفيذ الملفات التنفيذية الديناميكية، بالإضافة إلى JITs المضمنة (مثل LuaJIT)*

التصميم

البرمجة النصية لمحركات الألعاب هي المجال الذي تتفوق فيه libloong. الألعاب التقليدية تتيح التعديل من خلال المكتبات المشتركة (وصول كامل للنظام)، أو الأجهزة الافتراضية المضمنة مثل Lua (~150ns تكلفة استدعاء)، أو بيئات تشغيل Java. libloong لديها ~4ns تكلفة استدعاء.

اطلع على مثال لعبة Asteroid.

البناء

خيارات تهيئة CMake:

LA_DEBUG=ON/OFF - تفعيل إخراج التصحيح (الافتراضي: OFF)
LA_BINARY_TRANSLATION=ON/OFF - تفعيل الترجمة الثنائية (الافتراضي: OFF)
LA_THREADED=ON/OFF - تفعيل توزيع البايت كود متعدد الخيوط (الافتراضي: ON)
LA_MASKED_MEMORY_BITS=N - تعيين حجم منطقة الذاكرة المقنعة إلى 2^N بايت (0 = معطل، الافتراضي: 0)

مثال مع الخيارات:

cmake .. -DCMAKE_BUILD_TYPE=Release \
         -DLA_MASKED_MEMORY_BITS=32 \
         -DLA_BINARY_TRANSLATION=ON
make -j6

بداية سريعة

#include <libloong/machine.hpp>

int main() {
    // Load a LoongArch ELF binary
    std::vector<uint8_t> binary = load_file("program.elf");

    // Create a machine with 64MB memory
    loongarch::Machine machine { binary, {
        .memory_max = 64 * 1024 * 1024
    }};

    // Setup program arguments
    machine.setup_linux({"program"}, {"LC_ALL=C"});

    // Run the program
    machine.simulate();
}

libloong

الأكثر شعبية