.\" Hey Emacs! This file is -*- nroff -*- source.
.\"
.\" Copyright 7/93 by Darren Senn (sinster@scintilla.santa-clara.ca.us)
.\" Based on a similar page Copyright 1992 by Rick Faith
.\" May be freely distributed
.\"
.\" German translation by Ren Tschirley (gremlin@cs.tu-berlin.de)
.\" Modified Mon Jun 10 12:23:31 1996 by Martin Schulze (joey@linux.de)
.\"
.TH GETITIMER 2 "5 August 1993" "Linux 0.99.11" "Systemaufrufe"
.SH BEZEICHNUNG
getitimer, setitimer \- holt/setzt Zeit eines Intervall-Timers
.SH BERSICHT
.PD 0
.HP
.B #include <sys/time.h>
.sp
.HP
.B int getitimer(int
.IB which ,
.B struct itimerval
.BI * value );
.HP
.B int setitimer(int
.IB which ,
.B const struct itimerval
.BI * value ,
.B struct itimerval
.BI * ovalue );
.PD
.SH BESCHREIBUNG
Das System stellt jedem Proze drei Intervall-Timer zur Verfgung, die
in unterschiedlichen Prozezustnden bis Null herabzhlen.  Wenn der
Timer Null erreicht, wird ein Signal an den Proze geliefert und der
Timer startet (mglicherweise) von vorne.
.TP 1.5i
.B ITIMER_REAL
zhlt die tatschlich laufende Zeit und liefert
.B SIGALRM
wenn die Null erreicht wurde.
.TP
.B ITIMER_VIRTUAL
zhlt nur, wenn der Proze ausgefhrt wird und liefert
.B SIGVTALRM
wenn die Null erreicht wurde.
.TP
.B ITIMER_PROF
zhlt sowohl, wenn der Proze Rechnerzeit beansprucht, als auch, wenn
das System fr den Proze ttig ist.  Zusammen mit
.BR ITIMER_VIRTUAL ,
kann man so ermitteln, wie lange eine Applikation sich im User- und im
Kernelprogrammraum aufhlt.  Wenn der Zhler abgelaufen ist, wird
.B SIGPROF
geliefert.
.LP
Die Timerwerte sind durch folgende Strukturen definiert:
.PD 0
.RS .5i
.nf
struct itimerval
{
    struct timeval it_interval; /* nchster Timerwert */
    struct timeval it_value;    /* dieser Timerwert */
};
struct timeval
{
    long tv_sec;                /* Sekunden */
    long tv_usec;               /* Mikrosekunden */
};
.fi
.RE
.PD
.LP
.BR Getitimer (2)
fllt die Struktur
.I value
mit den aktuellen Werten des Timers, den 
.I which
angibt, was
.BR ITIMER_REAL ,
.BR ITIMER_VIRTUAL ,
oder
.BR ITIMER_PROF )
sein kann.
The element
.B it_value
wird auf die Zeit gesetzt, die noch verbleibt oder auf Null, wenn der
Timer nicht aktiv ist.  Analog wird
.B it_interval
auf den Resetwert gesetzt.
.P
.BR Setitimer (2)
setzt den angegebenen Timer auf den Wert, der in 
.I value
referenziert wird.  Falls 
.I ovalue
nicht Null ist, wird der alte Wert dort abgelegt.
.LP
Timer werden von
.I it_value
dekrementiert bis Null erreicht wird, es wird ein Signal ausgelst und
der Timer wird auf den Beginn des Intervalls
.IR it_interval
zurckgesetzt.  Ein Timer, der auf Null gesetzt wird
.RI ( it_value
ist Null oder der Timer luft ab und
.I it_interval
wird auf Null gesetzt) terminiert.
.LP
Timer laufen nie vor der angeforderten Zeit ab, sondern eher eine
konstant kurze Zeitspanne spter.  Die Gre der Zeitspanne hngt von
der Auflsung des Timer ab (aktuell 10ms).  Bei Ablauf wird ein Signal
erzeugt und der Timer beginnt von neuem.  Wenn das Signal ausgelst
wird, wenn der Proze aktiv ist (das ist bei
.BR ITIMER_VIRT
stets der Fall), wird das Signal augenblicklich
ausgeliefert.  Andernfalls wird das Signal etwas spter ausgeliefert,
was von der Belastung der Maschine abhngen kann.
.LP
.SH "RCKGABEWERT"
Bei Erfolg wird Null geliefert, bei aufgetretenem Fehler wird -1
geliefert und 
.I errno
wird entsprechend gesetzt.
.SH FEHLER
.TP 1.5i
.B EFAULT
.I value
oder
.I ovalue
sind keine gltigen Pointer.
.TP
.B EINVAL
.I which
ist weder
.BR ITIMER_REAL
noch
.BR ITIMER_VIRT
noch
.BR ITIMER_PROF .
.SH BUGS
Unter Linux ist der Zeitpunkt der Auslsung des Signals vom Zeitpunkt
der Auslieferung verschieden und es existiert keine Warteschlange.  Das
bedeutet, da unter unbeschreiblich starker Belastung es denkbar ist,
da 
.B ITIMER_REAL
abluft, bevor das Signal des vorigen Ablaufs des Timers ausgeliefert
wurde.  Das zweite Signal wird verloren.
.SH "SIEHE AUCH"
.BR gettimeofday (2),
.BR sigaction (2),
.BR signal (2).