Altre modifiche

diff --git a/filedir.tex b/filedir.tex
index a8b3a8beb2b959193d127858cb07296729976f02..1928eb65bcf8458937e4cfcd6603fe77085cb02c 100644 (file)
--- a/filedir.tex
+++ b/filedir.tex
@@ -6,7 +6,7 @@ directories, ed in particolare approfondiremo i dettagli su come 
 la struttura dei files in un sistema unix; esamineremo poi come è strutturato
 il sistema base di protezioni e controllo di accesso ai files, e tutta
 l'interfaccia che permette la manipolazione dei vari attributi di files e
 la struttura dei files in un sistema unix; esamineremo poi come è strutturato
 il sistema base di protezioni e controllo di accesso ai files, e tutta
 l'interfaccia che permette la manipolazione dei vari attributi di files e

-directories. Tutto quello che riguarda invece la manipolazione dei contenuti e
+directories. Tutto quello che riguarda invece la manipolazione dei contenuti è

 lasciato ai capitoli successivi.
 
 Le funzioni che esamineremo in questo capitolo pertanto sono quelle che
 lasciato ai capitoli successivi.
 
 Le funzioni che esamineremo in questo capitolo pertanto sono quelle che


@@ -67,8 +67,8 @@ la directory che contiene il riferimento alla directory corrente; nel caso
 questa sia la directory radice allora il riferimento è a se stessa.
 
 
 questa sia la directory radice allora il riferimento è a se stessa.
 
 

-\section{La manipolazione di files e directories}
-\label{sec:filedir_handling}
+\section{La manipolazione dei files}
+\label{sec:filedir_file_handling}

 
 Per capire fino in fondo le proprietà di files e directories in un sistema
 unix ed il funzionamento delle relative funzioni di manipolazione occorre una
 
 Per capire fino in fondo le proprietà di files e directories in un sistema
 unix ed il funzionamento delle relative funzioni di manipolazione occorre una


@@ -294,17 +294,81 @@ usata per essere sicuri di non lasciare file temporanei su disco in caso di
 crash dei programmi; la tecnica è quella di aprire il file e chiamare
 \texttt{unlink} subito dopo.
 
 crash dei programmi; la tecnica è quella di aprire il file e chiamare
 \texttt{unlink} subito dopo.
 

-Al contrario di quanto avviene con altri unix in linux non è possibile usare
-\texttt{unlink} per cancellare una directory
-
-
-

 \subsection{Le funzioni \texttt{remove} e \texttt{rename}}
 \label{sec:filedir_cre_canc}
 
 \subsection{Le funzioni \texttt{remove} e \texttt{rename}}
 \label{sec:filedir_cre_canc}
 

+Al contrario di quanto avviene con altri unix in linux non è possibile usare
+\texttt{unlink} sulle directory, per cancellare una directory si può usare la
+funzione \texttt{rmdir} (vedi \secref{sec:filedir_dir_creat_rem}), oppure la
+funzione \texttt{remove}. Questa è la funzione prevista dallo standard ANSI C
+per cancellare un file (e funziona anche per i sistemi che non supportano i
+link diretti), che per i file è identica alla \texttt{unlink} e per le
+directory è identica alla \texttt{rmdir}:
+
+\begin{prototype}{stdio.h}{int remove(const char *pathname)}
+  Cancella un nome dal filesystem. Usa \texttt{unlink} per i file e
+  \texttt{rmdir} per le directory.
+
+  La funzione restituisce zero in caso di successo e -1 per un errore, nel
+  qual caso il file non viene toccato. La variabile \texttt{errno} viene
+  settata secondo i seguenti codici di errore:
+  \begin{errlist} {NDT da rivedere}
+  \item \texttt{EFAULT} la stringa \texttt{filename} è fuori dello spazio di
+    indirizzi del processo.
+  \item \texttt{EACCESS} Non c'è il permesso di scrittura per la directory in
+    cui si vuole creare il nuovo link o una delle directory del pathname non
+    consente la ricerca (permesso di esecuzione).
+  \item \texttt{EPERM} il pathname indica una directory o il filesystem che
+    contiene \texttt{filename} non consente l'operazione.
+  \item \texttt{EROFS} \texttt{filename} è su un filesystem montato in sola
+    lettura.
+  \item \texttt{ENAMETOOLONG} il pathname è troppo lungo.
+  \item \texttt{ENOENT} Uno dei componenti del pathname non esiste o è un link
+    simbolico spezzato.
+  \item \texttt{ENOTDIR} Uno dei componenti del pathname non è una directory.
+  \item \texttt{ENOMEM} Memoria insufficiente nel kernel.
+  \item \texttt{ELOOP} Ci sono troppi link simbolici nella risoluzione del
+    pathname.
+  \end{errlist}    
+\end{prototype}

 
 

+Per cambiare nome ad un file si usa invece la funzione \texttt{rename}, il
+vantaggio nell'uso di questa funzione al posto della chiamata successiva di
+\texttt{unlink} e \texttt{link} è che l'operazione è eseguita atomicamente.

 
 

+\begin{prototype}{stdio.h}
+{int rename(const char *oldpath, const char *newpath)}
+  Rinomina un file, spostandolo fra directory diverse quando richiesto.

 
 

+  La funzione restituisce zero in caso di successo e -1 per un errore, nel
+  qual caso il file non viene toccato. La variabile \texttt{errno} viene
+  settata secondo i seguenti codici di errore:
+  \begin{errlist} {NDT da rivedere}
+  \item \texttt{EFAULT} la stringa \texttt{filename} è fuori dello spazio di
+    indirizzi del processo.
+  \item \texttt{EACCESS} Non c'è il permesso di scrittura per la directory in
+    cui si vuole creare il nuovo link o una delle directory del pathname non
+    consente la ricerca (permesso di esecuzione).
+  \item \texttt{EPERM} il pathname indica una directory o il filesystem che
+    contiene \texttt{filename} non consente l'operazione.
+  \item \texttt{EROFS} I file sono su un filesystem montato in sola lettura.
+  \item \texttt{ENAMETOOLONG} il pathname è troppo lungo.
+  \item \texttt{ENOENT} Uno dei componenti del pathname non esiste o è un link
+    simbolico spezzato.
+  \item \texttt{ENOTDIR} Uno dei componenti del pathname non è una directory.
+  \item \texttt{ENOMEM} Memoria insufficiente nel kernel.
+  \item \texttt{ELOOP} Ci sono troppi link simbolici nella risoluzione del
+    pathname.
+  \item \texttt{EISDIR} 
+  \item \texttt{EXDEV} 
+  \item \texttt{ENOTEMPTY} 
+  \item \texttt{EBUSY} 
+  \item \texttt{EINVAL} 
+  \item \texttt{EMLINK} 
+  \item \texttt{ENOSPC} 
+
+  \end{errlist}    
+\end{prototype}

 
 \subsection{I link simbolici}
 \label{sec:filedir_sym_link}
 
 \subsection{I link simbolici}
 \label{sec:filedir_sym_link}


@@ -344,7 +408,34 @@ dichiarate nell'header file \texttt{unistd.h}.
   di errore. La variabile \texttt{errno} viene settata secondo i codici di
   errore standard di accesso ai files (trattati in dettaglio in
   \secref{sec:filedir_access_control}) ai quali si aggiungono i seguenti:
   di errore. La variabile \texttt{errno} viene settata secondo i codici di
   errore standard di accesso ai files (trattati in dettaglio in
   \secref{sec:filedir_access_control}) ai quali si aggiungono i seguenti:

-  \begin{errlist}
+  \begin{errlist} {NDT da rivedere}
+  \item \texttt{EEXIST} Un file (o una directory) con quel nome esiste di
+    già.
+  \item \texttt{EROFS} La directory su cui si vuole inserire il nuovo link è
+    su un filesystem montato readonly.
+  \item \texttt{ENOSPC} La directory o il filesystem in cui si vuole creare il
+    link è piena e non c'è ulteriore spazio disponibile.
+  \item \texttt{ELOOP} Ci sono troppi link simbolici nella risoluzione di
+    \texttt{oldname} o di \texttt{newname}.
+  \end{errlist}
+\end{prototype}
+
+Dato che la funzione \texttt{open} segue i link simbolici, è necessaria usare
+un'altra funzione quando si vuole leggere il contenuto di un link simbolico,
+questa funzione è la:
+
+\begin{prototype}{unistd.h}
+{int readlink(const char * path, char * buff, size_t size)} 
+  Legge il contnuto del link simbolico indicato da \texttt{path} nel buffer
+  \texttt{buff} di dimensione \texttt{size}. Non chiude la stringa con un
+  carattere nullo e la tronca a \texttt{size} nel caso il buffer sia troppo
+  piccolo pe contenerla.
+
+  
+  La funzione restituisce il numero di caratteri letti dentro \texttt{buff} o
+  -1 per un errore, in caso di errore. La variabile \texttt{errno} viene
+  settata secondo i codici di errore:
+  \begin{errlist} {NDT da rivedere}

   \item \texttt{EEXIST} Un file (o una directory) con quel nome esiste di
     già.
   \item \texttt{EROFS} La directory su cui si vuole inserire il nuovo link è
   \item \texttt{EEXIST} Un file (o una directory) con quel nome esiste di
     già.
   \item \texttt{EROFS} La directory su cui si vuole inserire il nuovo link è


@@ -357,11 +448,41 @@ dichiarate nell'header file \texttt{unistd.h}.
 \end{prototype}
 
 
 \end{prototype}
 
 

+\section{Il controllo di accesso ai file}
+\label{sec:filedir_access_control}
+
+
+\subsection{I flag \texttt{suid} e \texttt{sgid}}
+\label{sec:filedir_suid_sgid}
+
+\subsection{La titolarità di nuovi files e directory}
+\label{sec:filedir_ownership}
+
+\subsection{La funzione \texttt{access}}
+\label{sec:filedir_access}
+
+\subsection{La funzione \texttt{umask}}
+\label{sec:filedir_umask}
+
+\subsection{Le funzioni \texttt{chmod} e \texttt{fchmod}}
+\label{sec:filedir_chmod}
+
+\subsection{Il flag \texttt{stiky}}
+\label{sec:filedir_stiky}
+
+\subsection{Le funzioni \texttt{chown}, \texttt{fchown} e \texttt{lchown}}
+\label{sec:filedir_chown}
+
+
+
+\section{La manipolazione delle directories}
+\label{sec:filedir_dir_handling}
+

 \subsection{Le funzioni \texttt{mkdir} e \texttt{rmdir}} 
 \label{sec:filedir_dir_creat_rem}
 
 Per creare una nuova directory si può usare la seguente funzione, omonima
 \subsection{Le funzioni \texttt{mkdir} e \texttt{rmdir}} 
 \label{sec:filedir_dir_creat_rem}
 
 Per creare una nuova directory si può usare la seguente funzione, omonima

-dell'analogo comando di shell \texttt{mkdir}; per accedere ai tipi usati 
+dell'analogo comando di shell \texttt{mkdir}; per accedere ai tipi usati

 programma deve includere il file \texttt{sys/types.h}.
 
 \begin{prototype}{sys/stat.h}
 programma deve includere il file \texttt{sys/types.h}.
 
 \begin{prototype}{sys/stat.h}


@@ -489,15 +610,10 @@ per cambiare directory di lavoro.
 \end{prototype}
 
 
 \end{prototype}
 
 

-
-
-

 \section{La manipolazione delle caratteristiche dei files}
 \label{sec:filedir_infos}
 
 
 \section{La manipolazione delle caratteristiche dei files}
 \label{sec:filedir_infos}
 
 

-
-

 \subsection{Le funzioni \texttt{stat}, \texttt{fstat} e \texttt{lstat}}
 \label{sec:filedir_stat}
 
 \subsection{Le funzioni \texttt{stat}, \texttt{fstat} e \texttt{lstat}}
 \label{sec:filedir_stat}
 


@@ -515,32 +631,6 @@ per cambiare directory di lavoro.
 
 
 
 
 
 

-\section{Il controllo di accesso ai file}
-\label{sec:filedir_access_control}
-
-
-\subsection{I flag \texttt{suid} e \texttt{sgid}}
-\label{sec:filedir_suid_sgid}
-
-\subsection{La titolarità di nuovi files e directory}
-\label{sec:filedir_ownership}
-
-\subsection{La funzione \texttt{access}}
-\label{sec:filedir_access}
-
-\subsection{La funzione \texttt{umask}}
-\label{sec:filedir_umask}
-
-\subsection{Le funzioni \texttt{chmod} e \texttt{fchmod}}
-\label{sec:filedir_chmod}
-
-\subsection{Il flag \texttt{stiky}}
-\label{sec:filedir_stiky}
-
-\subsection{Le funzioni \texttt{chown}, \texttt{fchown} e \texttt{lchown}}
-\label{sec:filedir_chown}
-
-

 
 %La struttura fondamentale che contiene i dati essenziali relativi ai file è il
 %cosiddetto \textit{inode}; questo conterrà informazioni come il
 
 %La struttura fondamentale che contiene i dati essenziali relativi ai file è il
 %cosiddetto \textit{inode}; questo conterrà informazioni come il