Risistemata versione del programma di esempio di {{{splice}}},

[gapil.git] / fileadv.tex

diff --git a/fileadv.tex b/fileadv.tex
index 1581fbb97b146a1b5fb07e75af4549b850fc0b84..a7851b65ab0347b71be5be874181dce85a6225a7 100644 (file)
--- a/fileadv.tex
+++ b/fileadv.tex
@@ -2963,16 +2963,39 @@ l'argomento in sez.~\ref{sec:ipc_unix}). Dal punto di vista concettuale allora
 l'oggetto \textsl{buffer in kernel space}.
 
 Così se per una \textit{pipe} o una \textit{fifo} il buffer viene utilizzato
-(come illustrato in fig.~\ref{fig:ipc_pipe_singular}) come area di memoria
-dove appoggiare i dati che vengono trasferiti da un capo all'altro della
-stessa, creando un meccanismo di comunicazione fra processi, nel caso di
-\func{splice} il buffer viene usato o come fonte dei dati che con saranno
-scritti su un file, o come destinazione dei dati che vengono letti da un file.
-
-
-
+come area di memoria dove appoggiare i dati che vengono trasferiti da un capo
+all'altro della stessa (vedi fig.~\ref{fig:ipc_pipe_singular}) per creare un
+meccanismo di comunicazione fra processi, nel caso di \funcd{splice} il buffer
+viene usato o come fonte dei dati che saranno scritti su un file, o come
+destinazione dei dati che vengono letti da un file. La funzione infatti è una
+interfaccia generica che consente di trasferire dati da un buffer ad un file o
+viceversa; il suo prototipo, accessibile solo avendo definito
+\macro{\_GNU\_SOURCE},\footnote{ovviamente, essendo come detto la funzione
+  totalmente specifica di Linux, essa non è prevista da nessuno standard e
+  deve essere evitata se si vogliono scrivere programmi portabili.} è:
+\begin{functions}  
+  \headdecl{fcntl.h} 
 
+  \funcdecl{}
+  
+  Trasferisce dati da un file verso una pipe o viceversa.
 
+  \bodydesc{La funzione restituisce il numero di byte trasferiti in caso di
+    successo e $-1$ in caso di errore, nel qual caso \var{errno} assumerà uno
+    dei valori:
+    \begin{errlist}
+    \item[\errcode{EAGAIN}] si è impostata la modalità non bloccante su
+      \param{out\_fd} e la scrittura si bloccherebbe.
+    \item[\errcode{EINVAL}] i file descriptor non sono validi, o sono bloccati
+      (vedi sez.~\ref{sec:file_locking}), o \func{mmap} non è disponibile per
+      \param{in\_fd}.
+    \item[\errcode{EIO}] si è avuto un errore di lettura da \param{in\_fd}.
+    \item[\errcode{ENOMEM}] non c'è memoria sufficiente per la lettura da
+      \param{in\_fd}.
+    \end{errlist}
+    ed inoltre \errcode{EBADF} e \errcode{EFAULT}.
+  }
+\end{functions}