Valore massimo del tipo di dato
\type{ssize\_t}.\\
\texttt{\_SC\_CLK\_TCK} & \const{CLK\_TCK} &
- Il numero di \itindex{clock~tick}
- \textit{clock tick} al secondo,
+ Il numero di \textit{clock tick} al secondo,
cioè l'unità di misura del
- \itindex{process~time} \textit{process
- time} (vedi
+ \textit{process time} (vedi
sez.~\ref{sec:sys_unix_time}).\\
\texttt{\_SC\_JOB\_CONTROL}&\macro{\_POSIX\_JOB\_CONTROL}&
Indica se è supportato il \textit{job
\const{LINK\_MAX} &8 & Numero massimo di link a un file.\\
\const{NAME\_MAX}& 14 & Lunghezza in byte di un nome di file. \\
\const{PATH\_MAX}& 256 & Lunghezza in byte di un \textit{pathname}.\\
- \const{PIPE\_BUF}&4096 & Byte scrivibili atomicamente in una pipe
+ \const{PIPE\_BUF}&4096 & Byte scrivibili atomicamente in una \textit{pipe}
(vedi sez.~\ref{sec:ipc_pipes}).\\
\const{MAX\_CANON}&255 & Dimensione di una riga di terminale in modo
canonico (vedi sez.~\ref{sec:term_io_design}).\\
\const{\_POSIX\_PATH\_MAX}& 256 & Lunghezza in byte di un
\textit{pathname}.\\
\const{\_POSIX\_PIPE\_BUF}& 512 & Byte scrivibili atomicamente in una
- pipe.\\
+ \textit{pipe}.\\
\const{\_POSIX\_MAX\_CANON}&255 & Dimensione di una riga di
terminale in modo canonico.\\
\const{\_POSIX\_MAX\_INPUT}&255 & Spazio disponibile nella coda di input
motivo viene sovrascritta ad ogni nuova invocazione, lo stesso dicasi per la
memoria dove sono scritte le stringhe a cui i puntatori in essa contenuti
fanno riferimento. Ovviamente questo implica che dette funzioni non possono
-essere \index{funzioni!rientranti} rientranti; per questo motivo ne esistono
-anche due versioni alternative (denotate dalla solita estensione \code{\_r}),
-i cui prototipi sono:
+essere rientranti; per questo motivo ne esistono anche due versioni
+alternative (denotate dalla solita estensione \code{\_r}), i cui prototipi
+sono:
\begin{funcproto}{
\fhead{pwd.h}
\end{funcproto}
Come per le precedenti per gli utenti esistono anche le analoghe versioni
-\index{funzioni!rientranti} rientranti che di nuovo utilizzano la stessa
-estensione \code{\_r}; i loro prototipi sono:
+rientranti che di nuovo utilizzano la stessa estensione \code{\_r}; i loro
+prototipi sono:
\begin{funcproto}{
\fhead{grp.h}
\hline
\funcm{fgetpwent} & Legge una voce dal file di registro degli utenti
specificato.\\
- \funcm{fgetpwent\_r}& Come la precedente, ma \index{funzioni!rientranti}
- rientrante.\\
+ \funcm{fgetpwent\_r}& Come la precedente, ma rientrante.\\
\funcm{putpwent} & Immette una voce in un file di registro degli
utenti.\\
\funcm{getpwent} & Legge una voce da \conffile{/etc/passwd}.\\
- \funcm{getpwent\_r} & Come la precedente, ma \index{funzioni!rientranti}
- rientrante.\\
+ \funcm{getpwent\_r} & Come la precedente, ma rientrante.\\
\funcm{setpwent} & Ritorna all'inizio di \conffile{/etc/passwd}.\\
\funcm{endpwent} & Chiude \conffile{/etc/passwd}.\\
\funcm{fgetgrent} & Legge una voce dal file di registro dei gruppi
specificato.\\
- \funcm{fgetgrent\_r}& Come la precedente, ma \index{funzioni!rientranti}
- rientrante.\\
+ \funcm{fgetgrent\_r}& Come la precedente, ma rientrante.\\
\funcm{putgrent} & Immette una voce in un file di registro dei gruppi.\\
\funcm{getgrent} & Legge una voce da \conffile{/etc/group}.\\
- \funcm{getgrent\_r} & Come la precedente, ma \index{funzioni!rientranti}
- rientrante.\\
+ \funcm{getgrent\_r} & Come la precedente, ma rientrante.\\
\funcm{setgrent} & Ritorna all'inizio di \conffile{/etc/group}.\\
\funcm{endgrent} & Chiude \conffile{/etc/group}.\\
\hline
Come già visto in sez.~\ref{sec:sys_user_group}, l'uso di strutture allocate
staticamente rende le funzioni di lettura dei dati appena illustrate non
-\index{funzioni!rientranti} rientranti. Per questo motivo le \acr{glibc}
-forniscono anche delle versioni \index{funzioni!rientranti} rientranti:
-\func{getutent\_r}, \func{getutid\_r}, \func{getutline\_r}, che invece di
-restituire un puntatore restituiscono un intero e prendono due argomenti
-aggiuntivi, i rispettivi prototipi sono:
+rientranti. Per questo motivo le \acr{glibc} forniscono anche delle versioni
+rientranti: \func{getutent\_r}, \func{getutid\_r}, \func{getutline\_r}, che
+invece di restituire un puntatore restituiscono un intero e prendono due
+argomenti aggiuntivi, i rispettivi prototipi sono:
\begin{funcproto}{
\fhead{utmp.h}
\end{funcproto}
Le funzioni si comportano esattamente come le precedenti analoghe non
-\index{funzioni!rientranti} rientranti, solo che restituiscono il risultato
-all'indirizzo specificato dal primo argomento aggiuntivo \param{buffer} mentre
-il secondo, \param{result)} viene usato per restituire il puntatore al buffer
-stesso.
+rientranti, solo che restituiscono il risultato all'indirizzo specificato dal
+primo argomento aggiuntivo \param{buffer} mentre il secondo, \param{result)}
+viene usato per restituire il puntatore al buffer stesso.
Infine le \acr{glibc} forniscono altre due funzioni, \funcd{updwtmp} e
\funcd{logwtmp}, come estensione per scrivere direttamente delle voci nel file
provocato. A questo comportamento generico fanno eccezione \const{RLIMIT\_CPU}
in cui si ha in comportamento diverso per il superamento dei due limiti e
\const{RLIMIT\_CORE} che influenza soltanto la dimensione o l'eventuale
-creazione dei file di \itindex{core~dump} \textit{core dump} (vedi
-sez.~\ref{sec:sig_standard}).
+creazione dei file di \textit{core dump} (vedi sez.~\ref{sec:sig_standard}).
Per permettere di leggere e di impostare i limiti di utilizzo delle risorse da
parte di un processo sono previste due funzioni di sistema, \funcd{getrlimit}
\textit{Address Space}, (vedi sez.~\ref{sec:proc_mem_gen}). Se il limite
viene superato dall'uso di funzioni come \func{brk}, \func{mremap} o
\func{mmap} esse falliranno con un errore di \errcode{ENOMEM}, mentre se il
- superamento viene causato dalla crescita dello \itindex{stack}
- \textit{stack} il processo riceverà un segnale di \signal{SIGSEGV}. Dato che
- il valore usato è un intero di tipo \ctyp{long} nelle macchine a 32 bit
- questo può assumere un valore massimo di 2Gb (anche se la memoria
- disponibile può essere maggiore), in tal caso il limite massimo indicabile
- resta 2Gb, altrimenti la risorsa si dà per non limitata.
+ superamento viene causato dalla crescita dello \textit{stack} il processo
+ riceverà un segnale di \signal{SIGSEGV}. Dato che il valore usato è un
+ intero di tipo \ctyp{long} nelle macchine a 32 bit questo può assumere un
+ valore massimo di 2Gb (anche se la memoria disponibile può essere maggiore),
+ in tal caso il limite massimo indicabile resta 2Gb, altrimenti la risorsa si
+ dà per non limitata.
\item[\const{RLIMIT\_CORE}] Questa risorsa indica, in byte, la massima
- dimensione per un file di \itindex{core~dump} \textit{core dump} (vedi
+ dimensione per un file di \textit{core dump} (vedi
sez.~\ref{sec:sig_standard}) creato nella terminazione di un processo. File
di dimensioni maggiori verranno troncati a questo valore, mentre con un
- valore nullo si bloccherà la creazione dei \itindex{core~dump} \textit{core
- dump}.
+ valore nullo si bloccherà la creazione dei \textit{core dump}.
\item[\const{RLIMIT\_CPU}] Questa risorsa indica, in secondi, il massimo tempo
di CPU (vedi sez.~\ref{sec:sys_cpu_times}) che il processo può usare. Il
introdotto con il kernel 2.6.8.
\item[\const{RLIMIT\_STACK}] Questa risorsa indica, in byte, la massima
- dimensione dello \itindex{stack} \textit{stack} del processo. Se il processo
- esegue operazioni che estendano lo \textit{stack} oltre questa dimensione
- riceverà un segnale di \signal{SIGSEGV}.
+ dimensione dello \textit{stack} del processo. Se il processo esegue
+ operazioni che estendano lo \textit{stack} oltre questa dimensione riceverà
+ un segnale di \signal{SIGSEGV}.
A partire dal kernel 2.6.23 questo stesso limite viene applicato per la gran
parte delle architetture anche ai dati che possono essere passati come
\end{basedescript}
La somma di \textit{user time} e \textit{system time} indica il
-\itindex{process~time} \textit{process time}, vale a dire il tempo di
-processore totale che il sistema ha effettivamente utilizzato per eseguire il
-programma di un certo processo. Si può ottenere un riassunto dei valori di
-questi tempi quando si esegue un qualsiasi programma lanciando quest'ultimo
-come argomento del comando \cmd{time}.
-
-Come accennato il \itindex{process~time} \textit{process time} viene misurato
-nei cosiddetti \itindex{clock~tick} \textit{clock tick}. Un tempo questo
-corrispondeva al numero di interruzioni effettuate dal timer di sistema, oggi
-lo standard POSIX richiede che esso sia espresso come multiplo della costante
-\const{CLOCKS\_PER\_SEC} che deve essere definita come 1000000, qualunque sia
-la risoluzione reale dell'orologio di sistema e la frequenza delle
-interruzioni del timer che, come accennato in sez.~\ref{sec:proc_hierarchy} e
-come vedremo a breve, è invece data dalla costante \const{HZ}.
+\textit{process time}, vale a dire il tempo di processore totale che il
+sistema ha effettivamente utilizzato per eseguire il programma di un certo
+processo. Si può ottenere un riassunto dei valori di questi tempi quando si
+esegue un qualsiasi programma lanciando quest'ultimo come argomento del
+comando \cmd{time}.
+
+\itindbeg{clock~tick}
+
+Come accennato il \textit{process time} viene misurato nei cosiddetti
+\textit{clock tick}. Un tempo questo corrispondeva al numero di interruzioni
+effettuate dal timer di sistema, oggi lo standard POSIX richiede che esso sia
+espresso come multiplo della costante \const{CLOCKS\_PER\_SEC} che deve essere
+definita come 1000000, qualunque sia la risoluzione reale dell'orologio di
+sistema e la frequenza delle interruzioni del timer che, come accennato in
+sez.~\ref{sec:proc_hierarchy} e come vedremo a breve, è invece data dalla
+costante \const{HZ}.
Il tipo di dato usato per questo tempo, \type{clock\_t}, con questa
convenzione ha una risoluzione del microsecondo. Ma non tutte le funzioni di
sistema come vedremo seguono questa convenzione, in tal caso il numero di
-\itindex{clock~tick} \textit{clock tick} al secondo può essere ricavato anche
-attraverso \func{sysconf} richiedendo il valore della costante
-\const{\_SC\_CLK\_TCK} (vedi sez.~\ref{sec:sys_limits}). Il vecchio simbolo
-\const{CLK\_TCK} definito in \headfile{time.h} è ormai considerato obsoleto e
-non deve essere usato.
+\textit{clock tick} al secondo può essere ricavato anche attraverso
+\func{sysconf} richiedendo il valore della costante \const{\_SC\_CLK\_TCK}
+(vedi sez.~\ref{sec:sys_limits}). Il vecchio simbolo \const{CLK\_TCK}
+definito in \headfile{time.h} è ormai considerato obsoleto e non deve essere
+usato.
In realtà tutti calcoli dei tempi vengono effettuati dal kernel per il
cosiddetto \textit{software clock}, utilizzando il \textit{timer di sistema} e
compilazione del kernel, con un default di 250 e valori possibili di 100, 250,
1000. Dal 2.6.20 è stato aggiunto anche il valore 300 che è divisibile per le
frequenze di refresh della televisione (50 o 60 Hz). Si può pensare che questi
-valori determinino anche la corrispondente durata dei \itindex{clock~tick}
-\textit{clock tick}, ma in realtà questa granularità viene calcolata in
-maniera indipendente usando la costante del kernel \const{USER\_HZ}.
+valori determinino anche la corrispondente durata dei \textit{clock tick}, ma
+in realtà questa granularità viene calcolata in maniera indipendente usando la
+costante del kernel \const{USER\_HZ}.
Fino al kernel 2.6.21 la durata di un \textit{jiffy} costituiva la risoluzione
massima ottenibile nella misura dei tempi impiegabile in una \textit{system
risoluzione possibile fornita dall'hardware. Torneremo su questo in
sez.~\ref{sec:sig_timer_adv}.
+\itindend{clock~tick}
\subsection{La gestione del \textit{process time}}
\var{errno} non viene usata.}
\end{funcproto}
-La funzione restituisce il tempo in \itindex{clock~tick} \textit{clock tick}
-ma la \acr{glibc} segue lo standard POSIX e quindi se si vuole il tempo in
-secondi occorre dividere il risultato per la costante
-\const{CLOCKS\_PER\_SEC}. In genere \type{clock\_t} viene rappresentato come
-intero a 32 bit, il che comporta un valore massimo corrispondente a circa 72
-minuti, dopo i quali il contatore riprenderà lo stesso valore iniziale.
+La funzione restituisce il tempo in \textit{clock tick} ma la \acr{glibc}
+segue lo standard POSIX e quindi se si vuole il tempo in secondi occorre
+dividere il risultato per la costante \const{CLOCKS\_PER\_SEC}. In genere
+\type{clock\_t} viene rappresentato come intero a 32 bit, il che comporta un
+valore massimo corrispondente a circa 72 minuti, dopo i quali il contatore
+riprenderà lo stesso valore iniziale.
La funzione è presente anche nello standard ANSI C, ma in tal caso non è
previsto che il valore ritornato indichi un intervallo di tempo ma solo un
2.6.9.
A differenza di quanto avviene per \func{clock} i valori restituiti nei campi
-di una struttura \struct{tms} sono misurati in numero di \itindex{clock~tick}
+di una struttura \struct{tms} sono misurati in numero di
\textit{clock tick} effettivi e non in multipli di \const{CLOCKS\_PER\_SEC},
pertanto per ottenere il valore effettivo in secondi occorrerà dividere per il
risultato di \code{sysconf(\_SC\_CLK\_TCK)}.
momento dell'avvio del kernel. Con il kernel 2.6 si fa riferimento a
$2^{32}/\mathtt{HZ}-300$ secondi prima dell'avvio.
-Considerato che il numero dei \itindex{clock~tick} \textit{clock tick} per un
-kernel che è attivo da molto tempo può eccedere le dimensioni per il tipo
-\type{clock\_t} il comportamento più opportuno per i programmi è di ignorare
-comunque il valore di ritorno della funzione e ricorrere alle funzioni per il
-tempo di calendario del prossimo paragrafo qualora si voglia calcolare il
-tempo effettivamente trascorso dall'inizio del programma.
+Considerato che il numero dei \textit{clock tick} per un kernel che è attivo
+da molto tempo può eccedere le dimensioni per il tipo \type{clock\_t} il
+comportamento più opportuno per i programmi è di ignorare comunque il valore
+di ritorno della funzione e ricorrere alle funzioni per il tempo di calendario
+del prossimo paragrafo qualora si voglia calcolare il tempo effettivamente
+trascorso dall'inizio del programma.
Infine si tenga presente che per dei limiti nelle convenzioni per il ritorno
dei valori delle \textit{system call} su alcune architetture hardware (ed in
specificato nel campo
\var{constant} di \struct{timex}.\\
\const{ADJ\_TICK} & 0x4000 & Imposta il valore dei \textit{tick}
- \itindex{clock~tick} del timer in
+ del timer in
microsecondi, espresso nel campo
\var{tick} di \struct{timex}.\\
\const{ADJ\_OFFSET\_SINGLESHOT}&0x8001&Chiede uno spostamento una tantum
del fuso orario. In realtà \func{ctime} è banalmente definita in termini di
\func{asctime} come \code{asctime(localtime(t)}.
-Dato che l'uso di una stringa statica rende le funzioni non
-\index{funzioni!rientranti} rientranti POSIX.1c e SUSv2 prevedono due
-sostitute \index{funzioni!rientranti} rientranti, il cui nome è al solito
+Dato che l'uso di una stringa statica rende le funzioni non rientranti
+POSIX.1c e SUSv2 prevedono due sostitute rientranti, il cui nome è al solito
ottenuto aggiungendo un \code{\_r}, che prendono un secondo argomento
\code{char *buf}, in cui l'utente deve specificare il buffer su cui la stringa
deve essere copiata (deve essere di almeno 26 caratteri).
Anche in questo caso le due funzioni restituiscono l'indirizzo di una
struttura allocata staticamente, per questo sono state definite anche altre
-due versioni \index{funzioni!rientranti} rientranti (con la solita estensione
-\code{\_r}), che prevedono un secondo argomento \code{struct tm *result},
-fornito dal chiamante, che deve preallocare la struttura su cui sarà
-restituita la conversione. La versione rientrante di \func{localtime} però non
-effettua la chiamata preventiva a \func{tzset} che deve essere eseguita a cura
-dell'utente.
+due versioni rientranti (con la solita estensione \code{\_r}), che prevedono
+un secondo argomento \code{struct tm *result}, fornito dal chiamante, che deve
+preallocare la struttura su cui sarà restituita la conversione. La versione
+rientrante di \func{localtime} però non effettua la chiamata preventiva a
+\func{tzset} che deve essere eseguita a cura dell'utente.
Infine \func{mktime} esegue la conversione di un \textit{broken-down time} a
partire da una struttura \struct{tm} restituendo direttamente un valore di
modificata dal programma; essa è utilizzabile solo fino ad una chiamata
successiva a \func{strerror} o \func{perror} e nessun'altra funzione di
libreria tocca questa stringa. In ogni caso l'uso di una stringa statica rende
-la funzione non \index{funzioni!rientranti} rientrante, per cui nel caso si
-usino i \itindex{thread} \textit{thread} la \acr{glibc} fornisce una apposita
-versione \index{funzioni!rientranti} rientrante \funcd{strerror\_r}, il cui
-prototipo è:
+la funzione non rientrante, per cui nel caso si usino i \itindex{thread}
+\textit{thread} la \acr{glibc} fornisce una apposita versione rientrante
+\funcd{strerror\_r}, il cui prototipo è:
\begin{funcproto}{
\fhead{string.h}