stesso tempo la disponibilità di dati o la ricezione scadenza di un
timer.\footnote{in realtà per questo sarebbe già sufficiente \func{signalfd}
per ricevere i segnali associati ai timer, ma la nuova interfaccia
- semplifica notevolmente la gestione e diminuisce l'\textit{overhead}.}
-
-Le funzioni di questa interfaccia riprendono da vicino quelle introdotte da
-POSIX.1-2001 illustrate sez.~\ref{sec:sig_timer_adv}. La prima funzione, che
-consente di creare un \textit{timer} è \funcd{timerfd\_create}, il cui
-prototipo è:
+ semplifica notevolmente la gestione e consente di fare tutto con una sola
+ \textit{system call}.}
+
+Le funzioni di questa interfaccia ricalcano da vicino la struttura di quelle
+introdotte da POSIX.1-2001, che abbiamo illustrato in
+sez.~\ref{sec:sig_timer_adv}.\footnote{questa interfaccia è stata introdotta
+ in forma considerata difettosa con il kernel 2.6.22, per cui è stata
+ immediatamente tolta nel successivo 2.6.23 e reintrodotta in una forma
+ considerata adeguata nel kernel 2.6.25, il supporto nelle \acr{glibc} è
+ stato introdotto a partire dalla versione 2.8.6, la versione del kernel
+ 2.6.22 non è supportata e non deve essere usata.} La prima funzione
+prevista, che consente di creare un \textit{timer}, è \funcd{timerfd\_create},
+il cui prototipo è:
\begin{prototype}{sys/timerfd.h}
{int timerfd\_create(int clockid, int flags)}
\begin{errlist}
\item[\errcode{EINVAL}] l'argomento \param{clockid} non è
\const{CLOCK\_MONOTONIC} o \const{CLOCK\_REALTIME}, o
- l'argomento \param{flag} non è valido o diverso da zero per kernel
+ l'argomento \param{flag} non è valido, o è diverso da zero per kernel
precedenti il 2.6.27.
\item[\errcode{ENOMEM}] non c'è memoria sufficiente per creare un nuovo file
descriptor di \func{signalfd}.
}
\end{prototype}
-La funzione prende come primo argomento il tipo di orologio a cui il timer
-deve fare riferimento, il cui significato è già stato illustrato in
-tab.~\ref{tab:sig_timer_clockid_types}, ma i soli valori validi sono
-\const{CLOCK\_REALTIME} e \const{CLOCK\_MONOTONIC}.
+La funzione prende come primo argomento un intero che indica il tipo di
+orologio a cui il timer deve fare riferimento, i valori sono gli stessi delle
+funzioni dello standard POSIX-1.2001 già illustrati in
+tab.~\ref{tab:sig_timer_clockid_types}, ma al momento i soli utilizzabili sono
+\const{CLOCK\_REALTIME} e \const{CLOCK\_MONOTONIC}. L'argomento \param{flags},
+come l'analogo di \func{signalfd}, consente di impostare i flag per l'I/O non
+bloccante ed il \textit{close-on-exec} sul file descriptor
+restituito,\footnote{esso è stato introdotto a partire dal kernel 2.6.27, per
+ le versioni precedenti deve essere passato un valore nullo.} e deve essere
+specificato come una maschera binaria delle costanti riportate in
+tab.~\ref{tab:timerfd_flags}.
+
+\begin{table}[htb]
+ \centering
+ \footnotesize
+ \begin{tabular}[c]{|l|p{8cm}|}
+ \hline
+ \textbf{Valore} & \textbf{Significato} \\
+ \hline
+ \hline
+ \const{TFD\_NONBLOCK}& imposta sul file descriptor il flag di
+ \const{O\_NONBLOCK} per renderlo non bloccante.\\
+ \const{TFD\_CLOEXEC}& imposta il flag di \const{O\_CLOEXEC} per la
+ chiusura automatica del file descriptor nella
+ esecuzione di \func{exec}.\\
+ \hline
+ \end{tabular}
+ \caption{Valori dell'argomento \param{flags} per la funzione
+ \func{timerfd\_create} che consentono di impostare i flag del file
+ descriptor.}
+ \label{tab:timerfd_flags}
+\end{table}
+
+In caso di successo la funzione restituisce un file descriptor che può essere
+usato per leggere le notifiche delle scadenze dei timer. Come per quelli
+restituiti da \func{signalfd} anche questo file descriptor segue la semantica
+dei sistemi unix-like, in particolare resta aperto attraverso una \func{exec}
+(a meno che non si sia impostato il flag di \textit{close-on exex} con
+\const{TFD\_CLOEXEC}) e viene duplicato attraverso una \func{fork}, mantenendo
+il riferimento allo stesso \textit{timer}, così che anche il processo figlio
+
+
+per cui
+anche un processo figlio potrà ricevere informazioni sulla scadenza di un
+timer attraverso
% TODO trattare qui eventfd, timerfd introdotte con il 2.6.22
--- /dev/null
+/* test_timerfdfork.c
+ *
+ * Copyright (C) 2011 Simone Piccardi
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or (at
+ * your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+/****************************************************************
+ *
+ * Program test_timerfdfork.c:
+ * Program to test timerfd behaviour across fork's
+ *
+ * Author: Simone Piccardi
+ * Apr. 2011
+ *
+ * Usage: testtimerfdfork -h give all info's
+ *
+ ****************************************************************/
+/*
+ * Include needed headers
+ */
+#define _GNU_SOURCE
+#include <errno.h> /* error definitions and routines */
+#include <stdlib.h> /* C standard library */
+#include <unistd.h> /* unix standard library */
+#include <stdio.h> /* standard I/O library */
+#include <string.h> /* C strings library */
+#include <sys/timerfd.h> /* timerfd */
+// #include <time.h>
+
+/* Help printing routine */
+void usage(void);
+
+int main(int argc, char *argv[])
+{
+/*
+ * Variables definition
+ */
+ int i, fd;
+ struct itimerspec expiring;
+ /*
+ * Input section: decode command line parameters
+ * Use getopt function
+ */
+ opterr = 0; /* don't want writing to stderr */
+ while ( (i = getopt(argc, argv, "h")) != -1) {
+ switch (i) {
+ /*
+ * Handling options
+ */
+ case 'h': /* help option */
+ printf("Wrong -h option use\n");
+ usage();
+ return -1;
+ break;
+ case '?': /* unrecognized options */
+ printf("Unrecognized options -%c\n",optopt);
+ usage();
+ default: /* should not reached */
+ usage();
+ }
+ }
+ /* ***********************************************************
+ *
+ * Options processing completed
+ *
+ * Main code beginning
+ *
+ * ***********************************************************/
+ /* There must be 0 remaing arguments */
+ if ( (argc-optind) != 0 ) {
+ printf("From %d arguments, removed %d options\n", argc, optind);
+ usage();
+ }
+
+ fd = timerfd_create(CLOCK_MONOTONIC, TFD_NONBLOCK);
+ expiring.it_interval.tv_sec=1;
+ expiring.it_interval.tv_nsec=0;
+ expiring.it_value.tv_sec=5;
+ expiring.it_value.tv_nsec=0;
+ if (timerfd_settime(fd, 0, expiring, NULL)) {
+ perror("Cannot set timer");
+ }
+ return 0;
+}
+/*
+ * routine to print usage info and exit
+ */
+void usage(void) {
+ printf("Program testtimerfdfork : test timerfd across fork \n");
+ printf("Usage:\n");
+ printf(" testtimerfdfork [-h] \n");
+ printf(" -h print this help\n");
+
+ exit(1);
+}
+
projects / gapil.git / commitdiff