
eBPF प्रोग्राम्स के लिए Rust वर्चुअल मशीन और JIT कंपाइलर
eBPF के लिए Rust (उपयोगकर्ता-स्थान) वर्चुअल मशीन
इस crate में eBPF प्रोग्राम निष्पादन के लिए एक वर्चुअल मशीन है। BPF, जैसा कि Berkeley Packet Filter में है, एक असेंबली-जैसी भाषा है जिसे मूल रूप से BSD सिस्टम के लिए विकसित किया गया था, ताकि tcpdump जैसे उपकरणों के साथ कर्नेल में पैकेट फ़िल्टर किए जा सकें और उपयोगकर्ता-स्थान में अनावश्यक प्रतियों से बचा जा सके। इसे Linux में पोर्ट किया गया, जहाँ यह eBPF (extended BPF) में विकसित हुआ, जो अधिक सुविधाओं वाला एक तेज़ संस्करण है। जबकि BPF प्रोग्राम मूल रूप से कर्नेल में चलाने के लिए हैं, इस crate की वर्चुअल मशीन इसे उपयोगकर्ता-स्थान अनुप्रयोगों में चलाने में सक्षम बनाती है; इसमें एक इंटरप्रेटर, eBPF प्रोग्राम के लिए एक x86_64 JIT-कंपाइलर, साथ ही एक डिसअसेम्बलर शामिल है।
यह Rich Lane के uBPF सॉफ़्टवेयर पर आधारित है, जो लगभग वही काम करता है, लेकिन C में लिखा गया है।
यह crate Linux, MacOS X और Windows पर संकलित और चलने वाला माना जाता है, हालाँकि JIT-कंपाइलर इस समय Windows के साथ काम नहीं करता है।
यह crate 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;
API स्रोत कोड के अंदर काफी अच्छी तरह से प्रलेखित है। आपको यहाँ से दस्तावेज़ीकरण का एक ऑनलाइन संस्करण भी एक्सेस करने में सक्षम होना चाहिए, जो crates.io संस्करण से स्वचालित रूप से उत्पन्न होता है (मुख्य शाखा के साथ अद्यतित न हो सकता है)। उदाहरण और यूनिट परीक्षण भी सहायक सिद्ध होने चाहिए। यहाँ crate का उपयोग करने के तरीके का सारांश दिया गया है।
rbpf के साथ एक eBPF प्रोग्राम चलाने के लिए यहाँ अनुसरण करने के चरण दिए गए हैं:
eBPF को शुरू में पैकेट फ़िल्टर करने के लिए डिज़ाइन किया गया था (अब Linux कर्नेल में इसके कुछ अन्य हुक हैं, जैसे kprobes, लेकिन यह rbpf द्वारा कवर नहीं किया गया है)। परिणामस्वरूप, प्रोग्राम के अधिकांश लोड और स्टोर निर्देश पैकेट डेटा का प्रतिनिधित्व करने वाले मेमोरी क्षेत्र पर किए जाते हैं। हालाँकि, Linux कर्नेल में, eBPF प्रोग्राम इस डेटा क्षेत्र तक तुरंत पहुँच नहीं पाता: शुरू में, इसके पास इसके बजाय एक C struct sk_buff तक पहुँच होती है, जो एक बफ़र है जिसमें पैकेट के बारे में मेटाडेटा होता है—जिसमें पैकेट डेटा क्षेत्र के आरंभ और अंत के मेमोरी पते शामिल हैं। इसलिए प्रोग्राम पहले उन पॉइंटर्स को sk_buff से लोड करता है, और फिर पैकेट डेटा तक पहुँच सकता है।
इस व्यवहार को rbpf के साथ दोहराया जा सकता है, लेकिन यह अनिवार्य नहीं है। इस कारण से, हमारे पास विभिन्न प्रकार की वर्चुअल मशीनों का प्रतिनिधित्व करने वाले कई structs हैं:
struct EbpfVmMbuffer कर्नेल की नकल करता है। जब प्रोग्राम चलाया जाता है, तो इसके पहले eBPF रजिस्टर को प्रदान किया गया पता उपयोगकर्ता द्वारा प्रदान किए गए मेटाडेटा बफ़र का पता होगा, और यह अपेक्षित है कि उसमें पैकेट डेटा मेमोरी क्षेत्र के आरंभ और अंत के पॉइंटर्स हों।
struct EbpfVmFixedMbuff का एक उद्देश्य है: कर्नेल के साथ संगत होने के लिए बनाए गए प्रोग्रामों के निष्पादन को सक्षम करना, जबकि उपयोगकर्ता के लिए मेटाडेटा बफ़र को मैन्युअल रूप से संभालने के प्रयास को बचाना। वास्तव में, इस struct में एक स्थिर आंतरिक बफ़र है जो प्रोग्राम को पास किया जाता है। उपयोगकर्ता को उन ऑफ़सेट मानों को इंगित करना होता है जिन पर eBPF प्रोग्राम बफ़र में पैकेट डेटा का आरंभ और अंत खोजने की अपेक्षा करता है। प्रोग्राम चलाने वाले फ़ंक्शन को कॉल करने पर (JITted हो या नहीं), struct स्वचालित रूप से इस स्थिर बफ़र में निर्धारित ऑफ़सेट पर, उस पैकेट डेटा के आरंभ और अंत के लिए पतों को अपडेट करता है जिस पर प्रोग्राम को कॉल किया जा रहा है।
struct EbpfVmRaw उन प्रोग्रामों के लिए है जो सीधे पैकेट डेटा पर चलना चाहते हैं। कोई मेटाडेटा बफ़र शामिल नहीं है, eBPF प्रोग्राम सीधे अपने पहले रजिस्टर में पैकेट डेटा का पता प्राप्त करता है। यह uBPF का व्यवहार है।
struct EbpfVmNoData कोई डेटा नहीं लेता है। eBPF प्रोग्राम कोई भी तर्क नहीं लेता है और इसका रिटर्न मान नियतात्मक होता है। यकीन नहीं है कि इसके लिए कोई वैध उपयोग मामला है, लेकिन अगर और कुछ नहीं, तो यह यूनिट परीक्षणों के लिए बहुत उपयोगी है।
ये सभी structs समान सार्वजनिक फ़ंक्शन लागू करते हैं:
// 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 का नया इंस्टेंस बनाने के लिए किया जाता है। रिटर्न प्रकार उस स्ट्रक्ट पर निर्भर करता है जिससे फ़ंक्शन को कॉल किया गया है। उदाहरण के लिए, rbpf::EbpfVmRaw::new(Some(my_program)) struct rbpf::EbpfVmRaw का एक इंस्टेंस लौटाएगा (एक Result में लिपटा हुआ)। जब कोई प्रोग्राम लोड होता है, तो इसे एक बहुत ही सरल वेरिफायर से जाँचा जाता है (Linux कर्नेल वाले वेरिफायर के काफ़ी करीब भी नहीं)। उपयोगकर्ता इसे एक कस्टम वेरिफायर से बदल भी सकते हैं।
struct EbpfVmFixedMbuff के लिए, कंस्ट्रक्टर को दो अतिरिक्त आर्ग्युमेंट पास करने होते हैं: data_offset और data_end_offset। ये वे ऑफ़सेट (बाइट संख्या) हैं जिन पर प्रोग्राम के प्रत्येक निष्पादन के समय पैकेट डेटा के मेमोरी क्षेत्र के आरंभ और अंत के पॉइंटर क्रमशः आंतरिक मेटाडेटा बफ़र में संग्रहीत किए जाते हैं। अन्य स्ट्रक्ट इस तंत्र का उपयोग नहीं करते और उन्हें इन ऑफ़सेट की आवश्यकता नहीं होती।
// 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>
हमारे समुदाय द्वारा सबसे अधिक उपयोग किए जाने वाले उपकरण खोजें।
अभी तक कोई लोकप्रियता डेटा नहीं है।