\fhead{sys/timerfd.h}
\fdecl{int timerfd\_create(int clockid, int flags)}
-\fdesc{Crea un timer associato ad un file descriptor per la notifica.}
+\fdesc{Crea un timer associato ad un file descriptor di notifica.}
}
{La funzione ritorna un numero di file descriptor in caso di successo e $-1$
const struct itimerspec *new\_value,\\
\phantom{int timerfd\_settime(}struct itimerspec *old\_value)}
-\fdesc{Crea un timer associato ad un file descriptor per la notifica.}
+\fdesc{Arma un timer associato ad un file descriptor di notifica.}
}
{La funzione ritorna un numero di file descriptor in caso di successo e $-1$
I valori ed il significato di questi argomenti sono gli stessi che sono già
stati illustrati in dettaglio in sez.~\ref{sec:sig_timer_adv} e non staremo a
-ripetere quanto detto in quell'occasione;\footnote{per brevità si ricordi che
- con \param{new\_value.it\_value} si indica la prima scadenza del timer e
- con \param{new\_value.it\_interval} la sua periodicità.} l'unica differenza
+ripetere quanto detto in quell'occasione; per brevità si ricordi che
+con \param{new\_value.it\_value} si indica la prima scadenza del timer e
+con \param{new\_value.it\_interval} la sua periodicità. L'unica differenza
riguarda l'argomento \param{flags} che serve sempre ad indicare se il tempo di
scadenza del timer è da considerarsi relativo o assoluto rispetto al valore
corrente dell'orologio associato al timer, ma che in questo caso ha come
-valori possibili rispettivamente soltanto $0$ e
-\const{TFD\_TIMER\_ABSTIME}.\footnote{anche questo valore, che è l'analogo di
- \const{TIMER\_ABSTIME} è l'unico attualmente possibile per \param{flags}.}
+valori possibili rispettivamente soltanto $0$ e \const{TFD\_TIMER\_ABSTIME}
+(l'analogo di \const{TIMER\_ABSTIME}).
-L'ultima funzione prevista dalla nuova interfaccia è \funcd{timerfd\_gettime},
-che è l'analoga di \func{timer\_gettime}, il suo prototipo è:
+L'ultima funzione di sistema prevista dalla nuova interfaccia è
+\funcd{timerfd\_gettime}, che è l'analoga di \func{timer\_gettime}, il suo
+prototipo è:
\begin{funcproto}{
\fhead{sys/timerfd.h}
\fdecl{int timerfd\_gettime(int fd, struct itimerspec *curr\_value)}
-\fdesc{Crea un timer associato ad un file descriptor per la notifica.}
+\fdesc{Legge l'impostazione di un timer associato ad un file descriptor di
+ notifica.}
}
{La funzione ritorna un numero di file descriptor in caso di successo e $-1$
con \func{timerfd\_create}.
\item[\errcode{EFAULT}] o \param{curr\_value} non è un puntatore valido.
\end{errlist}
-ed inoltre nel suo significato generico.
-
}
\end{funcproto}
-Questo infatti diverrà pronto in lettura per tutte le varie funzioni dell'I/O
-multiplexing in presenza di una o più scadenze del timer ad esso associato.
+La funzione consente di rileggere le impostazioni del timer associato al file
+descriptor \param{fd} nella struttura \struct{itimerspec} puntata
+da \param{curr\_value}. Il campo \var{it\_value} riporta il tempo rimanente
+alla prossima scadenza, che viene sempre espresso in forma relativa
+(indipendentemente dal fatto che si sia specificato
+\const{TFD\_TIMER\_ABSTIME} quando lo si è armato). Un valore nullo (di
+entrambi i campi di \var{it\_value}) indica che il timer non è stato ancora
+armato. Il campo \var{it\_interval} riporta la durata dell'intervallo di
+ripetizione del timer, ed un valore nulle (di entrambi i campi) indica che il
+timer è stato impostato per scadere una sola volta.
+
+Il timer creato con \func{timerfd\_create} notificherà la sua scadenza
+rendendo pronto per la lettura il file descriptor ad esso associato, che
+pertanto potrà essere messo sotto controllo con una qualunque delle varie
+funzioni dell'I/O multiplexing. Esso infatti risulterà pronto soltanto in
+presenza di una o più scadenze del timer cui è associato.
Inoltre sarà possibile ottenere il numero di volte che il timer è scaduto
dalla ultima impostazione che può essere usato per leggere le notifiche delle
scadenze dei timer. Queste possono essere ottenute leggendo in maniera
ordinaria il file descriptor con una \func{read},
+Una volta che
+
% TODO trattare qui eventfd, timerfd introdotte con il 2.6.22
% timerfd è stata tolta nel 2.6.23 e rifatta per bene nel 2.6.25