From: Simone Piccardi Date: Sat, 2 Apr 2011 14:33:16 +0000 (+0000) Subject: Materiale su timerfd X-Git-Url: https://gapil.gnulinux.it/gitweb/?a=commitdiff_plain;h=bd8c369514b9f49a58fe22c095f5313a521e6ee2;p=gapil.git Materiale su timerfd --- diff --git a/fileadv.tex b/fileadv.tex index 2a32a3e..b1cb348 100644 --- a/fileadv.tex +++ b/fileadv.tex @@ -2111,12 +2111,19 @@ utilizzare le funzioni dell'\textit{I/O multiplexing} per attendere allo 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)} @@ -2128,7 +2135,7 @@ prototipo è: \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}. @@ -2140,10 +2147,51 @@ prototipo è: } \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 diff --git a/signal.tex b/signal.tex index 2fa2d6f..644e05d 100644 --- a/signal.tex +++ b/signal.tex @@ -2665,7 +2665,9 @@ tab.~\ref{tab:sig_timer_clockid_types}. amministrativi.\\ \const{CLOCK\_MONOTONIC} & Orologio che indica un tempo monotono crescente (a partire da un tempo iniziale non - specificato) che non può essere modificato.\\ + specificato) che non può essere modificato e + non cambia neanche in caso di reimpostazione + dell'orologio di sistema.\\ \const{CLOCK\_MONOTONIC\_RAW}&Simile al precedente, ma non subisce gli aggiustamenti dovuti all'uso di NTP (viene usato per fare riferimento ad una fonte diff --git a/sources/test_timerfdfork.c b/sources/test_timerfdfork.c new file mode 100644 index 0000000..04fad75 --- /dev/null +++ b/sources/test_timerfdfork.c @@ -0,0 +1,108 @@ +/* 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 /* error definitions and routines */ +#include /* C standard library */ +#include /* unix standard library */ +#include /* standard I/O library */ +#include /* C strings library */ +#include /* timerfd */ +// #include + +/* 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); +} +