From: Simone Piccardi Date: Wed, 16 May 2001 20:29:56 +0000 (+0000) Subject: Altre modifiche X-Git-Url: https://gapil.gnulinux.it/gitweb/?a=commitdiff_plain;h=f38129d2f5315923568792875a9fa1fdb5e45d6e;p=gapil.git Altre modifiche --- diff --git a/filedir.tex b/filedir.tex index a8b3a8b..1928eb6 100644 --- 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 -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 @@ -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. -\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 @@ -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. -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} +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} @@ -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: - \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 è @@ -357,11 +448,41 @@ dichiarate nell'header file \texttt{unistd.h}. \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 -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} @@ -489,15 +610,10 @@ per cambiare directory di lavoro. \end{prototype} - - - \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} @@ -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