GETITIMER(2)

BEZEICHNUNG
getitimer, setitimer - Zeit eines Intervall-Zeitgebers abfragen oder setzen

ÜBERSICHT
#include <sys/time.h>

int getitimer(int welcher, struct itimerval *aktueller wert);
int setitimer(int welcher,
              const struct itimerval *neuer_wert,
              struct itimerval *alter_wert);

BESCHREIBUNG
The system provides each process with three interval timers, each decrementing in a distinct time domain. When a timer expires, a signal is sent to the process, and the timer is reset to the specified interval (if nonzero).

ITIMER_REAL
    zählt in Echtzeit zurück und liefert bei Ablauf SIGALRM.

ITIMER_VIRTUAL
    zählt nur zurück, wenn der Prozess ausgeführt wird und liefert bei Ablauf SIGVTALRM.

ITIMER_PROF
    zählt sowohl zurück, wenn der Prozess ausgeführt wird als auch, wenn das System für den Prozess tätig ist. Zusammen mit ITIMER_VIRTUAL kann dieser Zeitgeber ermitteln, wie lange eine Applikation sich im Benutzer- und im Kernel-Adressraum aufhält. Bei Ablauf wird SIGPROF geliefert.

Zeitgeberwerte sind durch folgende Strukturen definiert:
struct itimerval {
    struct timeval it_interval; /* Interval for periodic timer */
    struct timeval it_value;    /* Time until next expiration */
};
struct timeval
{
    time_t tv_sec;             /* Sekunden */
    suseconds_t tv_usec;       /* Mikrosekunden */
};

The function getitimer() fills the structure pointed to by curr_value with the current value (i.e., the amount of time remaining until the next expiration) of the timer specified by which (one of ITIMER_REAL, ITIMER_VIRTUAL, or ITIMER_PROF). The subfields of the field it_value are set to the amount of time remaining on the timer, or zero if the timer is disabled. The it_interval field is set to the timer interval (period); a value of zero returned in (both subfields of) this field indicates that this is a single-shot timer. The function setitimer() sets the specified timer to the value in new_value. If old_value is non-NULL, the old value of the timer (i.e., the same information as returned by getitimer()) is stored there.

Zeitgeber zählen von it_value bis Null herunter, generieren ein Signal und werden auf it_interval zurückgesetzt. Ein Zeitgeber,der auf Null gesetzt ist (it_value ist Null oder der Zeitgeber läuft ab und it_interval ist Null), stoppt.

Sowohl tv_sec als auch tv_usec sind für das Festlegen der Dauer eines Zeitgebers von maßgeblich.

Timers will never expire before the requested time, but may expire some (short) time afterward, which depends on the system timer resolution and on the system load; see time(7). (But see BUGS below.) Upon expiration, a signal will be generated and the timer reset. If the timer expires while the process is active (always true for ITIMER_VIRTUAL), the signal will be delivered immediately when generated. Otherwise, the delivery will be offset by a small time dependent on the system loading.

RÜCKGABEWERT
Bei Erfolg wird Null zurückgegeben. Bei einem Fehler wird -1 zurückgegeben und errno entsprechend gesetzt.

FEHLER

EFAULT
    neuer_wert, alter_wert oder aktueller_wert sind keine gültigen Zeiger.

EINVAL
    welcher ist weder ITIMER_REAL, ITIMER_VIRTUAL noch ITIMER_PROF oder (seit Linux 2.6.22) einer der tv_usec-Felder in in der Struktur, auf die neuer_wert zeigt, enthält einen Wert, der außerhalb des Bereichs 0 bis 999999 liegt.

KONFORM ZU
POSIX.1-2001, SVr4, 4.4BSD (dieser Aufruf erschien erstmalig in 4.2BSD). POSIX.1-2008 kennzeichnet getitimer() und setitimer() als veraltet und empfiehlt stattdessen die POSIX-Zeitgeber-API zu benutzen (timer_gettime(2), timer_settime(2), etc.).

ANMERKUNGEN
Ein Kindprozess, der mittels fork(2) erzeugt wurde. erbt nicht die Intervall-Zeitgeber seines Elternprozesses. Intervall-Zeitgeber werden über ein execve(2) konserviert. POSIX.1 beschreibt das Zusammenspiel zwischen setitimer() und den drei Schnittstellen alarm(2), sleep(3) und usleep(3) nicht näher. Die Standards schweigen zu der Bedeutung des folgenden Aufrufs:
    setitimer(which, NULL, &alter_wert); Viele Systeme (Solaris, die BSDs und vielleicht andere) behandeln dies zu folgendem äquivalent:
    getitimer(which, &alter_wert); Unter Linux wird dies als äquivalent zu einem Aufruf betrachtet, bei dem die Felder neuer_wert Null sind, das heißt, der Zeitgeber deaktiviert ist. Benutzen Sie nicht diese ungünstige Linux-Eigenschaft: Sie ist unnötig und nicht portierbar.

FEHLER
Das Generieren und Senden eines Signals sind eigenständig und nur eine Instanz von jedem der oben aufgelisteten Signale kann für einen Prozess anstehen. Unter sehr hoher Systemlast kann ein ITIMER_REAL-Zeitgeber ablaufen bevor das Signal von einem vorherigen Ablauf geliefert wurde. Das zweite Signal geht bei einem solchen Ereignis verloren. Auf Linux-Kerneln vor 2.6.16 wurden Zeitgeberwerte in Jiffies dargestellt. Falls eine Anfrage zum Setzen des Zeitgebers gemacht wurde, dessen Jiffies-Entsprechung MAX_SEC_IN_JIFFIES übersteigt (in include/linux/jiffies.h definiert), dann wurde der Zeitgeber stillschweigend auf diese Obergrenze gekürzt. Auf Linux/i386 (wobei seit Linux 2.6.13 der Standard-Jiffy 0,004 Sekunden entspricht), bedeutet dies, dass die Obergrenze für einen Zeitgeber zirka 99,42 Tagen entspricht. Seit Linux 2.6.16 benutzt der Kernel eine andere interne Entsprechung für Zeiten und diese Obergrenze wurde entfernt. Auf bestimmten Systemen (einschließlich i386) haben Linux-Kernel vor 2.6.12 einen Fehler, der unter Umständen vorzeitige Zeitgeberabläufe von bis zu einem Jiffy produziert. Dieser Fehler wurde in Kernel 2.6.12 behoben. Laut POSIX.1-2001 sollte setitimer() fehlschlagen, wenn ein tv_usec-Wert angegeben wurde, der außerhalb des Bereichs 0 bis 999999 liegt. In Kerneln bis einschließlich 2.6.21 gibt Linux jedoch keinen Fehler zurück, sondern passt stattdessen stillschweigend den Sekundenwert für den Zeitgeber an. Ab Kernel 2.6.22 aufwärts wurde dieser Fehler behoben: Ein unpassender tv_usec-Wert führt zu einem EINVAL-Fehler.

SIEHE AUCH
gettimeofday(2), sigaction(2), signal(2), timer_create(2), timerfd_create(2), time(7)

KOLOPHON
This page is part of release 3.70 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Chris Leick <c.leick@vollbio.de> und Helge Kreutzmann <debian@helgefjell.de> erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an <debian-l10n-german@lists.debian.org>.