Tema 0 - Kernel API

• Termen de predare: Duminică, 15 Martie 2020, ora 23:00

• familiarizarea cu setup-ul qemu
• inserarea/ștergerea de module de kernel
• familiarizarea cu API-ul de liste implementat în kernel
• have fun :)

Să se scrie un modul de kernel numit list (fișierul rezultat trebuie să se cheme list.ko) care stochează date (șiruri de caractere) într-o listă internă.

Este obligatorie folosirea API-ului de liste implementat în kernel. Pentru detalii puteți urmări laboratorul 3.

Pentru realizarea temei, trebuie să porniți de la schelet-ul de cod list.c.

Folositi noua infrastructura de testare ruland comenzile de mai jos:

$ git clone https://github.com/linux-kernel-labs/linux.git
$ cd linux/tools/labs
$ LABS=assignments/0-list make skels
# scheletul de cod se va gasi in api_assignment/0-list/list.c
$ make build
$ make copy
$ make boot

Modulul exportă un director numit list în procfs. Directorul conține două fișiere:

• management: cu acces write-only; este interfața pentru transmiterea comenzilor către modulul de kernel
• preview: cu acces read-only; este interfața prin care se poate vizualiza conținutul intern al listei din kernel.

Scheletul de cod implementează cele două fișiere din procfs. Voi va trebui să creați o listă și să adăugați suportul pentru adăugarea și citirea datelor. Urmăriți TODOs din cod pentru detalii.

Pentru a interacționa cu lista din kernel, trebuie să scrieți comenzi (folosind comanda echo) în fișierul /proc/list/management:

• addf nume: adaugă elementul nume la începutul listei
• adde nume: adaugă elementul nume la sfârșitul listei
• delf nume: șterge prima apariție a elementului nume din listă
• dela nume: șterge toate aparițile elementului nume din listă

Vizualizarea conținutului listei se face prin vizualizarea conținutului fișierului /proc/list/preview (folosiți comanda cat). Formatarea conține câte un element pe fiecare linie.

Pentru simplificarea procesului de corectare al temelor, dar și pentru a reduce greșelile temelor trimise, corectarea temelor se va face automat cu ajutorul unui script de testare numit _checker. Scriptul de testare presupune că numele modului de kernel este denumit list.

Pentru a vă mări șansele de a obține nota maximă, citiți și respectați coding style-ul kernelului Linux descris din documentul Coding Style.

De asemenea, folosiți următoarele tool-uri de analiza statică pentru a verifica codul:

•  linux/scripts/checkpatch.pl --no-tree --terse -f /path/to/your/list.c 

•  sudo apt-get install sparse 

•  cd linux
   make C=2 /path/to/your/list.c 

•  sudo apt-get install cppcheck 

•  cppcheck /path/to/your/list.c 

Depunctările generale pentru teme se găsesc pe pagina de Indicații generale.

În cazuri excepționale (tema trece testele prin nerespectarea cerințelor) și în cazul în care tema nu trece toate testele se poate scădea mai mult decât este menționat mai sus.

Arhiva temei va fi submisă pe vmchecker, în conformitate cu precizările din pagina de reguli.

Din interfața vmchecker alegeți opțiunea Kernel API, aferentă acestei teme.

Pentru întrebări legate de temă puteți consulta arhivele listei de discuții sau puteți trimite un e-mail (trebuie să fiți înregistrați).