hrtcntl(3C)                                                     hrtcntl(3C)

NAME
     hrtcntl - Hochauflösenden Zeitgeber beeinflussen

SYNTAX
     #include <sys/hrtcntl.h>

     int hrtcntl(int cmd, int clk, intervalt *intp, hrtimet *hrtp);

BESCHREIBUNG
     hrtcntl() liefert eine Schnittstelle zur Kontrolle hochauflösender
     oder Intervallzeitgeber (high resolution timer).

     cmd bestimmt das Kommando:

          HRTGETRES
               Ruft die Auflösung einer Uhr ab. Ist der Aufruf erfolgreich,
               wird die Zeitauflösung zurückgeliefert.

          HRTTOFD
               Ruft den Zeitwert seit dem 1. Januar 1970, 00:00:00 GMT ab.
               Das Feld hrtres bestimmt Zeitauflösung. Nach dem Aufruf
               enthält hrtp den Zeitwert.

          HRTSTARTIT
               Startet den Zeitbeginn einer Aktivität. Nach dem Aufruf ent-
               hält intp die aktuellen Werte für den angegebenen Uhrtyp.

          HRTGETIT
               Liefert die abgelaufene Intervallzeit seit dem Aufruf des
               entsprechenden Kommandos HRTSTARTIT zurück. Nach dem Aufruf
               enthält hrtp die abgelaufene Zeit.

     clk bestimmt den Uhrtyp:

          CLKSTD
               Standard-Realzeit-Uhr.

          CLKUSERVIRT
               Uhr, die die virtuelle Prozeßzeit [Zeit des Prozesses im
               Benutzermodus (user mode)] mißt.

          CLKPROCVIRT
               Uhr, die sowohl die virtuelle Prozeßzeit als auch die Real-
               zeit [Zeit des Prozesses im Benutzer- und im Systemmodus
               (user and sys mode)] mißt.

ERGEBNIS
     Wenn der Aufruf erfolgreich war, wird der Wert 0 zurückgegeben. Tritt
     ein Fehler auf, wird -1 zurückgegeben und der Fehlercode in die glo-
     bale Variable errno geschrieben.





Seite 1                      Reliant UNIX 5.44               Gedruckt 11/98

hrtcntl(3C)                                                     hrtcntl(3C)

     Unter der folgenden Bedingung schlägt die Funktion hrtcntl() fehl und
     setzt errno auf den angegebenen Wert:

     EINVAL    Unzulässiger Wert für cmd oder clk.

     EFAULT    hrtp oder intp zeigt außerhalb des allokierten Adreßraums
               des Prozesses.

     ERANGE    Unzulässige Zeitgeberauflösung.

HINWEISE
     Die Funktionen hrtsleep() und hrtcancel() werden nicht unterstützt und
     liefern nur den Fehler ENOPKG.

SIEHE AUCH
     getitimer(3C), hrtalarm(3C).






































Seite 2                      Reliant UNIX 5.44               Gedruckt 11/98