
آلة افتراضية بلغة Rust ومترجم JIT لبرامج eBPF
آلة افتراضية (في مساحة المستخدم) مكتوبة بلغة Rust لـ eBPF
تحتوي هذه الحزمة على آلة افتراضية لتنفيذ برامج eBPF. إن BPF، أي Berkeley Packet Filter، هي لغة شبيهة بلغة التجميع طُوّرت في الأصل من أجل أنظمة BSD، وذلك لتصفية الحزم في النواة باستخدام أدوات مثل tcpdump لتجنّب النسخ غير الضروري إلى مساحة المستخدم. وقد نُقلت إلى Linux، حيث تطوّرت لتصبح eBPF (أي BPF الموسّعة)، وهي نسخة أسرع وأكثر ميزات. وبينما صُمّمت برامج BPF في الأصل لتعمل في النواة، فإن الآلة الافتراضية في هذه الحزمة تتيح تشغيلها في تطبيقات مساحة المستخدم؛ إذ تحتوي على مفسّر (interpreter)، ومترجم JIT لمعمارية x86_64 لبرامج eBPF، بالإضافة إلى مفكّك (disassembler).
وهي مبنية على برنامج uBPF الخاص بـ Rich Lane، والذي يفعل الشيء نفسه تقريبًا، لكنه مكتوب بلغة C.
من المفترض أن تُترجم هذه الحزمة وتعمل على Linux وMacOS X وWindows، رغم أن مترجم JIT لا يعمل مع Windows في الوقت الحالي.
هذه الحزمة متاحة من crates.io، لذا
من المفترض أن تعمل مباشرةً بمجرد إضافتها كاعتمادية في ملف Cargo.toml
الخاص بك:
[dependencies]
rbpf = "0.4.2"
يمكنك أيضًا استخدام نسخة التطوير من مستودع GitHub هذا. يجب أن يكون ذلك بسيطًا مثل وضع هذا داخل ملف Cargo.toml الخاص بك:
[dependencies]
rbpf = { git = "https://github.com/qmonnet/rbpf" }
بالطبع، إذا كنت تفضّل ذلك، يمكنك استنساخه محليًا، وربما تعديل الـ crate،
ثم الإشارة إلى مسار نسختك المحلية في Cargo.toml:
[dependencies]
rbpf = { path = "path/to/rbpf" }
ثم أشر في شيفرتك المصدرية إلى أنك تريد استخدام الـ crate:
extern crate rbpf;
واجهة برمجة التطبيقات موثّقة جيدًا داخل الشيفرة المصدرية. يجب أن تكون قادرًا أيضًا على الوصول إلى نسخة إلكترونية من التوثيق من هنا، يتم إنشاؤها تلقائيًا من إصدار crates.io (قد لا تكون محدّثة مع الفرع الرئيسي). كما ينبغي أن تكون الأمثلة واختبارات الوحدة مفيدة أيضًا. فيما يلي ملخّص لكيفية استخدام الحزمة (crate).
فيما يلي الخطوات التي يجب اتباعها لتشغيل برنامج eBPF باستخدام rbpf:
صُمّم eBPF في البداية لتصفية حزم البيانات (أصبح لديه الآن بعض نقاط الالتقاط الأخرى في نواة لينكس، مثل kprobes، لكن rbpf لا يغطي ذلك). ونتيجة لذلك، تُنفَّذ معظم تعليمات التحميل والتخزين في البرنامج على منطقة ذاكرة تمثّل بيانات الحزمة. ومع ذلك، في نواة لينكس، لا يصل برنامج eBPF إلى منطقة البيانات هذه مباشرةً: بل يصل في البداية إلى struct sk_buff بلغة C بدلًا من ذلك، وهو مخزن مؤقت يحتوي على بيانات وصفية عن الحزمة—بما في ذلك عناوين الذاكرة لبداية منطقة بيانات الحزمة ونهايتها. لذا يقوم البرنامج أولًا بتحميل تلك المؤشرات من sk_buff، ثم يمكنه الوصول إلى بيانات الحزمة.
يمكن محاكاة هذا السلوك باستخدام rbpf، لكنه ليس إلزاميًا. لهذا السبب، لدينا عدة هياكل (structs) تمثّل أنواعًا مختلفة من الأجهزة الافتراضية:
struct EbpfVmMbuffer يحاكي النواة. عند تشغيل البرنامج، سيكون العنوان المُمرَّر إلى سجل eBPF الأول الخاص به هو عنوان مخزن بيانات وصفية يوفّره المستخدم، ويُتوقع أن يحتوي على مؤشرات إلى بداية منطقة ذاكرة بيانات الحزمة ونهايتها.
struct EbpfVmFixedMbuff له غرض واحد: تمكين تنفيذ البرامج المُنشأة لتكون متوافقة مع النواة، مع توفير الجهد على المستخدم في التعامل اليدوي مع مخزن البيانات الوصفية. في الواقع، يحتوي هذا الهيكل على مخزن داخلي ثابت يُمرَّر إلى البرنامج. على المستخدم أن يحدّد قيم الإزاحة التي يتوقع برنامج eBPF عندها العثور على بداية بيانات الحزمة ونهايتها في المخزن. عند استدعاء الدالة التي تشغّل البرنامج (سواء كان مُجمّعًا بـ JIT أم لا)، يقوم الهيكل تلقائيًا بتحديث العناوين في هذا المخزن الثابت، عند الإزاحات المحدّدة، لبداية بيانات الحزمة ونهايتها التي يُستدعى البرنامج من أجلها.
struct EbpfVmRaw مخصّص للبرامج التي تريد العمل مباشرةً على بيانات الحزمة. لا يوجد مخزن بيانات وصفية متضمن؛ يتلقى برنامج eBPF عنوان بيانات الحزمة مباشرةً في سجله الأول. هذا هو سلوك uBPF.
struct EbpfVmNoData لا يأخذ أي بيانات. لا يتلقى برنامج eBPF أي وسيط على الإطلاق وقيمة إرجاعه حتمية. لست متأكدًا تمامًا من وجود حالة استخدام صالحة لذلك، لكن على الأقل، هذا مفيد جدًا لاختبارات الوحدة.
كل هذه الهياكل تنفّذ نفس الدوال العامة:
// called with EbpfVmMbuff:: prefix
pub fn new(prog: &'a [u8]) -> Result<EbpfVmMbuff<'a>, Error>
// called with EbpfVmFixedMbuff:: prefix
pub fn new(prog: &'a [u8],
data_offset: usize,
data_end_offset: usize) -> Result<EbpfVmFixedMbuff<'a>, Error>
// called with EbpfVmRaw:: prefix
pub fn new(prog: &'a [u8]) -> Result<EbpfVmRaw<'a>, Error>
// called with EbpfVmNoData:: prefix
pub fn new(prog: &'a [u8]) -> Result<EbpfVmNoData<'a>, Error>
يُستخدم هذا لإنشاء نسخة جديدة من آلة افتراضية (VM). يعتمد نوع القيمة المُعادة على البنية (struct) التي تُستدعى منها الدالة. على سبيل المثال، rbpf::EbpfVmRaw::new(Some(my_program)) سيُعيد نسخة من struct rbpf::EbpfVmRaw (مغلّفة في Result). عند تحميل برنامج، يتم التحقق منه باستخدام مُدقّق بسيط جدًا (لا يقترب من المُدقّق الخاص بنواة Linux). يمكن للمستخدمين أيضًا استبداله بمُدقّق مخصص.
بالنسبة لـ struct EbpfVmFixedMbuff، يجب تمرير وسيطين إضافيين إلى الدالة البانية (constructor): data_offset و data_end_offset. وهما الإزاحة (رقم البايت) التي سيتم تخزين المؤشرين إلى بداية ونهاية، على الترتيب، منطقة الذاكرة الخاصة ببيانات الحزمة عندها في مخزن البيانات الوصفية الداخلي (internal metadata buffer) في كل مرة يُنفَّذ فيها البرنامج. لا تستخدم البنى الأخرى هذه الآلية ولا تحتاج إلى تلك الإزاحات.
// for struct EbpfVmMbuff, struct EbpfVmRaw and struct EbpfVmRawData
pub fn set_program(&mut self, prog: &'a [u8]) -> Result<(), Error>
// for struct EbpfVmFixedMbuff
pub fn set_program(&mut self, prog: &'a [u8],
data_offset: usize,
data_end_offset: usize) -> Result<(), Error>
يمكنك استخدام مثلاً my_vm.set_program(my_program); لتغيير البرنامج المحمّل بعد إنشاء نسخة الآلة الافتراضية. يتم فحص هذا البرنامج باستخدام المدقّق المرفق بالآلة الافتراضية. يمكن تغيير دالة التحقق الخاصة بالآلة الافتراضية في أي لحظة.
pub type Verifier = fn(prog: &[u8]) -> Result<(), Error>;
pub fn set_verifier(&mut self,
verifier: Verifier) -> Result<(), Error>