Kernel Module Examples

Repositori edukasi berisi contoh kode dan kerangka program untuk membangun Kernel Module / Driver di berbagai platform.

Bahasa: Bahasa Indonesia (default) | English

---

Daftar Isi

• Tentang Repositori
• Apa itu Kernel Module?
• Struktur Repository
• Konten
• Quick Start
• Berkontribusi
• Disclaimer

---

Tentang Repositori

Repositori ini menghimpun contoh kode dan kerangka program (skeleton) untuk membangun Kernel Module di beragam platform: Linux, FreeBSD, Solaris, dan Windows.

Setiap contoh kode disertai instruksi kompilasi, pemuatan (load), dan pembongkaran (unload) module — cukup ikuti komentar di kepala setiap file atau README pada direktori terkait.

Repositori ini merupakan inisiatif dari komunitas Reversing.ID untuk mendalami pengembangan Kernel Module. Reversing.ID tidak berafiliasi dengan vendor platform manapun; tujuan utama repositori ini adalah bahan belajar.

---

Apa itu Kernel Module?

Kernel Module adalah potongan kode yang memperluas atau memperkaya kemampuan kernel Operating System tanpa harus membangun ulang kernel setiap kali perubahan terjadi. Sebagian besar operating system mendukung konsep ini dengan istilah berbeda, misalnya:

• Kernel Loadable module (kld) untuk FreeBSD
• Kernel Extension (kext) untuk MacOS
• Loadable Kernel Module (lkm) untuk Linux dan Solaris

Kernel Module sering disebut pula dengan driver atau device driver. Meskipun banyak kernel module diciptakan untuk mengimplementasikan interface antara kernel dan perangkat, istilah ini tidak sepenuhnya tepat — kernel module juga dapat mengimplementasikan fitur tertentu di sisi kernel tanpa berhubungan dengan perangkat fisik sama sekali (misalnya hooking syscall).

---

Struktur Repository

KernelModule-Examples/
├── linux/                    # Linux Loadable Kernel Module (LKM)
│   ├── basics/                # skeleton, module param, memory, hook syscall, kernel thread
│   ├── drivers/
│   │   ├── char/               # character device driver
│   │   └── block/               # block device driver
│   └── payload/                # payload gaya rootkit (give-root, hide-file/module/process)
│
├── bsd/                       # FreeBSD Kernel Loadable (KLD)
│   ├── basics/                 # skeleton, memory, hook syscall
│   └── drivers/char/            # character device driver
│
├── solaris/                   # Solaris Loadable Kernel Module (LKM)
│   └── basics/                 # skeleton, memory, hook syscall
│
├── windows/                   # Windows Kernel-Mode Driver Framework (KMDF)
│   └── kmdf/0.basic/            # skeleton, hello
│
├── README.md / README.EN.md   # Dokumentasi ini
├── CONTRIBUTING.md / .EN.md   # Panduan kontribusi
└── .gitignore

Setiap contoh berada di direktori tersendiri berisi code.c (atau code.cpp) dan Makefile/project file yang dibutuhkan untuk kompilasi.

---

Konten

Platform	Istilah	Jumlah Contoh	Build Tool
linux/	Loadable Kernel Module (LKM)	17	make (kbuild)
bsd/	Kernel Loadable (KLD)	7	make (bsd.kmod.mk)
solaris/	Loadable Kernel Module (LKM)	4	make (manual gcc/ld rules)
windows/	Kernel-Mode Driver Framework (KMDF)	2	msbuild / Visual Studio

Lihat README pada masing-masing direktori platform untuk daftar lengkap contoh, penjelasan konsep, dan persiapan environment.

---

Quick Start

1. Mulai Dari Sini

• Pemula? Baca Apa itu Kernel Module? di atas, lalu masuk ke _introduction.md pada platform pilihanmu.
• Ingin kontribusi? Baca CONTRIBUTING.md.

2. Pilih Platform

• Linux: buka direktori linux/
• FreeBSD: buka direktori bsd/
• Solaris: buka direktori solaris/
• Windows: buka direktori windows/

3. Siapkan Build Environment

Setiap platform membutuhkan toolchain berbeda (compiler, kernel headers, WDK, dsb). Ikuti _preparation.md pada direktori platform yang dipilih sebelum melakukan build.

4. Pilih Contoh dan Build

Setiap direktori contoh berisi:

• code.c / code.cpp — source code dengan instruksi build/load/unload di komentar kepala file.
• Makefile (atau project file untuk Windows) — jalankan make (atau msbuild) di direktori tersebut.

---

Berkontribusi

Ini adalah projek terbuka. Kamu bisa memberikan sumbangsih berupa kode untuk platform yang belum terdaftar, menambah contoh baru, atau memperbaiki contoh yang sudah ada.

Baca CONTRIBUTING.md untuk panduan lengkap tentang konvensi penamaan, template contoh baru, dan proses pull request.

Kamu juga bisa:

• mengirimkan email ke pengurus [at] reversing.id
• memberi tahu di telegram @ReversingID

---

Disclaimer

Repositori ini digunakan untuk tujuan edukasi. Beberapa contoh (khususnya direktori linux/payload/) mendemonstrasikan teknik yang lazim dipakai oleh rootkit (hook syscall, hide process/file/module, privilege escalation) — dibuat semata untuk pembelajaran konsep kernel-level programming dan reverse engineering, bukan untuk disalahgunakan pada sistem yang bukan milikmu atau tanpa izin. Pengguna bertanggung jawab atas penggunaan kode dalam repositori ini dan wajib mematuhi hukum yang berlaku di yurisdiksinya.