\chapter{I file: l'interfaccia standard Unix}
\label{cha:file_unix_interface}
+
Esamineremo in questo capitolo la prima delle due interfacce di programmazione
per i file, quella dei \textit{file descriptor}, nativa di Unix. Questa è
l'interfaccia di basso livello provvista direttamente dalle system call, che
file. Può causare corruzione del file con NFS se più di un processo scrive
allo stesso tempo.\footnotemark\\
\macro{O\_NONBLOCK} & il file viene aperto in modalità non bloccante per
- le operazioni di I/O: questo significa il fallimento di una \func{read} in
- assenza di dati da leggere e quello di una \func{write} in caso di
+ le operazioni di I/O: questo significa il fallimento di \func{read} in
+ assenza di dati da leggere e quello di \func{write} in caso di
impossibilità di scrivere immediatamente. L'opzione è effettiva solo per
le fifo e per alcuni file di dispositivo. \\
\macro{O\_NDELAY} & in Linux\footnotemark\ è sinonimo di
\macro{O\_NONBLOCK}.\\
- \macro{O\_ASYNC} & apre il file per l'input/output in modalità
- asincrona. Quando è settato viene generato un segnale di \macro{SIGIO}
- tutte le volte che è disponibile dell'input sul file. \\
+ \macro{O\_ASYNC} & apre il file per l'I/O in modalità
+ asincrona (vedi \secref{sec:file_asyncronous_io}). Quando è settato viene
+ generato il segnale \macro{SIGIO} tutte le volte che sono disponibili
+ dati in input sul file. \\
\macro{O\_SYNC} & apre il file per l'input/output sincrono, ogni
\func{write} bloccherà fino al completamento della scrittura di tutti dati
sul sull'hardware sottostante.\\
\macro{EAGAIN} non sono errori. La prima si verifica quando la \func{read} è
bloccata in attesa di dati in ingresso e viene interrotta da un segnale; in
tal caso l'azione da prendere è quella di rieseguire la funzione. Torneremo
-sull'argomento in \secref{sec:signal_xxx}.
+sull'argomento in \secref{sec:sig_gen_beha}.
La seconda si verifica quando il file è in modalità non bloccante e non ci
sono dati in ingresso: la funzione allora ritorna immediatamente con un errore
L'uso principale di queste funzioni è per la redirezione dell'input e
dell'output fra l'esecuzione di una \func{fork} e la successiva \func{exec};
diventa così possibile associare un file (o una pipe) allo standard input o
-allo standard output, torneremo su questo uso in \secref{sec:ipc_pipes} quando
-tratteremo le pipe.
+allo standard output, torneremo su questo uso in \secref{sec:ipc_pipe_use}
+quando tratteremo le pipe.
\subsection{La funzione \func{fcntl}}
di \tabref{tab:file_open_flags}).
\item[\macro{F\_SETFL}] setta il \textit{file status flag} al valore
specificato da \param{arg}, possono essere settati solo i bit riportati
- nella terza sezione di \tabref{tab:file_open_flags} (da verificare).
+ nella terza sezione di \tabref{tab:file_open_flags}.\footnote{NdA da
+ verificare.}
\item[\macro{F\_GETLK}] se un file lock è attivo restituisce nella struttura
\param{lock} la struttura \type{flock} che impedisce l'acquisizione del
blocco, altrimenti setta il campo \var{l\_type} a \macro{F\_UNLCK} (per i
\item[\macro{F\_SETOWN}] setta il processo o process group che riceverà i
segnali \macro{SIGIO} e \macro{SIGURG} per gli eventi associati al file
descriptor \var{fd}. I process group sono settati usando valori negativi.
-\item[\macro{F\_GETSIG}] restituisce il segnale mandato quando ci sono dati
- disponibili in input sul file descriptor. Il valore 0 indica il default (che
- è \macro{SIGIO}), un valore diverso da zero indica il segnale richiesto,
- (che può essere lo stesso \macro{SIGIO}), nel qual caso al manipolatore del
- segnale, se installato con \macro{SA\_SIGINFO}, vengono rese disponibili
- informazioni ulteriori informazioni.
+\item[\macro{F\_GETSIG}] restituisce il valore del segnale mandato quando ci
+ sono dati disponibili in input su un file descriptor aperto o settato in I/O
+ asincrono. Il valore 0 indica il valore default (che è \macro{SIGIO}), un
+ valore diverso da zero indica il segnale richiesto, (che può essere lo
+ stesso \macro{SIGIO}).
\item[\macro{F\_SETSIG}] setta il segnale da inviare quando diventa possibile
- effettuare I/O sul file descriptor. Il valore zero indica il default
- (\macro{SIGIO}), ogni altro valore permette di rendere disponibile al
- manipolatore del segnale ulteriori informazioni se si è usata
- \macro{SA\_SIGINFO}.
+ effettuare I/O sul file descriptor in caso di I/O asincrono. Il valore zero
+ indica di usare il segnale di default, \macro{SIGIO}. Un altro valore
+ (compreso lo stesso \macro{SIGIO}) specifica il segnale voluto; l'uso di un
+ valore diverso da zero permette inoltre, se si è installato il manipolatore
+ del segnale come \var{sa\_sigaction} usando \macro{SA\_SIGINFO}, (vedi
+ \secref{sec:sig_sigaction}), di rendere disponibili al manipolatore
+ informazioni ulteriori informazioni riguardo il file che ha generato il
+ segnale attraverso i valori restituiti in \var{siginfo\_t} (come vedremo in
+ \secref{sec:file_asyncronous_io}).
\end{basedescript}
La maggior parte delle funzionalità di \func{fcntl} sono troppo avanzate per
\begin{prototype}{sys/ioctl.h}{int ioctl(int fd, int request, ...)}
Manipola il dispositivo sottostante, usando il parametro \param{request} per
specificare l'operazione richiesta e il terzo parametro (usualmente di tipo
- \param{char * argp}) per il trasferimento dell'informazione necessaria.
+ \param{char * argp} o \param{int argp}) per il trasferimento
+ dell'informazione necessaria.
\bodydesc{La funzione nella maggior parte dei casi ritorna 0, alcune
operazioni usano però il valore di ritorno per restituire informazioni. In
caso di errore viene sempre restituito -1 e \var{errno} viene settata ad
uno dei valori seguenti:
\begin{errlist}
- \item[\macro{ENOTTY}] il file \param{fd} non è associato con un device.
+ \item[\macro{ENOTTY}] il file \param{fd} non è associato con un device, o la
+ richiesta non è applicabile all'oggetto a cui fa riferimento \param{fd}.
\item[\macro{EINVAL}] gli argomenti \param{request} o \param{argp} non sono
validi.
\end{errlist}
La funzione serve in sostanza per fare tutte quelle operazioni che non si
adattano al design dell'architettura dei file e che non è possibile effettuare
-con le funzioni esaminate finora. Per questo motivo non è possibile fare altro
-che darne una descrizione generica; torneremo ad esaminarla in seguito, quando
-si tratterà di applicarla ad alcune problematiche specifiche.
+con le funzioni esaminate finora. Esse vengono selezionate attraverso il
+valore di \param{request} e gli eventuali risultati possono essere restituiti
+sia attraverso il valore di ritorno che attraverso il terzo argomento
+\param{argp}. Sono esempi delle operazioni gestite con una \func{ioctl}:
+\begin{itemize*}
+\item il cambiamento dei font di un terminale.
+\item l'esecuzione di una traccia audio di un CDROM.
+\item i comandi di avanti veloce e riavvolgimento di un nastro.
+\item il comando di espulsione di un dispositivo rimovibile.
+\item il settaggio della velocità trasmissione di una linea seriale.
+\item il settaggio della frequenza e della durata dei suoni emessi dallo
+ speaker.
+\end{itemize*}
+
+In generale ogni dispositivo ha un suo insieme di possibili diverse operazioni
+effettuabili attraverso \func{ioctl}, che sono definite nell'header file
+\file{sys/ioctl.h}, e devono essere usate solo sui dispositivi cui fanno
+riferimento. Infatti anche se in genere i valori di \param{request} sono
+opportunamente differenziati a seconda del dispositivo\footnote{il kernel usa
+ un apposito \textit{magic number} per distinguere ciascun dispositivo nella
+ definizione delle macro da usare per \param{request}, in modo da essere
+ sicuri che essi siano sempre diversi, ed il loro uso causi al più un errore.
+ Si veda il capitolo quinto di \cite{LinDevDri} per una trattazione
+ dettagliata dell'argomento.} in alcuni casi, relativi a valori assegnati
+prima che questa differenziazione diventasse pratica corrente si potrebbe
+avere
+
+Per questo motivo non è possibile fare altro che darne una descrizione
+generica; torneremo ad esaminare in seguito quelle relative ad alcuni casi
+specifici (ad esempio la gestione dei terminali è effettuata attraverso
+\func{ioctl} in quasi tutte le implementazioni di Unix), qui riportiamo solo i
+valori che sono definiti per ogni file:
+\begin{basedescript}{\desclabelwidth{2.0cm}}
+\item[\macro{FIOCLEX}] Setta il bit di \textit{close on exec}.
+\item[\macro{FIONCLEX}] Cancella il bit di \textit{close on exec}.
+\item[\macro{FIOASYNC}] Abilita l'I/O asincrono.
+\item[\macro{FIONBIO}] Abilità l'I/O in modalità non bloccante.
+\end{basedescript}
+relativi ad operazioni comunque eseguibili anche attraverso \func{fcntl}.
%%% Local Variables:
projects / gapil.git / blobdiff