अपना प्रोजेक्ट फ़ोल्डर खोलें
ऐसा वर्किंग फ़ोल्डर चुनें जिसमें आपका C सोर्स, कंपाइल की हुई फ़ाइल की कॉपी और बाद में एक्सपोर्ट की हुई लिस्टिंग हो।
अपने कंपाइल किए C प्रोग्राम से एक छोटा फ़ंक्शन चुनें और उसे पहले निर्देश से आखिरी return तक पढ़ें। कानून और लाइसेंस की शर्तें देश के अनुसार अलग होती हैं, इसलिए केवल अपना कोड या अभ्यास फ़ाइलें इस्तेमाल करें। नीचे चार चरण हैं।
ऐसा वर्किंग फ़ोल्डर चुनें जिसमें आपका C सोर्स, कंपाइल की हुई फ़ाइल की कॉपी और बाद में एक्सपोर्ट की हुई लिस्टिंग हो।
Shell से अपने डिसअसेंबलर की एक्सपोर्ट कमांड कॉपी पर चलवाएँ, या लिस्टिंग खुद सहेजें, ताकि नतीजा टेक्स्ट फ़ाइल हो।
एजेंट से लिस्टिंग पढ़ने और फ़ंक्शन को पंक्ति-दर-पंक्ति समझाने को कहें, फिर नोट्स write_file से सहेजें।
नोट्स को अपने सोर्स और लिस्टिंग से मिलाएँ, Ask first में diff पढ़ें, और अगर कानूनी हो तो नतीजा लैब में टेस्ट करें।
add_numbers.asmटेक्स्ट पढ़ा गयाedx add_numbers.asm2 मिलानnotes/add_numbers.mdसहेजा गयाnotes/add_numbers.md+4 पंक्तियाँ; add_numbers.asm - teaching listing, x64 Windows
; Returns the sum of its first two integer arguments.
; Argument 1 arrives in ecx (low half of rcx).
; Argument 2 arrives in edx (low half of rdx).
add_numbers:
mov eax, ecx ; copy argument 1 into eax
add eax, edx ; add argument 2, the sum stays in eax
ret ; return to the caller, result in eaxयह फ़ंक्शन दो इंटीजर जोड़ता है। Windows x64 कन्वेंशन में आर्ग्युमेंट ecx और edx में आते हैं, योग eax में बनता है, और ret नियंत्रण कॉलर को लौटा देता है।
शुरुआत करने वालों का आम सवाल है कि असेंबली कैसे शुरू करें, और जवाब है आपका अपना लिखा फ़ंक्शन। छोटा C फ़ंक्शन लिखें, कंपाइल करें और लिस्टिंग टेक्स्ट में एक्सपोर्ट करें। read_file लिस्टिंग खोलता है और एजेंट हर निर्देश समझाता है: कौन-सा रजिस्टर किस आर्ग्युमेंट को रखता है, स्टैक क्या करता है और नतीजा कहाँ लौटता है। write_file ये व्याख्याएँ notes/begin.md में सहेजता है। Plan only में एजेंट पहले ये चरण सूचीबद्ध करता है। अभी कुछ नहीं चलता। फिर Ask first पर जाएँ और हर सेव से पहले diff पढ़ें। अंत में नोट्स को अपने सोर्स से मिलाएँ और, अगर कानूनी हो, तो कंपाइल किया फ़ंक्शन लैब में टेस्ट करें।
APIs की रिवर्स इंजीनियरिंग का अच्छा अभ्यास है अपनी लाइब्रेरी के उजागर फ़ंक्शनों की सूची बनाना और लिखना कि हर आर्ग्युमेंट क्या करता है। अपने टूल से इम्पोर्ट और उजागर फ़ंक्शनों की सूची टेक्स्ट के रूप में सहेजें, फिर एजेंट grep से किसी एक फ़ंक्शन की हर कॉल खोजता है और read_file से उसके आसपास की पंक्तियाँ खोलता है। वह notes/api.md में तालिका का मसौदा बनाता है, और edit_file हर बदलाव diff के रूप में दिखाता है। एक फ़ंक्शन से शुरू करें। यही तरीका आपके अपने पुराने कोड के काम करने का ढंग दोबारा समझने में भी मदद करता है। एजेंट किसी टाइप या मकसद पर गलत हो सकता है, इसलिए स्वीकार करने से पहले हर पंक्ति को अपने सोर्स और अपने टेस्ट से मिलाएँ।