Tema 0 - Kernel API

  • Termen de predare: Duminică, 12 Martie 2017, ora 23:00

Scopul temei

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

Enunț

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 scheletul de cod oferit.

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 a vă asigura că modulul este compilat pentru kernel-ul pe care îl rulează mașina virtuală, trebuie să aveți KDIR = /usr/src/linux-so2 în Makefile.

Testare

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 list-checker. Scriptul de testare presupune că numele modului de kernel este denumit list.

Scriptul list-checker trebuie descărcat și îi trebuie acordate drepturi de execuție:

wget http://elf.cs.pub.ro/so2/res/teme/list-checker
chmod a+x list-checker

Apoi scriptul trebuie copiat în directorul fsimg/root/ al mașinii virtuale QEMU/KVM. Tot acolo trebuie copiat și fișierul modul compilat list.ko. După pornirea mașinii virtuale, scriptul și modulul vor fi disponibile în directorul /root/ al mașinii virtuale QEMU/KVM. Pentru testare se va invoca scriptul:

./list-checker

Sfaturi

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:

checkpatch.pl

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

sparse

  •  sudo apt-get install sparse 
  •  cd /path/to/linux-4.9.11 
     make C=2 /path/to/your/list.c 

cppcheck

  •  sudo apt-get install cppcheck 
  •  cppcheck /path/to/your/list.c 

Depunctări

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.

Submitere

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.

Resurse

Resursele temei se găsesc și în repo-ul so2-assignments de pe GitHub. Repo-ul conține și un script Bash care vă ajută să vă creați un repository privat pe instanța de GitLab a facultății. Urmăriți indicațiile din README și de pe pagina de Wiki dedicată pentru git.

Întrebări

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).

so2/teme/tema0.txt · Last modified: 2017/03/09 11:46 by alexandru.jercaianu
CC Attribution-Share Alike 3.0 Unported
www.chimeric.de Valid CSS Driven by DokuWiki do yourself a favour and use a real browser - get firefox!! Recent changes RSS feed Valid XHTML 1.0