Általánosan használható kernel rutinok

A következokben ismertetett kernel hívások mind a hagyományos, mind pedig a STREAMS device driverek készítésénél jól használhatóak. Ezek használata gyakran szükséges, de ronthatják a program hordozhatóságát. (Például a Release 4.0 UNIX módosított major/minor device number kezelése miatt ha áttérünk erre a UNIX rendszerre, akkor módosítani kell a drivereknek azt a részét, amely a minor() vagy major() rutinokat használják. Ez természetesen nem nagy munka - baj csak akkor van, ha ezt elfelejtjük.)

--- - cmn_err - driver hibaüzenetek kiírása konzolra - ---

#include "sys/cmn_err.h"

int cmn_err(severity, format, arguments)
    char *format;
    int severity, arguments;

• severity : Négy különbözo értéke lehet a hiba súlyosságától függoen :
  • CE_CONT : Ez kb. egy printf() hívással egyenértéku - nem ír az üzenet elé semmit.
  • CE_NOTE : Kiírja a paraméterekben megadott szöveget, egy NOTICE: üzenetet követoen.
  • CE_WARN : Kiírja a paraméterekben megadott szöveget, egy WARNING: üzenetet követoen.
  • CE_PANIC : Kiírja a paraméterekben megadott szöveget, egy PANIC: üzenetet követoen, és a rendszert panic állapotba viszi. (Ekkor a UNIX azonnal leáll, és egy memória dump kerül a swap egységre.)

• format : Egy printf()-hez hasonló formátumot lehet itt megadni. A stringben megadható adatformátumok :
  • %b : Két hexadecimális számjegy (egy byte)
  • %c : Karakteres
  • %d : Elojeles decimális szám
  • %o : Elojel nélküli oktális szám
  • %s : String (karakter-pointer)
  • %x : Hexadecimális (vezeto nullákkal együtt írja ki)
  Mezohossz megadása nem megengedett (például a %9d nem adható meg formátumként). Ilyen módon nem csak a konzolra írhatunk ki hibaüzenetet. Azt, hogy a kiírt üzenet hova kerüljön,a format paraméterben megadott üzenet elso karaktere határozza meg. Ha ott az elso karakter egy felkiáltójel (vagyis: ), akkor az üzenet nem kerül ki a konzolra. Egy belso bufferben lesz tárolva, amit a crash rendszerprogram segítségével elemezhetünk. Ha az elso karakter egy kalap (vagyis: ), akkor az üzenet ki lesz írva a konzolra, de nem kerül bele a fent említett bufferbe. Ha ezektol eltéro karakterrel kezdodik az üzenet, akkor a rendszer mind a konzolra, mind a belso bufferébe kiírja azt. Ha a severity érték nem CE_CONT, akkor az üzenet kiírása után a rendszer még egy újsor karaktert is kiír, míg CE_CONT severity érték megadása esetén ilyen újsor karakter nem lesz automatikusan kiírva.
  Megjegyzés: A kiírandó adatok formátumának megadása a különbözo UNIX rendszerekben eltéro lehet, ezért ha az egyik UNIX rendszerre készült STREAMS driverünket átvisszük egy másfajta UNIX rendszerre, akkor nézzünk ennek utána a UNIX leírásban, nehogy valami ilyen jellegu hibát kövessünk el.

• arguments : Opcionális argumentek, amit ezzel a rutinnal ki akarunk iratni. A format paraméterrel ezek az argumentumok összhangban legyenek.

--- - major - megadja a major device numbert - ---

#include "sys/sysmacros.h"

int major(dev)
    dev_t dev;

--- - minor - megadja a minor device numbert - ---

#include "sys/sysmacros.h"

int minor(dev)
    dev_t dev;