STREAMS szolgáltatások

A STREAMS driverekben a driver megnyitását, az adatok továbbítását és a driver lezárását más-más eljárás végzi. Ezeket az eljárásokat a kernel a neki átadott táblázatok alapján tudja elérni, és amikor végrehajtja oket, akkor paraméterként átad az eljárásoknak információkat, ami megkönnyíti a munkájukat. A leggyakrabban használt rutinok és feladatuk leírása a következo pontok témája.
Általában külön eljárásokat írhatunk a lefelé és a felfelé haladó streamhez, de írhatunk a két stream által közösen használt rutint is. Ha valamelyik szolgáltatásra nincs szükség, akkor azt nem kell kódolni (ld. késobb).

--- - Driver/modul megnyitása (open) - ---

  Szintaxis :

  int xxopen(queue_ptr,dev,flag,sflag)
  queue_t *queue_ptr;  /* A read-queuera a pointer */
  dev_t dev;
  int flag,sflag;

• 0 : normál open-nél lesz meghívva, vagyis amikor egy STREAMS driverre utaló spciális filet nyitunk meg. Ekkor a dev-ben megadott minor device number a file-rendszerbol kinyert szám lesz.
• MODOPEN : Modulkénti megnyitáskor lesz meghívva.
• CLONEOPEN : Clone-driver típusú megnyitást jelzi. Ekkor nem lesz átadva a dev paraméterben érvényes minor device number, hanem a drivernek magának kell egy belso táblázatából egy minor device numbert a hívó programnak adni.

Ha az xcln filet megnyitjuk, aminek a major device numberje egyenlo a clone driver major device numberjével, akkor a clone driver lesz eloször végrehajtva, és (mint egy diszpécser) keres egy üres minor devicet, és ezt adja tovább a driver open rutinnak. A megnyitó rutin egy nulla visszatérési értékkel jelzi, ha nem volt hiba a futása közben, vagy OPENFAIL értékkel térjen vissza, ha a megnyitás eredménytelen volt. Az open és a close rutinok végrehajtásakor a kernel lokkolja a device i-nodeját, így egyszerre csak egy open vagy close rutin lehet aktív major/minor deviceonként. Megjegyzés: Ha a felhasználói programokból megnyitjuk egy STREAMS device driver valamelyik minor device-ját, majd késobb ismét kiadunk egy open rednszerhívást ugyanarra a minor devicera, akkor a második open rendszerhívásnál az open rutin nem lesz újra meghívva.

--- - Driver/modul lezárása (close) - ---

  Szintaxis :

  xxclose(queue_ptr)
  queue_t *queue_ptr;  /* Pointer a read queuera */

--- - Üzenet fogadása (put rutin) - ---

  Szintaxis :

  int xxput(qp,mp)
  queue_t *qp;
  mblk_t *mp;

--- - A service rutin - ---

  Szintaxis :

  int xxsrv(qp)
  queue_t *qp;

  int xxsrv(qp)
    queue_t *qp;
  {
    /* Lokalis deklaraciok - reentrans kod erdekeben */
    mblk_t *mp;

    while (mp=getq(qp) != NULL)
    {
      if (canput(qp->q_next) || (a message magas prioritasu))
      {
         dolgozd_fel_az_uzenetet();
         if (tovabb_kell_adni_az_uzenetet())
         {
           putnext(qp,mp);
         }
      } else {
         putbq(qp,mp);
         return;
      }           
    }
  }

--- - Service rutin vs. put rutin - ---

A service rutin opcionális, csak akkor szükséges, ha a put rutin az üzenetet nem tudja a beérkezésének " pillanatában " rögtön feldolgozni (mert például a hardware periféria még nem ért el egy bizonyos belso állapotot) vagy a stream már túl van terhelve és nem fér bele az üzenet. Minden modulhoz és driverhez meg lehet adni egy low water mark és egy high water mark értéket. Ez azért jó, mert el lehet vele érni egy nagyjából egyenletes adatáramlást (nem alakul ki adatdugó). Ha az üzenetek által lefoglalt byte-ok száma meghaladja a modulhoz megadott high water mark értéket, akkor egy QFULL flag be lesz állítva. Ennek a flagnek az állapotát az elotte levo modul a canput kernelfüggvénnyel lekérdezheti, és ha a flag be van állítva, akkor normál (alacsony) prioritású üzeneteket már nem adhat tovább. (Ezeket a saját sorába visszarakhatja a putbq STREAMS kernel segédfüggvénnyel.) A service rutinra csak akkor jut a vezérlés, ha az addig üres sorba egy új üzenet került, vagy az alatta következo modulban elérte az üzenetek által lefoglalt byte-ok száma a low water markot. Ezen kívül máskor is megkaphatja a vezérlést, de errol saját magának kell gondoskodnia (a qenable és az enableok STREAMS kernel segédrutinok segítségével).

--- - Driver ioctl rutin - ---

A hagyományos karakteres UNIX device driverekben egy külön belépési pont az ioctl hívásokat feldolgozó eljárás. Ezzel szemben a STREAMS device driverek esetében az ioctl hívásokat többnyire a stream-fej dolgozza fel, azokból bizonyos típusú üzeneteket generál, ami le lesz küldve a STREAMS drivernek (vagy modulnak). Az I_STR hívás például arra utasítja a stream-fejet, hogy egy M_IOCTL típusú üzenetet küldjön le a streamen. Ekkor az ioctl hívások feldolgozása az M_IOCTL típusú üzenetek driveren belüli feldolgozását jelenti.