Finiti file temporanei e iniziata chroot, inserita sezione sullo scheduler
[gapil.git] / filedir.tex
1 \chapter{File e directory}
2 \label{cha:files_and_dirs}
3
4 In questo capitolo tratteremo in dettaglio le modalità con cui si gestiscono
5 file e directory, iniziando dalle funzioni di libreria che si usano per
6 copiarli, spostarli e cambiarne i nomi. Esamineremo poi l'interfaccia che
7 permette la manipolazione dei vari attributi di file e directory ed alla
8 fine faremo una trattazione dettagliata su come è strutturato il sistema base
9 di protezioni e controllo di accesso ai file e sulle funzioni che ne
10 permettono la gestione. Tutto quello che riguarda invece la manipolazione del
11 contenuto dei file è lasciato ai capitoli successivi.
12
13
14
15 \section{La gestione di file e directory}
16
17 Come già accennato in \secref{sec:file_filesystem} in un sistema unix-like la
18 gestione dei file ha delle caratteristiche specifiche che derivano
19 direttamente dall'architettura del sistema; in questa sezione esamineremo le
20 funzioni usate per manipolazione nel filesytem di file e directory, per la
21 creazione di link simbolici e diretti, per la gestione e la lettura delle
22 directory; il tutto mettendo in evidenza le conseguenze della struttura
23 standard della gestione dei file in un sistema unix-like, già accennate al
24 capitolo precedente.
25
26
27 \subsection{Le funzioni \func{link} e \func{unlink}}
28 \label{sec:file_link}
29
30 Una caratteristica comune a diversi sistemi operativi è quella di poter creare
31 dei nomi fittizi (come gli alias del MacOS o i collegamenti di Windows) che
32 permettono di fare riferimento allo stesso file chiamandolo con nomi diversi
33 o accedendovi da directory diverse.
34
35 Questo è possibile anche in ambiente unix, dove tali collegamenti sono
36 usualmente chiamati \textit{link}; ma data la struttura del sistema di
37 gestione dei file (ed in particolare quanto trattato in
38 \secref{sec:file_architecture}) ci sono due metodi sostanzialmente diversi per
39 fare questa operazione.
40
41 Come spiegato in \secref{sec:file_filesystem} l'accesso al contenuto di
42 un file su disco avviene attraverso il suo inode, e il nome che si trova in
43 una directory è solo una etichetta associata ad un puntatore a che fa
44 riferimento al suddetto inode.
45
46 Questo significa che la realizzazione di un link è immediata in quanto uno
47 stesso file può avere tanti nomi diversi allo stesso tempo, dati da
48 altrettante diverse associazioni allo stesso inode; si noti poi che nessuno di
49 questi nomi viene ad assumere una particolare preferenza rispetto agli altri.
50
51 Per aggiungere un nome ad un inode si utilizza la funzione \func{link}; si
52 suole chiamare questo tipo di associazione un collegamento diretto (o
53 \textit{hard link}).  Il prototipo della funzione e le sue caratteristiche
54 principali, come risultano dalla man page, sono le seguenti:
55 \begin{prototype}{unistd.h}
56 {int link(const char *oldpath, const char *newpath)}
57   Crea un nuovo collegamento diretto al file indicato da \var{oldpath}
58   dandogli nome \var{newpath}.
59   
60   \bodydesc{La funzione restituisce zero in caso di successo e -1 in
61     caso di errore. La variabile \var{errno} viene settata
62     opportunamente, i principali codici di errore sono:
63   \begin{errlist}
64   \item[\macro{EXDEV}] \var{oldpath} e \var{newpath} non sono sullo
65     stesso filesystem.
66   \item[\macro{EPERM}] il filesystem che contiene \var{oldpath} e
67     \macro{newpath} non supporta i link diretti o è una directory.
68   \item[\macro{EEXIST}] un file (o una directory) con quel nome esiste di
69     già.
70   \item[\macro{EMLINK}] ci sono troppi link al file \var{oldpath} (il
71     numero massimo è specificato dalla variabile \macro{LINK\_MAX}, vedi
72     \secref{sec:sys_limits}).
73   \end{errlist}
74   ed inoltre \macro{EACCES}, \macro{ENAMETOOLONG}, \macro{ENOTDIR},
75   \macro{EFAULT}, \macro{ENOMEM}, \macro{EROFS}, \macro{ELOOP},
76   \macro{ENOSPC}, \macro{EIO}.}
77 \end{prototype}
78
79 La creazione di un nuovo collegamento diretto non copia il contenuto del file,
80 ma si limita a creare una voce nella directory specificata con \var{newpath} e
81 ad aumentare di uno il numero di referenze al file (riportato nel campo
82 \var{st\_nlink} della struttura \var{stat}, vedi \secref{sec:file_stat})
83 aggiungendo il nuovo nome ai precedenti. Si noti che uno stesso file può
84 essere così chiamato con vari nomi in diverse directory.
85  
86 Per quanto dicevamo in \secref{sec:file_filesystem} la creazione di un
87 collegamento diretto è possibile solo se entrambi i pathname sono nello stesso
88 filesystem; inoltre il filesystem deve supportare i collegamenti diretti (il
89 meccanismo non è disponibile ad esempio con il filesystem \acr{vfat} di
90 Windows). 
91
92 La funzione inoltre opera sia sui file ordinari che sugli altri oggetti del
93 filesystem, con l'eccezione delle directory. In alcuni versioni di unix solo
94 l'amministratore è in grado di creare un collegamento diretto ad un'altra
95 directory, questo viene fatto perché con una tale operazione è possibile
96 creare dei circoli nel filesystem (vedi l'esempio mostrato in
97 \secref{sec:file_symlink}, dove riprenderemo il discorso) che molti programmi
98 non sono in grado di gestire e la cui rimozione diventerebbe estremamente
99 complicata (in genere per questo tipo di errori occorre far girare il
100 programma \cmd{fsck} per riparare il filesystem).
101
102 Data la pericolosità di questa operazione e la disponibilità dei link
103 simbolici che possono fornire la stessa funzionalità senza questi problemi,
104 nei filesystem usati in Linux questa caratteristica è stata completamente
105 disabilitata, e al tentativo di creare un link diretto ad una directory la
106 funzione restituisce l'errore \macro{EPERM}.
107
108 La rimozione di un file (o più precisamente della voce che lo referenzia
109 all'interno di una directory) si effettua con la funzione \func{unlink}; il
110 suo prototipo è il seguente:
111 \begin{prototype}{unistd.h}{int unlink(const char *pathname)}
112   Cancella il nome specificato dal pathname nella relativa directory e
113   decrementa il numero di riferimenti nel relativo inode. Nel caso di link
114   simbolico cancella il link simbolico; nel caso di socket, fifo o file di
115   dispositivo rimuove il nome, ma come per i file i processi che hanno aperto
116   uno di questi oggetti possono continuare ad utilizzarlo.
117   
118   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
119     errore, nel qual caso il file non viene toccato. La variabile
120     \var{errno} viene settata secondo i seguenti codici di errore:
121   \begin{errlist}
122   \item[\macro{EISDIR}] \var{pathname} si riferisce ad una directory
123     (valore specifico ritornato da Linux che non consente l'uso di
124     \var{unlink} con le directory, e non conforme allo standard POSIX, che
125     prescrive invece l'uso di \macro{EPERM} in caso l'operazione non sia
126     consentita o il processo non abbia privilegi sufficienti).
127   \item[\macro{EROFS}] \var{pathname} è su un filesystem montato in sola
128   lettura.
129   \item[\macro{EISDIR}] \var{pathname} fa riferimento a una directory.
130   \end{errlist}
131   ed inoltre: \macro{EACCES}, \macro{EFAULT}, \macro{ENOENT}, \macro{ENOTDIR},
132   \macro{ENOMEM}, \macro{EROFS}, \macro{ELOOP}, \macro{EIO}.}
133 \end{prototype}
134
135 Per cancellare una voce in una directory è necessario avere il permesso di
136 scrittura su di essa (dato che si va a rimuovere una voce dal suo contenuto) e
137 il diritto di esecuzione sulla directory che la contiene (torneremo in
138 dettaglio sui permessi e gli attributi in \secref{sec:file_access_control}),
139 se inoltre lo \textit{sticky} bit è settato occorrerà anche essere proprietari
140 del file o proprietari della directory (o root, per cui nessuna delle
141 restrizioni è applicata).
142
143 Una delle caratteristiche di queste funzioni è che la creazione/rimozione
144 della nome dalla directory e l'incremento/decremento del numero di riferimenti
145 nell'inode deve essere una operazione atomica (si veda
146 \secref{sec:proc_atom_oper}), per questo entrambe queste funzioni sono
147 realizzate tramite una singola system call.
148
149 Si ricordi infine che il file non viene eliminato dal disco fintanto che tutti
150 i riferimenti ad esso sono stati cancellati, solo quando il \textit{link
151   count} mantenuto nell'inode diventa zero lo spazio occupato viene rimosso. A
152 questo però si aggiunge una altra condizione, e cioè che non ci siano processi
153 che abbiano detto file aperto.  
154
155 Questa proprietà viene spesso usata per essere sicuri di non lasciare file
156 temporanei su disco in caso di crash dei programmi; la tecnica è quella di
157 aprire il file e chiamare \func{unlink} subito dopo, in questo modo il
158 contenuto del file è sempre disponibile all'interno del processo attraverso il
159 suo file descriptor (vedi \secref{sec:file_fd}) fintanto che il processo non
160 chiude il file, ma non ne resta traccia in nessuna directory, e lo spazio
161 occupato su disco viene immediatamente rilasciato alla conclusione del
162 processo (quando tutti i file vengono chiusi).
163
164
165 \subsection{Le funzioni \func{remove} e \func{rename}}
166 \label{sec:file_remove}
167
168 Al contrario di quanto avviene con altri unix in Linux non è possibile usare
169 \func{unlink} sulle directory; per cancellare una directory si può usare la
170 funzione \func{rmdir} (vedi \secref{sec:file_dir_creat_rem}), oppure la
171 funzione \func{remove}. Questa è la funzione prevista dallo standard ANSI C
172 per cancellare un file o una directory (e funziona anche per i sistemi che non
173 supportano i link diretti). Per i file è identica a \func{unlink} e per le
174 directory è identica a \func{rmdir}:
175 \begin{prototype}{stdio.h}{int remove(const char *pathname)}
176   Cancella un nome dal filesystem. Usa \func{unlink} per i file e
177   \func{rmdir} per le directory.
178   
179   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
180     errore, nel qual caso il file non viene toccato. Per i codici di
181     errore vedi quanto riportato nelle descrizioni di \func{unlink} e
182     \func{rmdir}.}
183 \end{prototype}
184
185 Per cambiare nome ad un file o a una directory (che devono comunque essere
186 nello stesso filesystem) si usa invece la funzione \func{rename}\footnote{la
187   funzione è definita dallo standard ANSI C solo per i file, POSIX estende la
188   funzione anche alle directory}, il cui prototipo è:
189 \begin{prototype}{stdio.h}
190   {int rename(const char *oldpath, const char *newpath)} 
191   
192   Rinomina \var{oldpath} in \var{newpath}, eseguendo se necessario lo
193   spostamento di un file fra directory diverse. Eventuali altri link diretti
194   allo stesso file non vengono influenzati.
195   
196   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
197     errore, nel qual caso il file non viene toccato. La variabile
198     \var{errno} viene settata secondo i seguenti codici di errore:
199   \begin{errlist} 
200   \item[\macro{EISDIR}] \var{newpath} è una directory mentre \var{oldpath} non
201     è una directory.
202   \item[\macro{EXDEV}] \var{oldpath} e \var{newpath} non sono sullo stesso
203     filesystem.
204   \item[\macro{ENOTEMPTY}] \var{newpath} è una directory già esistente e non
205     vuota.
206   \item[\macro{EBUSY}] o \var{oldpath} o \var{newpath} sono in uso da parte di
207     qualche processo (come directory di lavoro o come radice) o del sistema
208     (come mount point).
209   \item[\macro{EINVAL}] \var{newpath} contiene un prefisso di \var{oldpath} o
210     più in generale si è cercato di creare una directory come sottodirectory
211     di se stessa.
212   \item[\macro{ENOTDIR}] Uno dei componenti dei pathname non è una directory o
213     \var{oldpath} è una directory e \var{newpath} esiste e non è una
214     directory.
215   \end{errlist} 
216   ed inoltre \macro{EACCESS}, \macro{EPERM}, \macro{EMLINK}, \macro{ENOENT},
217   \macro{ENOMEM}, \macro{EROFS}, \macro{ELOOP} e \macro{ENOSPC}.}
218 \end{prototype}
219
220 Il comportamento della funzione è diverso a seconda che si voglia rinominare
221 un file o una directory; se ci riferisce a un file allora \var{newpath}, se
222 esiste, non deve essere una directory (altrimenti si ha l'errore
223 \macro{EISDIR}). Nel caso \var{newpath} indichi un file esistente questo viene
224 cancellato e rimpiazzato (atomicamente).
225
226 Se \var{oldpath} è una directory allora \var{newpath} se esiste deve essere
227 una directory vuota, altrimenti si avranno gli errori \macro{ENOTDIR} (se non
228 è una directory) o \macro{ENOTEMPTY} (se non è vuota). Chiaramente
229 \var{newpath} non può contenere \var{oldpath} altrimenti si avrà un errore
230 \macro{EINVAL}.
231
232 Se \var{oldpath} si riferisce a un link simbolico questo sarà rinominato; se
233 \var{newpath} è un link simbolico verrà cancellato come qualunque altro file.
234 Infine qualora \var{oldpath} e \var{newpath} siano due nomi dello stesso file
235 lo standard POSIX prevede che la funzione non dia errore, e non faccia nulla,
236 lasciando entrambi i nomi; Linux segue questo standard, anche se come fatto
237 notare dal manuale delle glibc, il comportamento più ragionevole sarebbe
238 quello di cancellare \var{oldpath}.
239
240 Il vantaggio nell'uso di questa funzione al posto della chiamata successiva di
241 \func{link} e \func{unlink} è che l'operazione è eseguita atomicamente, non
242 può esistere cioè nessun istante in cui un altro processo può trovare attivi
243 entrambi i nomi dello stesso file, o, in caso di sostituzione di un file
244 esistente, non trovare quest'ultimo prima che la sostituzione sia stata
245 eseguita.
246
247 In ogni caso se \var{newpath} esiste e l'operazione fallisce per un qualche
248 motivo (come un crash del kernel), \func{rename} garantisce di lasciare
249 presente una istanza di \var{newpath}, tuttavia nella sovrascrittura potrà
250 esistere una finestra in cui sia \var{oldpath} che \var{newpath} fanno
251 riferimento allo stesso file.
252
253
254 \subsection{I link simbolici}
255 \label{sec:file_symlink}
256
257 Come abbiamo visto in \secref{sec:file_link} la funzione \func{link} crea
258 riferimenti agli inodes, pertanto può funzionare soltanto per file che
259 risiedono sullo stesso filesystem e solo per un filesystem di tipo unix.
260 Inoltre abbiamo visto che in Linux non è consentito eseguire un link diretto
261 ad una directory.
262
263 Per ovviare a queste limitazioni i sistemi unix supportano un'altra forma di
264 link (i cosiddetti \textit{soft link} o \textit{symbolic link}), che sono,
265 come avviene in altri sistemi operativi, dei file speciali che contengono il
266 semplicemente il riferimento ad un altro file (o directory). In questo modo è
267 possibile effettuare link anche attraverso filesystem diversi, a file posti in
268 filesystem che non supportano i link diretti, a delle directory, e anche a
269 file che non esistono ancora.
270
271 Il sistema funziona in quanto i link simbolici sono contrassegnati come tali
272 al kernel (analogamente a quanto avviene per le directory) per cui per alcune
273 funzioni di libreria (come \func{open} o \func{stat}) dare come parametro un
274 link simbolico comporta l'applicazione della funzione al file da esso
275 specificato. La funzione che permette di creare un nuovo link simbolico è
276 \func{symlink}; il suo prototipo è:
277 \begin{prototype}{unistd.h}
278   {int symlink(const char *oldpath, const char *newpath)} 
279   Crea un nuovo link simbolico di nome \param{newpath} il cui contenuto è
280   \param{oldpath}.
281   
282   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
283     errore, nel qual caso la variabile \var{errno} restituisce i valori:
284   \begin{errlist}
285   \item[\macro{EPERM}] il filesystem che contiene \param{newpath} non supporta i
286     link simbolici.
287   \item[\macro{ENOENT}] una componente di \param{newpath} non esiste o
288     \param{oldpath} è una stringa vuota.
289   \item[\macro{EEXIST}] esiste già un file \param{newpath}.
290   \item[\macro{EROFS}] \param{newpath} è su un filesystem montato in sola
291     lettura.
292   \end{errlist}
293   ed inoltre \macro{EFAULT}, \macro{EACCES}, \macro{ENAMETOOLONG},
294   \macro{ENOTDIR}, \macro{ENOMEM}, \macro{ELOOP}, \macro{ENOSPC} e
295   \macro{EIO}.}
296 \end{prototype}
297
298 Si tenga presente che la funzione non effettua nessun controllo sull'esistenza
299 di un file di nome \param{oldpath}, ma si limita ad inserire quella stringa
300 nel link simbolico. Pertanto un link simbolico può anche riferirsi ad un file
301 che non esiste: quello che viene chiamato un \textit{dangling link},
302 letteralmente \textsl{link ciondolante}.
303
304
305 Come accennato i link simbolici sono risolti automaticamente dal kernel
306 all'invocazione delle varie system call; in \ntab\ si è riportato un elenco
307 dei comportamenti delle varie funzioni di libreria che operano sui file nei
308 confronti della risoluzione dei link simbolici, specificando quali seguono il
309 link simbolico e quali invece possono operare direttamente sul suo contenuto.
310 \begin{table}[htb]
311   \centering
312   \footnotesize
313   \begin{tabular}[c]{|l|c|c|}
314     \hline
315     \textbf{Funzione} & \textbf{Segue il link} & \textbf{Non segue il link} \\
316     \hline 
317     \hline 
318     \func{access}   & $\bullet$ &           \\
319     \func{chdir}    & $\bullet$ &           \\
320     \func{chmod}    & $\bullet$ &           \\
321     \func{chown}    &           & $\bullet$ \\
322     \func{creat}    & $\bullet$ &           \\
323     \func{exec}     & $\bullet$ &           \\
324     \func{lchown}   & $\bullet$ & $\bullet$ \\
325     \func{link}     &           &           \\
326     \func{lstat}    &           & $\bullet$ \\
327     \func{mkdir}    & $\bullet$ &           \\
328     \func{mkfifo}   & $\bullet$ &           \\
329     \func{mknod}    & $\bullet$ &           \\
330     \func{open}     & $\bullet$ &           \\
331     \func{opendir}  & $\bullet$ &           \\
332     \func{pathconf} & $\bullet$ &           \\
333     \func{readlink} &           & $\bullet$ \\
334     \func{remove}   &           & $\bullet$ \\
335     \func{rename}   &           & $\bullet$ \\
336     \func{stat}     & $\bullet$ &           \\
337     \func{truncate} & $\bullet$ &           \\
338     \func{unlink}   &           & $\bullet$ \\
339     \hline 
340   \end{tabular}
341   \caption{Uso dei link simbolici da parte di alcune funzioni.}
342   \label{tab:file_symb_effect}
343 \end{table}
344
345 Si noti che non si è specificato il comportamento delle funzioni che operano
346 con i file descriptor, in quanto la risoluzione del link simbolico viene in
347 genere effettuata dalla funzione che restituisce il file descriptor
348 (normalmente la \func{open}) e tutte le operazioni seguenti fanno riferimento
349 solo a quest'ultimo.
350
351 Dato che, come indicato in \tabref{tab:file_symb_effect}, funzioni come la
352 \func{open} seguono i link simbolici, occorrono funzioni apposite per accedere
353 alle informazioni del link invece che a quelle del file a cui esso fa
354 riferimento. Quando si vuole leggere il contenuto di un link simbolico si usa
355 la funzione \func{readlink}, il cui prototipo è:
356 \begin{prototype}{unistd.h}
357 {int readlink(const char *path, char *buff, size\_t size)} 
358   Legge il contenuto del link simbolico indicato da \var{path} nel buffer
359   \var{buff} di dimensione \var{size}.
360   
361   \bodydesc{La funzione restituisce il numero di caratteri letti dentro
362     \var{buff} o -1 per un errore, nel qual caso la variabile
363     \var{errno} viene settata a:
364   \begin{errlist}
365   \item[\macro{EINVAL}] \var{file} non è un link simbolico o \var{size} non è
366     positiva. 
367   \item[\macro{EROFS}] La directory su cui si vuole inserire il nuovo link è
368     su un filesystem montato in sola lettura.
369   \item[\macro{ENOSPC}] La directory o il filesystem in cui si vuole creare il
370     link è piena e non c'è ulteriore spazio disponibile.
371   \end{errlist}
372   ed inoltre \macro{ENOTDIR}, \macro{ENAMETOOLONG}, \macro{ENOENT},
373   \macro{EACCES}, \macro{ELOOP}, \macro{EIO}, \macro{EFAULT} e
374   \macro{ENOMEM}.}
375 \end{prototype}
376
377 La funzione apre il link simbolico, ne legge il contenuto, lo scrive nel
378 buffer, e lo richiude. Si tenga presente che la funzione non termina la
379 stringa con un carattere nullo e la tronca alla dimensione specificata da
380 \var{size} per evitare di sovrascrivere oltre le dimensioni del buffer.
381
382
383 \begin{figure}[htb]
384   \centering
385   \includegraphics[width=5cm]{img/link_loop}
386   \caption{Esempio di loop nel filesystem creato con un link simbolico.}
387   \label{fig:file_link_loop}
388 \end{figure}
389
390 Un caso comune che si può avere con i link simbolici è la creazione dei
391 cosiddetti \textit{loop}. La situazione è illustrata in \curfig, che riporta
392 la struttura della directory \file{/boot}. Come si vede si è creato al suo
393 interno un link simbolico che punta di nuovo a \file{/boot}\footnote{Questo
394   tipo di loop è stato effettuato per poter permettere a \cmd{grub} (un
395   bootloader estremamente avanzato in grado di accedere direttamente
396   attraverso vari filesystem al file da lanciare come sistema operativo) di
397   vedere i file in questa directory, che è montata su una partizione separata
398   (e che grub vedrebbe come radice), con lo stesso path con cui verrebbero
399   visti dal sistema operativo.}. 
400
401 Questo può causare problemi per tutti quei programmi che effettuano la
402 scansione di una directory senza tener conto dei link simbolici, ad esempio se
403 lanciassimo un comando del tipo \cmd{grep -r linux *}, il loop nella directory
404 porterebbe il comando ad esaminare \file{/boot}, \file{/boot/boot},
405 \file{/boot/boot/boot} e così via.
406
407 Per questo motivo il kernel e le librerie prevedono che nella risoluzione di
408 un pathname possano essere seguiti un numero limitato di link simbolici, il
409 cui valore limite è specificato dalla costante \macro{MAXSYMLINKS}; qualora
410 questo limite venga superato viene generato un errore ed \var{errno} viene
411 settata al valore \macro{ELOOP}.
412
413 Un punto da tenere sempre presente è il fatto che un link simbolico può fare
414 riferimento anche ad un file che non esiste; ad esempio possiamo creare un
415 file temporaneo nella nostra directory con un link del tipo:
416 \begin{verbatim}
417 $ ln -s /tmp/tmp_file temporaneo
418 \end{verbatim}%$
419 anche se \file{/tmp/tmp\_file} non esiste. Questo può generare confusione, in
420 quanto aprendo in scrittura \file{temporaneo} verrà creato
421 \file{/tmp/tmp\_file} e scritto; ma accedendo in sola lettura a
422 \file{temporaneo}, ad esempio con \cmd{cat}, otterremmo:
423 \begin{verbatim}
424 $ cat temporaneo
425 cat: temporaneo: No such file or directory
426 \end{verbatim}%$
427 con un errore che può sembrare sbagliato, dato che invece \cmd{ls} ci
428 mostrerebbe l'esistenza di \file{temporaneo}.
429
430
431 \subsection{La creazione e la cancellazione delle directory} 
432 \label{sec:file_dir_creat_rem}
433
434 Per creare e cancellare delle directory si usano le due funzioni (omonime
435 degli analoghi comandi di shell) \func{mkdir} e \func{rmdir}.  Per poter
436 accedere ai tipi usati da queste funzioni si deve includere il file
437 \file{sys/types.h}, il prototipo della prima è:
438 \begin{prototype}{sys/stat.h}
439   {int mkdir(const char *dirname, mode\_t mode)} 
440   Crea una nuova directory vuota con il nome indicato da \var{dirname},
441   assegnandole i permessi indicati da \var{mode}. Il nome può essere indicato
442   con il pathname assoluto o relativo.
443   
444   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
445     errore, nel qual caso \var{errno} assumerà i valori:
446   \begin{errlist}
447   \item[\macro{EEXIST}] Un file (o una directory) con quel nome esiste di già. 
448   \item[\macro{EACCESS}] 
449     Non c'è il permesso di scrittura per la directory in cui si vuole inserire
450     la nuova directory.
451   \item[\macro{EMLINK}] La directory in cui si vuole creare la nuova directory
452     contiene troppi file. Sotto Linux questo normalmente non avviene perché il
453     filesystem standard consente la creazione di un numero di file maggiore di
454     quelli che possono essere contenuti nel disco, ma potendo avere a che
455     fare anche con filesystem di altri sistemi questo errore può presentarsi.
456   \item[\macro{ENOSPC}] Non c'è abbastanza spazio sul file system per creare
457     la nuova directory o si è esaurita la quota disco dell'utente.
458   \end{errlist}
459   ed inoltre anche \macro{EPERM}, \macro{EFAULT}, \macro{ENAMETOOLONG},
460   \macro{ENOENT}, \macro{ENOTDIR}, \macro{ENOMEM}, \macro{ELOOP},
461   \macro{EROFS}.}
462 \end{prototype}
463  
464 La funzione crea una nuova directory vuota (che contiene solo le due voci
465 standard \file{.} e \file{..}). I permessi di accesso (vedi la trattazione in
466 \secref{sec:file_access_control}) specificati da \var{mode} (i cui possibili
467 valori sono riportati in \tabref{tab:file_permission_const}) sono modificati
468 dalla maschera di creazione dei file (si veda \secref{sec:file_umask}).  La
469 titolarità della nuova directory è settata secondo quanto riportato in
470 \secref{sec:file_ownership}.
471
472 La seconda funzione serve ad eliminare una directory già vuota (la directory
473 deve cioè contenere soltanto le due voci standard \file{.} e \file{..}); il
474 suo prototipo è:
475 \begin{prototype}{sys/stat.h}{int rmdir(const char *dirname)} 
476   Cancella la directory \var{dirname}, che deve essere vuota.  Il nome può
477   essere indicato con il pathname assoluto o relativo.
478   
479   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
480     errore, nel qual caso \var{errno} assumerà i valori:
481   \begin{errlist}
482   \item[\macro{EPERM}] Il filesystem non supporta la cancellazione di
483     directory, oppure la directory che contiene \var{dirname} ha lo sticky bit
484     settato e l'\textit{effective user id} del processo non corrisponde al
485     proprietario della directory. 
486   \item[\macro{EACCESS}] Non c'è il permesso di scrittura per la directory che
487     contiene la directory che si vuole cancellare, o non c'è il permesso di
488     attraversare (esecuzione) una delle directory specificate in
489     \var{dirname}.
490   \item[\macro{EBUSY}] La directory specificata è la directory di lavoro o la
491     radice di qualche processo.
492   \item[\macro{ENOTEMPTY}] La directory non è vuota.
493   \end{errlist}
494   ed inoltre anche \macro{EFAULT}, \macro{ENAMETOOLONG}, \macro{ENOENT},
495   \macro{ENOTDIR}, \macro{ENOMEM}, \macro{ELOOP}, \macro{EROFS}.}
496 \end{prototype}
497
498 La modalità con cui avviene la cancellazione è analoga a quella di
499 \func{unlink}: fintanto che il numero di link all'inode della directory non
500 diventa nullo e nessun processo ha la directory aperta lo spazio occupato su
501 disco non viene rilasciato. Se un processo ha la directory aperta la funzione
502 rimuove il link all'inode e nel caso sia l'ultimo, pure le voci standard
503 \file{.} e \file{..}, a questo punto il kernel non consentirà di creare più
504 nuovi file nella directory.
505
506
507 \subsection{La creazione di file speciali}
508 \label{sec:file_mknod}
509
510 Finora abbiamo parlato esclusivamente di file, directory e link simbolici; in
511 \secref{sec:file_file_types} abbiamo visto però che il sistema preveda pure
512 degli altri tipi di file, come i file di dispositivo e le fifo (i socket sono
513 un caso a parte, che vedremo in \secref{cha:socket_intro}). 
514
515 La manipolazione delle caratteristiche di questi filee e la loro cancellazione
516 può essere effettuata con le stesse funzioni che operano sui file normali; ma
517 quando li si devono creare sono necessarie delle funzioni apposite. La prima
518 di queste funzioni è \func{mknod}, il suo prototipo è:
519 \begin{functions}
520   \headdecl{sys/types.h}
521   \headdecl{sys/stat.h}
522   \headdecl{fnctl.h}
523   \headdecl{unistd.h}
524   \funcdecl{int mknod(const char *pathname, mode\_t mode, dev\_t dev)} Crea un
525   inode, si usa per creare i file speciali.
526   
527   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
528     errore, nel qual caso \var{errno} assumerà i valori:
529   \begin{errlist}
530   \item[\macro{EPERM}] Non si hanno privilegi sufficienti a creare l'inode, o
531     il filesystem su cui si è cercato di creare \func{pathname} non supporta
532     l'operazione.
533   \item[\macro{EINVAL}] Il valore di \var{mode} non indica un file, una fifo o
534     un dipositivo.
535   \item[\macro{EEXIST}] \param{pathname} esiste già o è un link simbolico.
536   \end{errlist}
537   ed inoltre anche \macro{EFAULT}, \macro{EACCESS}, \macro{ENAMETOOLONG},
538   \macro{ENOENT}, \macro{ENOTDIR}, \macro{ENOMEM}, \macro{ELOOP},
539   \macro{ENOSPC}, \macro{EROFS}.}
540 \end{functions}
541
542 La funzione permette di creare un file speciale, ma si può usare anche per
543 creare file normali e fifo; l'argomento \param{mode} specifica il tipo di file
544 che si vuole creare ed i relativi permessi, secondo i valori riportati in
545 \tabref{tab:file_mode_flags}, che vanno combinato come OR binario. I permessi
546 sono comunque modificati nella maniera usuale dal valore di \var{umask} (si
547 veda \secref{sec:file_umask}.
548
549 Per il tipo di file può essere specificato solo uno fra: \macro{S\_IFREG} per
550 un file normale (che sarà creato vuoto), \macro{S\_IFBLK} per un device a
551 blocchi, \macro{S\_IFCHR} per un device a caratteri e \macro{S\_IFIFO} per una
552 fifo. Un valore diverso comporterà l'errore \macro{EINVAL}. Qualora si sia
553 specificato in \param{mode} un file di dispositivo, il valore di \param{dev}
554 viene usato per indicare a quale dispositivo si fa riferimento. 
555
556 Solo l'amministratore può creare un file di dispositivo o un file regolare
557 usando questa funzione; ma in Linux\footnote{la funzione non è prevista dallo
558   standard POSIX, e deriva da SVr4, con appunto questa differenza e diversi
559   codici di errore.} l'uso per la creazione di una fifo è consentito anche
560 agli utenti normali.
561
562 I nuovi inode creati con \func{mknod} apparterranno al proprietario e al
563 gruppo del processo che li creati, a meno che non si sia attivato il bit
564 \acr{sgid} per la directory o sia stata attivata la semantica BSD per il
565 filesystem (si veda \secref{sec:file_ownership}) in cui si va a creare
566 l'inode.
567
568 Per creare una fifo (un file speciale, su cui torneremo in dettaglio in
569 \secref{sec:ipc_named_pipe}) lo standard POSIX specifica l'uso della funzione
570 \func{mkfifo}, il cui prototipo è:
571 \begin{functions}
572   \headdecl{sys/types.h} \headdecl{sys/stat.h} 
573   
574   \funcdecl{int mkfifo(const char *pathname, mode\_t mode)} Crea una fifo.
575   
576   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
577     errore, nel qual caso \var{errno} assumerà i valori \macro{EACCESS},
578     \macro{EEXIST}, \macro{ENAMETOOLONG}, \macro{ENOENT}, \macro{ENOSPC},
579     \macro{ENOTDIR} e\macro{EROFS}.}
580 \end{functions}
581 \noindent come per \func{mknod} il file \param{pathname} non deve esistere
582 (neanche come link simbolico); al solito i permessi specificati da
583 \param{mode} vengono modificati dal valore di \var{umask}.
584
585
586
587 \subsection{Accesso alle directory}
588 \label{sec:file_dir_read}
589
590 Benché le directory siano oggetti del filesystem come tutti gli altri non ha
591 ovviamente senso aprirle come fossero dei file di dati. Può però essere utile
592 poterne leggere il contenuto ad esempio per fare la lista dei file che esse
593 contengono o ricerche sui medesimi. Solo il kernel può scrivere direttamente
594 in una directory (onde evitare inconsistenze all'interno del filesystem), i
595 processi devono creare i file usando le apposite funzioni.
596
597 Per accedere al contenuto delle directory si usano i cosiddetti
598 \textit{directory streams} (chiamati così per l'analogia con i file stream di
599 \capref{cha:files_std_interface}); la funzione \func{opendir} apre uno di
600 questi stream e la funzione \func{readdir} legge il contenuto della directory,
601 i cui elementi sono le \textit{directory entry} (da distinguersi da quelle
602 della cache di cui parlavamo in \secref{sec:file_vfs}) in una opportuna
603 struttura \var{struct dirent}.
604
605 (NdA Il resto va scritto!!! É noioso e lo farò più avanti).
606
607
608 \subsection{La directory di lavoro}
609 \label{sec:file_work_dir}
610
611 A ciascun processo è associato ad una directory nel filesystem che è chiamata
612 directory corrente o directory di lavoro (\textit{current working directory})
613 che è quella a cui si fa riferimento quando un filename è espresso in forma
614 relativa, dove il relativa fa riferimento appunto a questa directory.
615
616 Quando un utente effettua il login questa directory viene settata alla
617 \textit{home directory} del suo account. Il comando \cmd{cd} della shell
618 consente di cambiarla a piacere, spostandosi da una directory ad un'altra, il
619 comando \cmd{pwd} la stampa sul terminale.  Siccome la directory corrente
620 resta la stessa quando viene creato un processo figlio (vedi
621 \secref{sec:proc_fork}), la directory corrente della shell diventa anche la
622 directory corrente di qualunque comando da essa lanciato.
623
624 In genere il kernel tiene traccia per ciascun processo dell'inode della
625 directory di lavoro corrente, per ottenere il pathname occorre usare una
626 apposita funzione di libreria,  \func{getcwd}, il cui prototipo è:
627 \begin{prototype}{unistd.h}{char *getcwd(char *buffer, size\_t size)}
628   Restituisce il filename completo della directory di lavoro corrente nella
629   stringa puntata da \var{buffer}, che deve essere precedentemente
630   allocata, per una dimensione massima di \var{size}.
631   
632   \bodydesc{La funzione restituisce il puntatore \var{buffer} se riesce,
633     \macro{NULL} se fallisce, in quest'ultimo caso la variabile
634     \var{errno} è settata con i seguenti codici di errore:
635   \begin{errlist}
636   \item[\macro{EINVAL}] L'argomento \var{size} è zero e \var{buffer} non
637     è nullo.
638   \item[\macro{ERANGE}] L'argomento \var{size} è più piccolo della
639     lunghezza del pathname. 
640   \item[\macro{EACCESS}] Manca il permesso di lettura o di ricerca su uno dei
641     componenti del pathname (cioè su una delle directory superiori alla
642     corrente).
643   \end{errlist}}
644 \end{prototype}
645
646 Il buffer deve essere sufficientemente lungo da poter contenere il pathname
647 completo più lo zero di terminazione della stringa. Qualora esso ecceda le
648 dimensioni specificate con \var{size} la funzione restituisce un errore.  Si
649 può anche specificare un puntatore nullo come \var{buffer}\footnote{questa è
650   una estensione allo standard POSIX.1, supportata da Linux}, nel qual caso la
651 stringa sarà allocata automaticamente per una dimensione pari a \var{size}
652 qualora questa sia diversa da zero, o della lunghezza esatta del pathname
653 altrimenti. In questo caso ci si deve ricordare di disallocare la stringa una
654 volta cessato il suo utilizzo.
655
656 Di questa funzione esiste una versione \code{char *getwd(char *buffer)}
657 fatta per compatibilità all'indietro con BSD, che non consente di specificare
658 la dimensione del buffer; esso deve essere allocato in precedenza ed avere una
659 dimensione superiore a \macro{PATH\_MAX} (di solito 256 byte, vedi
660 \secref{sec:sys_limits}); il problema è che in Linux non esiste una dimensione
661 superiore per un pathname, per cui non è detto che il buffer sia sufficiente a
662 contenere il nome del file, e questa è la ragione principale per cui questa
663 funzione è deprecata.
664
665 Una seconda funzione simile è \code{char *get\_current\_dir\_name(void)} che è
666 sostanzialmente equivalente ad una \code{getcwd(NULL, 0)}, con la sola
667 differenza che essa ritorna il valore della variabile di ambiente \macro{PWD},
668 che essendo costruita dalla shell può contenere un pathname comprendente anche
669 con dei link simbolici. Usando \func{getcwd} infatti, essendo il
670 pathname ricavato risalendo all'indietro l'albero della directory, si
671 perderebbe traccia di ogni passaggio attraverso eventuali link simbolici.
672
673 Per cambiare la directory di lavoro corrente si può usare la funzione
674 \func{chdir} (omonima dell'analogo comando di shell) il cui nome sta appunto
675 per \textit{change directory}), il suo prototipo è:
676 \begin{prototype}{unistd.h}{int chdir(const char *pathname)} 
677   Cambia la directory di lavoro corrente in \param{pathname}.
678   
679   \bodydesc{La funzione restituisce 0 in caso di successo e -1 per un errore,
680     nel qual caso \var{errno} viene settata a:
681   \begin{errlist}
682   \item[\macro{ENOTDIR}] Non si è specificata una directory.
683   \item[\macro{EACCESS}] Manca il permesso di ricerca su uno dei componenti di
684     \param{path}.
685   \end{errlist}
686   ed inoltre \macro{EFAULT}, \macro{ENAMETOOLONG}, \macro{ENOENT},
687   \macro{ENOMEM}, \macro{ELOOP} e \macro{EIO}.}
688 \end{prototype}
689 \noindent ed ovviamente \param{pathname} deve indicare una directory per la
690 quale si hanno i permessi di accesso.
691
692 Dato che anche le directory sono file, è possibile riferirsi ad esse anche
693 tramite il file descriptor, e non solo tramite il filename, per fare questo si
694 usa \func{fchdir}, il cui prototipo è:
695 \begin{prototype}{unistd.h}{int fchdir(int fd)} 
696   Identica a \func{chdir}, ma usa il file descriptor \param{fd} invece del
697   pathname.
698   
699   \bodydesc{La funzione restituisce zero in caso di successo e -1 per un
700     errore, in caso di errore \var{errno} viene settata ai valori
701     \macro{EBADF} o \macro{EACCES}.}
702 \end{prototype}
703 \noindent anche in questo caso \param{fd} deve essere un file descriptor
704 valido che fa riferimento ad una directory. Inoltre l'unico errore di accesso
705 possibile (tutti gli altri sarebbero occorsi all'apertura di \func{fd}), è
706 quello in cui il processo non ha il permesso di accesso alla directory
707 specificata da \param{fd}.
708
709
710
711 \subsection{I file temporanei}
712 \label{sec:file_temp_file}
713
714 In molte occasioni è utile poter creare dei file temporanei; benchè la cosa
715 sembri semplice in realtà il problema è più sottile di quanto non appaia a
716 prima vista. Infatti anche se sembrerebbe banale generare un nome a caso e
717 creare il file dopo aver controllato che questo non esista, nel momento fra il
718 controllo e la creazione si ha giusto lo spazio per una \textit{race
719   condition} (si ricordi quanto visto in \secref{sec:proc_race_cond}).
720
721 Le \acr{glibc} provvedono varie funzioni per generare nomi di file temporanei,
722 di cui si abbia certezza di unicità (al momento della generazione); la prima
723 di queste funzioni è \func{tmpnam} il cui prototipo è:
724 \begin{prototype}{stdio.h}{char *tmpnam(char *string)}
725   Restituisce il puntatore ad una stringa contente un nome di file valido e
726   non esistente al momento dell'invocazione. 
727
728   \bodydesc{La funzione ritorna il puntatore alla stringa con il nome o
729   \macro{NULL} in caso di fallimento. Non sono definiti errori.}
730 \end{prototype}
731 \noindent se si è passato un puntatore \param{string} non nullo questo deve
732 essere di dimensione \macro{L\_tmpnam} (costante definita in \file{stdio.h},
733 come \macro{P\_tmpdir} e \macro{TMP\_MAX}) ed il nome generato vi verrà
734 copiato automaticamente; altrimenti il nome sarà generato in un buffer statico
735 interno che verrà sovrascritto ad una chiamata successiva.  Successive
736 invocazioni della funzione continueranno a restituire nomi unici fino ad un
737 massimo di \macro{TMP\_MAX} volte. Al nome viene automaticamente aggiunto come
738 prefisso la directory specificata da \macro{P\_tmpdir}.
739
740 Di questa funzione esiste una versione rientrante, \func{tmpnam\_r}, che non
741 fa nulla quando si passa \macro{NULL} come parametro. Una funzione simile,
742 \func{tempnam}, permette di specificare un prefisso per il file
743 esplicitamente, il suo prototipo è:
744 \begin{prototype}{stdio.h}{char *tempnam(const char *dir, const char *pfx)}
745   Restituisce il puntatore ad una stringa contente un nome di file valido e
746   non esistente al momento dell'invocazione.
747
748   \bodydesc{La funzione ritorna il puntatore alla stringa con il nome o
749   \macro{NULL} in caso di fallimento, \var{errno} viene settata a
750   \macro{ENOMEM} qualora fallisca l'allocazione della stringa.}
751 \end{prototype}
752
753 La funzione alloca con \code{malloc} la stringa in cui resituisce il nome, per
754 cui è sempre rientrante, occorre però ricordarsi di disallocare il puntatore
755 che restituisce.  L'argomento \param{pfx} specifica un prefisso di massimo 5
756 caratteri per il nome provvisorio. La funzione assegna come directory per il
757 file temporaneo (verificando che esista e sia accessibili), la prima valida
758 delle seguenti:
759 \begin{itemize*}
760 \item La variabile di ambiente \macro{TMPNAME} (non ha effetto se non è
761   definita o se il programma chiamante è \acr{suid} o \acr{sgid}, vedi
762   \secref{sec:file_suid_sgid}).
763 \item il valore dell'argomento \param{dir} (se diverso da \macro{NULL}).
764 \item Il valore della costante \macro{P\_tmpdir}.
765 \item la directory \file{/tmp}.
766 \end{itemize*}
767
768 In ogni caso, anche se la generazione del nome è casuale, ed è molto difficile
769 ottere un nome duplicato, nulla assicura che un altro processo non possa avere
770 creato, fra l'ottenimento del nome e l'apertura del file, un altro file con lo
771 stesso nome; per questo motivo quando si usa il nome ottenuto da una di queste
772 funzioni occorre sempre aprire il nuovo file in modalità di esclusione (cioè
773 con l'opzione \macro{O\_EXCL} per i file descriptor o con il flag \code{x} per
774 gli stream) che fa fallire l'apertura in caso il file sia già esistente.
775
776 Per evitare di dovere effettuare a mano tutti questi controlli, lo standard
777 POSIX definisce la funzione \func{tempfile}, il cui prototipo è:
778 \begin{prototype}{stdio.h}{FILE *tmpfile (void)}
779   Restituisce un file temporaneo aperto in lettura/scrittura.
780   
781   \bodydesc{La funzione ritorna il puntatore allo stream associato al file
782     temporaneo in caso di successo e \macro{NULL} in caso di errore, nel qual
783     caso \var{errno} viene settata a
784     \begin{errlist}
785     \item[\macro{EINTR}] La funzione è stata interrotta da un segnale.
786     \item[\macro{EEXIST}] Non è stato possibile generare un nome univoco.
787     \end{errlist}
788     ed inoltre \macro{EFAULT}, \macro{EMFILE}, \macro{ENFILE}, \macro{ENOSPC},
789     \macro{EROFS} e \macro{EACCESS}.}
790 \end{prototype}
791 \noindent restituisce direttamente uno stream già aperto (in modalità
792 \code{r+b}, si veda \secref{sec:file_fopen}) e pronto per l'uso che viene
793 automaticamente cancellato alla sua chiusura o all'uscita dal programma. Lo
794 standard non specifica in quale directory verrà aperto il file, ma \acr{glibc}
795 prima tentano con \macro{P\_tmpdir} e poi con \file{/tmp}. Questa funzione è
796 rientrante e non soffre di problemi di \textit{race condition}.
797
798 Alcune versioni meno recenti di Unix non supportano queste funzioni; in questo
799 caso si possono usare le vecchie funzioni \func{mktemp} e \func{mkstemp} che
800 modificano una stringa di input che serve da modello e che deve essere
801 conclusa da 6 caratteri \code{X} che verranno sostituiti da un codice
802 unico. La prima delle due è analoga a \func{tmpnam} e genera un nome casuale,
803 il suo prototipo è:
804 \begin{prototype}{stlib.h}{char *mktemp(char *template)}
805   Genera un filename univoco sostituendo le \code{XXXXXX} finali di
806   \param{template}.
807   
808   \bodydesc{La funzione ritorna il puntatore \param{template} in caso di
809     successo e \macro{NULL} in caso di errore, nel qual caso \var{errno} viene
810     settata a:
811     \begin{errlist}
812     \item[\macro{EINVAL}] \param{template} non termina con \code{XXXXXX}.
813     \end{errlist}}
814 \end{prototype}
815 \noindent dato che \param{template} deve poter essere modificata dalla
816 funzione non si può usare una stringa costante.  Tutte le avvertenze riguardo
817 alle possibili \textit{race condition} date per \func{tmpnam} continuano a
818 valere; inoltre in alcune vecchie implementazioni il valore di usato per
819 sostituire le \code{XXXXXX} viene formato con il \acr{pid} del processo più
820 una lettera, il che mette a disposizione solo 26 possibilità, e rende il nome
821 temporaneo facile da indovinare. Per tutti questi motivi la funzione è
822 deprecata e non dovrebbe mai essere usata.
823
824
825
826 La seconda funzione, \func{mkstemp} è sostanzialmente equivalente a
827 \func{tmpfile}, ma restituisce un file descriptor invece di uno stream; il suo
828 prototipo è:
829 \begin{prototype}{stlib.h}{int mkstemp(char *template)}
830   Genera un file temporaneo con un nome ottenuto sostituendo le \code{XXXXXX}
831   finali di \param{template}.
832   
833   \bodydesc{La funzione ritorna il file descriptor in caso successo e
834     -1 in caso di errore, nel qual caso \var{errno} viene settata a:
835     \begin{errlist}
836     \item[\macro{EINVAL}] \param{template} non termina con \code{XXXXXX}.
837     \item[\macro{EEXIST}] non è riuscita a creare un file temporano, il
838       contenuto di \param{template} è indefinito.
839     \end{errlist}}
840 \end{prototype}
841 \noindent come per \func{mktemp} \param{template} non può essere una stringa
842 costante. La funzione apre un file in lettura/scrittura con la funzione
843 \func{open}, usando l'opzione \macro{O\_EXCL} (si veda
844 \secref{sec:file_open}), in questo modo al ritorno della funzione si ha la
845 certezza di essere i soli utenti del file. I permessi sono settati al valore
846 \code{0600}\footnote{questo è vero a partire dalle \acr{glibc} 2.0.7, le
847   versioni precedenti delle \acr{glibc} e le vecchie \acr{libc5} e \acr{libc4}
848   usavano il valore \code{0666} che permetteva a chiunque di leggere i
849   contenuti del file.} (si veda \secref{sec:file_perm_overview}).
850
851 In OpenBSD è stata introdotta un'altra funzione\footnote{introdotta anche in
852   Linux a partire dalle \acr{glibc} 2.1.91.} simile alle precedenti,
853 \func{mkdtemp}, che crea una directory temporanea; il suo prototipo è:
854 \begin{prototype}{stlib.h}{char *mkdtemp(char *template)}
855   Genera una directory temporaneo il cui nome è ottenuto sostituendo le
856   \code{XXXXXX} finali di \param{template}.
857   
858   \bodydesc{La funzione ritorna il puntatore al nome della directory in caso
859     successo e \macro{NULL} in caso di errore, nel qual caso \var{errno} viene
860     settata a:
861     \begin{errlist}
862     \item[\macro{EINVAL}] \param{template} non termina con \code{XXXXXX}.
863     \end{errlist}
864     più gli altri eventuali codici di errore di \func{mkdir}.}
865 \end{prototype}
866 \noindent la directory è creata con permessi \code{0700} (al solito si veda
867 \capref{cha:file_unix_interface} per i dettagli); dato che la creazione della
868 directory è sempre esclusiva i precedenti problemi di \textit{race condition}
869 non si pongono.
870
871
872 \section{La manipolazione delle caratteristiche dei files}
873 \label{sec:file_infos}
874
875 Come spiegato in \secref{sec:file_filesystem} tutte le informazioni
876 generali relative alle caratteristiche di ciascun file, a partire dalle
877 informazioni relative al controllo di accesso, sono mantenute nell'inode.
878
879 Vedremo in questa sezione come sia possibile leggere tutte queste informazioni
880 usando la funzione \func{stat}, che permette l'accesso a tutti i dati
881 memorizzati nell'inode; esamineremo poi le varie funzioni usate per manipolare
882 tutte queste informazioni (eccetto quelle che riguardano la gestione del
883 controllo di accesso, trattate in in \secref{sec:file_access_control}).
884
885
886 \subsection{Le funzioni \func{stat}, \func{fstat} e \func{lstat}}
887 \label{sec:file_stat}
888
889 La lettura delle informazioni relative ai file è fatta attraverso la famiglia
890 delle funzioni \func{stat}; questa è la funzione che ad esempio usa il comando
891 \cmd{ls} per poter ottenere e mostrare tutti i dati dei files. I prototipi di
892 queste funzioni sono i seguenti:
893 \begin{functions}
894   \headdecl{sys/types.h} 
895   \headdecl{sys/stat.h} 
896   \headdecl{unistd.h}
897
898   \funcdecl{int stat(const char *file\_name, struct stat *buf)} Legge le
899   informazione del file specificato da \var{file\_name} e le inserisce in
900   \var{buf}.
901   
902   \funcdecl{int lstat(const char *file\_name, struct stat *buf)} Identica a
903   \func{stat} eccetto che se il \var{file\_name} è un link simbolico vengono
904   lette le informazioni relativa ad esso e non al file a cui fa riferimento.
905   
906   \funcdecl{int fstat(int filedes, struct stat *buf)} Identica a \func{stat}
907   eccetto che si usa con un file aperto, specificato tramite il suo file
908   descriptor \var{filedes}.
909   
910   \bodydesc{Le funzioni restituiscono zero in caso di successo e -1 per
911     un errore, in caso di errore \var{errno} può assumere uno dei
912     valori: \macro{EBADF}, \macro{ENOENT}, \macro{ENOTDIR},
913     \macro{ELOOP}, \macro{EFAULT}, \macro{EACCESS}, \macro{ENOMEM},
914     \macro{ENAMETOOLONG}.}
915 \end{functions}
916
917 La struttura \var{stat} è definita nell'header \file{sys/stat.h} e in
918 generale dipende dall'implementazione, la versione usata da Linux è mostrata
919 in \nfig, così come riportata dalla man page (in realtà la definizione
920 effettivamente usata nel kernel dipende dall'architettura e ha altri campi
921 riservati per estensioni come tempi più precisi, o per il padding dei campi).
922
923 \begin{figure}[!htb]
924   \footnotesize
925   \centering
926   \begin{minipage}[c]{15cm}
927     \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
928 struct stat {
929     dev_t         st_dev;      /* device */
930     ino_t         st_ino;      /* inode */
931     mode_t        st_mode;     /* protection */
932     nlink_t       st_nlink;    /* number of hard links */
933     uid_t         st_uid;      /* user ID of owner */
934     gid_t         st_gid;      /* group ID of owner */
935     dev_t         st_rdev;     /* device type (if inode device) */
936     off_t         st_size;     /* total size, in bytes */
937     unsigned long st_blksize;  /* blocksize for filesystem I/O */
938     unsigned long st_blocks;   /* number of blocks allocated */
939     time_t        st_atime;    /* time of last access */
940     time_t        st_mtime;    /* time of last modification */
941     time_t        st_ctime;    /* time of last change */
942 };
943     \end{lstlisting}
944   \end{minipage} 
945   \normalsize 
946   \caption{La struttura \var{stat} per la lettura delle informazioni dei 
947     file}
948   \label{fig:file_stat_struct}
949 \end{figure}
950
951 Si noti come i vari membri della struttura siano specificati come tipi nativi
952 del sistema (di quelli definiti in \tabref{tab:xxx_sys_types}, e dichiarati in
953 \file{sys/types.h}). 
954
955
956 \subsection{I tipi di file}
957 \label{sec:file_types}
958
959 Come riportato in \tabref{tab:file_file_types} in Linux oltre ai file e
960 alle directory esistono vari altri oggetti che possono stare su un filesystem;
961 il tipo di file è ritornato dalla \func{stat} nel campo \var{st\_mode}
962 (che è quello che contiene anche le informazioni relative ai permessi).
963
964 Dato che il valore numerico può variare a seconda delle implementazioni, lo
965 standard POSIX definisce un insieme di macro per verificare il tipo di files,
966 queste vengono usate anche da Linux che supporta pure le estensioni per link
967 simbolici e socket definite da BSD, l'elenco completo di tutte le macro è
968 riportato in \ntab.
969 \begin{table}[htb]
970   \centering
971   \footnotesize
972   \begin{tabular}[c]{|l|l|}
973     \hline
974     \textbf{Macro} & \textbf{Tipo del file} \\
975     \hline
976     \hline
977     \macro{S\_ISREG(m)}  & file regolare \\
978     \macro{S\_ISDIR(m)}  & directory \\
979     \macro{S\_ISCHR(m)}  & device a caratteri \\
980     \macro{S\_ISBLK(m)}  & device a blocchi\\
981     \macro{S\_ISFIFO(m)} & fifo \\
982     \macro{S\_ISLNK(m)}  & link simbolico \\
983     \macro{S\_ISSOCK(m)} & socket \\
984     \hline    
985   \end{tabular}
986   \caption{Macro per i tipi di file (definite in \texttt{sys/stat.h})}
987   \label{tab:file_type_macro}
988 \end{table}
989
990 Oltre a queste macro è possibile usare direttamente il valore di
991 \var{st\_mode} per ricavare il significato dei vari bit in esso memorizzati,
992 per questo sempre in \file{sys/stat.h} sono definiti i flag riportati in
993 \ntab:
994 \begin{table}[htb]
995   \centering
996   \footnotesize
997   \begin{tabular}[c]{|l|c|l|}
998     \hline
999     \textbf{Flag} & \textbf{Valore} & \textbf{Significato} \\
1000     \hline
1001     \hline
1002     \macro{S\_IFMT}   &  0170000 & bitmask per i bit del tipo di file \\
1003     \macro{S\_IFSOCK} &  0140000 & socket             \\
1004     \macro{S\_IFLNK}  &  0120000 & link simbolico     \\
1005     \macro{S\_IFREG}  &  0100000 & file regolare      \\ 
1006     \macro{S\_IFBLK}  &  0060000 & device a blocchi   \\
1007     \macro{S\_IFDIR}  &  0040000 & directory          \\ 
1008     \macro{S\_IFCHR}  &  0020000 & device a caratteri \\
1009     \macro{S\_IFIFO}  &  0010000 & fifo               \\
1010     \hline
1011     \macro{S\_ISUID}  &  0004000 & set UID bit   \\
1012     \macro{S\_ISGID}  &  0002000 & set GID bit   \\
1013     \macro{S\_ISVTX}  &  0001000 & sticky bit    \\
1014     \hline
1015 %    \macro{S\_IRWXU}  &  00700   & bitmask per i permessi del proprietario  \\
1016     \macro{S\_IRUSR}  &  00400   & il proprietario ha permesso di lettura   \\
1017     \macro{S\_IWUSR}  &  00200   & il proprietario ha permesso di scrittura \\
1018     \macro{S\_IXUSR}  &  00100   & il proprietario ha permesso di esecuzione\\
1019     \hline
1020 %    \macro{S\_IRWXG}  &  00070   & bitmask per i permessi del gruppo        \\
1021     \macro{S\_IRGRP}  &  00040   & il gruppo ha permesso di lettura         \\
1022     \macro{S\_IWGRP}  &  00020   & il gruppo ha permesso di scrittura       \\
1023     \macro{S\_IXGRP}  &  00010   & il gruppo ha permesso di esecuzione      \\
1024     \hline
1025 %    \macro{S\_IRWXO}  &  00007   & bitmask per i permessi di tutti gli altri\\
1026     \macro{S\_IROTH}  &  00004   & gli altri hanno permesso di lettura      \\
1027     \macro{S\_IWOTH}  &  00002   & gli altri hanno permesso di esecuzione   \\
1028     \macro{S\_IXOTH}  &  00001   & gli altri hanno permesso di esecuzione   \\
1029     \hline    
1030   \end{tabular}
1031   \caption{Costanti per l'identificazione dei vari bit che compongono il campo
1032     \var{st\_mode} (definite in \file{sys/stat.h})}
1033   \label{tab:file_mode_flags}
1034 \end{table}
1035
1036 Il primo valore definisce la maschera dei bit usati nei quali viene
1037 memorizzato il tipo di files, mentre gli altri possono essere usati per
1038 effettuare delle selezioni sul tipo di file voluto, combinando opportunamente
1039 i vari flag; ad esempio se si volesse controllare se un file è una directory o
1040 un file ordinario si potrebbe definire la condizione:
1041 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1042 #define IS_FILE_DIR(x) (((x) & S_IFMT) & (S_IFDIR | S_IFREG))
1043 \end{lstlisting}
1044 in cui prima si estraggono da \var{st\_mode} i bit relativi al tipo di file e
1045 poi si effettua il confronto con la combinazione di tipi scelta.
1046
1047
1048 \subsection{La dimensione dei file}
1049 \label{sec:file_file_size}
1050
1051 Il membro \var{st\_size} contiene la dimensione del file in byte (se il file
1052 è un file normale, nel caso di un link simbolico al dimensione è quella del
1053 pathname che contiene). 
1054
1055 Il campo \var{st\_blocks} definisce la lunghezza del file in blocchi di 512
1056 byte. Il campo \var{st\_blksize} infine definisce la dimensione preferita per
1057 i trasferimenti sui file (che è la dimensione usata anche dalle librerie del C
1058 per l'interfaccia degli stream); scrivere sul file a blocchi di dati di
1059 dimensione inferiore sarebbe inefficiente.
1060
1061 Si tenga conto che lunghezza del file riportata in \var{st\_size} non è detto
1062 che corrisponda all'occupazione dello spazio su disco per via della possibile
1063 esistenza dei cosiddetti \textsl{buchi} (detti normalmente \textit{holes}) che
1064 si formano tutte le volte che si va a scrivere su un file dopo aver eseguito
1065 una \func{lseek} (vedi \secref{sec:file_lseek}) oltre la sua conclusione
1066 corrente.
1067
1068 In tal caso si avranno differenti risultati a seconda del modi in cui si
1069 calcola la lunghezza del file, ad esempio il comando \cmd{du}, (che riporta il
1070 numero di blocchi occupati) potrà dare una dimensione inferiore, mentre se si
1071 legge dal file (ad esempio usando il comando \cmd{wc -c}), dato che in tal
1072 caso per le parti non scritte vengono restituiti degli zeri, si avrà lo stesso
1073 risultato di \cmd{ls}.
1074
1075 Se è sempre possibile allargare un file, scrivendoci sopra od usando la
1076 funzione \func{lseek} per spostarsi oltre la sua fine, esistono anche casi in
1077 cui si può avere bisogno di effettuare un troncamento, scartando i dati
1078 presenti al di là della dimensione scelta come nuova fine del file.
1079
1080 Un file può sempre essere troncato a zero aprendolo con il flag
1081 \macro{O\_TRUNC}, ma questo è un caso particolare; per qualunque altra
1082 dimensione si possono usare le due funzioni:
1083 \begin{functions}
1084   \headdecl{unistd.h} \funcdecl{int truncate(const char *file\_name, off\_t
1085     length)} Fa si che la dimensione del file \var{file\_name} sia troncata ad
1086     un valore massimo specificato da \var{lenght}. 
1087   
1088   \funcdecl{int ftruncate(int fd, off\_t length))} Identica a \func{truncate}
1089   eccetto che si usa con un file aperto, specificato tramite il suo file
1090   descriptor \var{fd}.
1091   
1092   \bodydesc{Le funzioni restituiscono zero in caso di successo e -1 per
1093     un errore, nel qual caso \var{errno} viene settato opportunamente;
1094     per \func{ftruncate} si hanno i valori:
1095   \begin{errlist}
1096   \item[\macro{EBADF}] \var{fd}  non è un file descriptor.
1097   \item[\macro{EINVAL}] \var{fd} è un riferimento ad un socket, non a un file
1098     o non è aperto in scrittura.
1099   \end{errlist}
1100   per \func{truncate} si hanno:
1101   \begin{errlist}
1102   \item[\macro{EACCES}] il file non ha permesso di scrittura o non si ha il
1103     permesso di esecuzione una delle directory del pathname. 
1104   \item[\macro{ETXTBSY}] Il file è un programma in esecuzione.
1105   \end{errlist}
1106   ed anche \macro{ENOTDIR}, \macro{ENAMETOOLONG}, \macro{ENOENT},
1107   \macro{EROFS}, \macro{EIO}, \macro{EFAULT}, \macro{ELOOP}.}
1108 \end{functions}
1109
1110 Se il file è più lungo della lunghezza specificata i dati in eccesso saranno
1111 perduti; il comportamento in caso di lunghezza inferiore non è specificato e
1112 dipende dall'implementazione: il file può essere lasciato invariato o esteso
1113 fino alla lunghezza scelta; in quest'ultimo caso lo spazio viene riempito con
1114 zeri (e in genere si ha la creazione di un \textit{hole} nel file).
1115
1116
1117 \subsection{I tempi dei file}
1118 \label{sec:file_file_times}
1119
1120 Il sistema mantiene per ciascun file tre tempi. Questi sono registrati
1121 nell'inode insieme agli altri attributi del file e possono essere letti
1122 tramite la funzione \func{stat}, che li restituisce attraverso tre campi della
1123 struttura \var{stat} di \figref{fig:file_stat_struct}. Il significato di detti
1124 tempi e dei relativi campi è riportato nello schema in \ntab, dove si è anche
1125 riportato un esempio delle funzioni che effettuano cambiamenti su di essi.
1126
1127 \begin{table}[htb]
1128   \centering
1129   \footnotesize
1130   \begin{tabular}[c]{|c|l|l|c|}
1131     \hline
1132     \textbf{Membro} & \textbf{Significato} & \textbf{Funzione} 
1133     & \textbf{Opzione} \\
1134     \hline
1135     \hline
1136     \var{st\_atime}& ultimo accesso ai dati del file &\func{read}, 
1137     \func{utime} & \cmd{-u}\\ 
1138     \var{st\_mtime}& ultima modifica ai dati del file &\func{write}, 
1139     \func{utime} & default\\ 
1140     \var{st\_ctime}& ultima modifica ai dati dell'inode&\func{chmod}, 
1141     \func{utime} & \cmd{-c} \\ 
1142     \hline
1143   \end{tabular}
1144   \caption{I tre tempi associati a ciascun file}
1145   \label{tab:file_file_times}
1146 \end{table}
1147
1148 Il primo punto da tenere presente è la differenza fra il cosiddetto tempo di
1149 modifica (il \textit{modification time} \var{st\_mtime}) e il tempo di
1150 cambiamento di stato (il \textit{change time} \var{st\_ctime}). Il primo
1151 infatti fa riferimento ad una modifica del contenuto di un file, mentre il
1152 secondo ad una modifica dell'inode; siccome esistono molte operazioni (come la
1153 funzione \func{link} e molte altre che vedremo in seguito) che modificano solo
1154 le informazioni contenute nell'inode senza toccare il file, diventa necessario
1155 l'utilizzo di un altro tempo.
1156
1157 Il sistema non tiene conto dell'ultimo accesso all'inode, pertanto funzioni
1158 come \func{access} o \func{stat} non hanno alcuna influenza sui tre tempi. Il
1159 tempo di ultimo accesso (ai dati) viene di solito usato per cancellare i file
1160 che non servono più dopo un certo lasso di tempo (ad esempio \cmd{leafnode}
1161 cancella i vecchi articoli sulla base di questo tempo).
1162
1163 Il tempo di ultima modifica invece viene usato da \cmd{make} per decidere
1164 quali file necessitano di essere ricompilati o (talvolta insieme anche al
1165 tempo di cambiamento di stato) per decidere quali file devono essere
1166 archiviati per il backup. Il comando \cmd{ls} (quando usato con le opzioni
1167 \cmd{-l} o \cmd{-t}) mostra i tempi dei file secondo lo schema riportato
1168 nell'ultima colonna di \curtab.
1169
1170 L'effetto delle varie funzioni di manipolazione dei file sui tempi è
1171 illustrato in \ntab. Si sono riportati gli effetti sia per il file a cui si fa
1172 riferimento, sia per la directory che lo contiene; questi ultimi possono
1173 essere capiti se si tiene conto di quanto già detto, e cioè che anche le
1174 directory sono file (che contengono una lista di nomi) che il sistema tratta
1175 in maniera del tutto analoga a tutti gli altri.
1176
1177 Per questo motivo tutte le volte che compiremo una operazione su un file che
1178 comporta una modifica del nome contenuto nella directory, andremo anche a
1179 scrivere sulla directory che lo contiene cambiandone il tempo di modifica. Un
1180 esempio di questo può essere la cancellazione di un file, invece leggere o
1181 scrivere o cambiare i permessi di un file ha effetti solo sui tempi di
1182 quest'ultimo.
1183
1184 \begin{table}[htb]
1185   \centering
1186   \footnotesize
1187   \begin{tabular}[c]{|l|c|c|c|c|c|c|l|}
1188     \hline
1189     \multicolumn{1}{|p{3cm}|}{\centering{\vspace{6pt}\textbf{Funzione}}} &
1190     \multicolumn{3}{|p{3cm}|}{\centering{File o directory di riferimento}}&
1191     \multicolumn{3}{|p{3cm}|}{\centering{Directory genitrice del riferimento}} 
1192     &\multicolumn{1}{|p{3.6cm}|}{\centering{\vspace{6pt}\textbf{Note}}} \\
1193     \cline{2-7}
1194     \cline{2-7}
1195     \multicolumn{1}{|p{3cm}|}{} 
1196     &\multicolumn{1}{|p{.8cm}|}{\centering{\textsl{(a)}}}
1197     &\multicolumn{1}{|p{.8cm}|}{\centering{\textsl{(m)}}}
1198     &\multicolumn{1}{|p{.8cm}|}{\centering{\textsl{(c)}}}
1199     &\multicolumn{1}{|p{.8cm}|}{\centering{\textsl{(a)}}}
1200     &\multicolumn{1}{|p{.8cm}|}{\centering{\textsl{(m)}}}
1201     &\multicolumn{1}{|p{.8cm}|}{\centering{\textsl{(c)}}}
1202     &\multicolumn{1}{|p{3cm}|}{} \\
1203     \hline
1204     \hline
1205     \func{chmod}, \func{fchmod} 
1206     &         &         &$\bullet$&         &         &         & \\
1207     \func{chown}, \func{fchown} 
1208     &         &         &$\bullet$&         &         &         & \\
1209     \func{creat}  
1210     &$\bullet$&$\bullet$&$\bullet$&         &$\bullet$&$\bullet$&  con 
1211     \macro{O\_CREATE} \\    \func{creat}  
1212     &         &$\bullet$&$\bullet$&         &$\bullet$&$\bullet$&   
1213     con \macro{O\_TRUNC} \\    \func{exec}  
1214     &$\bullet$&         &         &         &         &         & \\
1215     \func{lchown}  
1216     &         &         &$\bullet$&         &         &         & \\
1217     \func{link}
1218     &         &         &$\bullet$&         &$\bullet$&$\bullet$& \\
1219     \func{mkdir}
1220     &$\bullet$&$\bullet$&$\bullet$&         &$\bullet$&$\bullet$& \\
1221     \func{mkfifo}
1222     &$\bullet$&$\bullet$&$\bullet$&         &$\bullet$&$\bullet$& \\
1223     \func{open}
1224     &$\bullet$&$\bullet$&$\bullet$&         &$\bullet$&$\bullet$& con 
1225     \macro{O\_CREATE} \\    \func{open}
1226     &         &$\bullet$&$\bullet$&         &         &         & con 
1227     \macro{O\_TRUNC}  \\    \func{pipe}
1228     &$\bullet$&$\bullet$&$\bullet$&         &         &         & \\
1229     \func{read}
1230     &$\bullet$&         &         &         &         &         & \\
1231     \func{remove}
1232     &         &         &$\bullet$&         &$\bullet$&$\bullet$& using 
1233     \func{unlink}\\    \func{remove}
1234     &         &         &         &         &$\bullet$&$\bullet$& using 
1235     \func{rmdir}\\ \func{rename}
1236     &         &         &$\bullet$&         &$\bullet$&$\bullet$& per entrambi
1237     gli argomenti\\ \func{rmdir}
1238     &         &         &         &         &$\bullet$&$\bullet$& \\ 
1239     \func{truncate}, \func{ftruncate}
1240     &         &$\bullet$&$\bullet$&         &         &         & \\ 
1241     \func{unlink}
1242     &         &         &$\bullet$&         &$\bullet$&$\bullet$& \\ 
1243     \func{utime}
1244     &$\bullet$&$\bullet$&$\bullet$&         &         &         & \\ 
1245     \func{write}
1246     &         &$\bullet$&$\bullet$&         &         &         & \\ 
1247     \hline
1248   \end{tabular}
1249   \caption{Prospetto dei cambiamenti effettuati sui tempi di ultimo 
1250     accesso \textsl{(a)}, ultima modifica \textsl{(m)} e ultimo cambiamento
1251     \textsl{(c)} dalle varie funzioni operanti su file e directory.}
1252   \label{tab:file_times_effects}  
1253 \end{table}
1254
1255 Si noti infine come \var{st\_ctime} non abbia nulla a che fare con il tempo di
1256 creazione del file, usato in molti altri sistemi operativi, ma che in unix non
1257 esiste. Per questo motivo quando si copia un file, a meno di preservare
1258 esplicitamente i tempi (ad esempio con l'opzione \cmd{-p} di \cmd{cp}) esso
1259 avrà sempre il tempo corrente come data di ultima modifica.
1260
1261
1262 \subsection{La funzione \func{utime}}
1263 \label{sec:file_utime}
1264
1265 I tempi di ultimo accesso e modifica possono essere cambiati usando la
1266 funzione \func{utime}, il cui prototipo è:
1267 \begin{prototype}{utime.h}
1268 {int utime(const char *filename, struct utimbuf *times)} 
1269
1270 Cambia i tempi di ultimo accesso e modifica dell'inode specificato da
1271 \param{filename} secondo i campi \var{actime} e \var{modtime} di
1272 \param{times}. Se questa è \macro{NULL} allora viene usato il tempo corrente.
1273
1274 \bodydesc{La funzione restituisce zero in caso di successo e -1 in caso
1275   di errore, nel qual caso \var{errno} è settata opportunamente.
1276 \begin{errlist}
1277 \item[\macro{EACCESS}] non si ha il permesso di scrittura sul file.
1278 \item[\macro{ENOENT}] \param{filename} non esiste.
1279 \end{errlist}}
1280 \end{prototype}
1281  
1282 La struttura \var{utimebuf} usata da \func{utime} è definita come:
1283 \begin{lstlisting}[labelstep=0,frame=,indent=1cm]{}
1284 struct utimbuf {
1285         time_t actime;  /* access time */
1286         time_t modtime; /* modification time */
1287 };
1288 \end{lstlisting}
1289
1290 L'effetto della funzione e i privilegi necessari per eseguirla dipendono da
1291 cosa è l'argomento \param{times}; se è \macro{NULL} la funzione setta il tempo
1292 corrente ed è sufficiente avere accesso in scrittura al file; se invece si è
1293 specificato un valore la funzione avrà successo solo se si è proprietari del
1294 file (o si hanno i privilegi di amministratore).
1295
1296 Si tenga presente che non è comunque possibile specificare il tempo di
1297 cambiamento di stato del file, che viene comunque cambiato dal kernel tutte le
1298 volte che si modifica l'inode (quindi anche alla chiamata di \func{utime}).
1299 Questo serve anche come misura di sicurezza per evitare che si possa
1300 modificare un file nascondendo completamente le proprie tracce.  In realtà la
1301 cosa resta possibile, se si è in grado di accedere al device, scrivendo
1302 direttamente sul disco senza passare attraverso il filesystem, ma ovviamente
1303 in questo modo la cosa è molto più complicata da realizzare.
1304
1305
1306
1307 \section{Il controllo di accesso ai file}
1308 \label{sec:file_access_control}
1309
1310 Una delle caratteristiche fondamentali di tutti i sistemi unix-like è quella
1311 del controllo di accesso ai file, che viene implementato per qualunque
1312 filesystem standard. In questa sezione ne esamineremo i concetti essenziali e
1313 le funzioni usate per gestirne i vari aspetti.
1314
1315
1316 \subsection{I permessi per l'accesso ai file}
1317 \label{sec:file_perm_overview}
1318
1319 Il controllo di accesso ai file in unix segue un modello abbastanza semplice
1320 (ma adatto alla gran parte delle esigenze) in cui si dividono i permessi su
1321 tre livelli. Si tenga conto poi che quanto diremo è vero solo per filesystem
1322 di tipo unix, e non è detto che sia applicabile a un filesystem
1323 qualunque\footnote{ed infatti non è vero per il filesystem vfat di Windows,
1324   per il quale i permessi vengono assegnati in maniera fissa con un opzione in
1325   fase di montaggio}.  Esistono inoltre estensioni che permettono di
1326 implementare le ACL (\textit{Access Control List}) che sono un meccanismo di
1327 controllo di accesso molto più sofisticato.
1328
1329 Ad ogni file unix associa sempre l'utente che ne è proprietario (il cosiddetto
1330 \textit{owner}) e il gruppo di appartenenza, secondo il meccanismo degli
1331 identificatori di utenti e gruppi (\acr{uid} e \acr{gid}). Questi valori
1332 sono accessibili da programma tramite i campi \var{st\_uid} e \var{st\_gid}
1333 della struttura \var{stat} (si veda \secref{sec:file_stat}). Ad ogni file
1334 viene inoltre associato un insieme di permessi che sono divisi in tre classi,
1335 e cioè attribuiti rispettivamente all'utente proprietario del file, a un
1336 qualunque utente faccia parte del gruppo cui appartiene il file, e a tutti gli
1337 altri utenti.
1338
1339 I permessi, così come vengono presi dai comandi e dalle routine di sistema,
1340 sono espressi da un numero di 12 bit; di questi i nove meno significativi sono
1341 usati a gruppi di tre per indicare i permessi base di lettura, scrittura ed
1342 esecuzione (indicati nei comandi di sistema con le lettere \cmd{w}, \cmd{r} e
1343 \cmd{x}) ed applicabili rispettivamente al proprietario, al gruppo, a tutti
1344 gli altri.  I restanti tre bit (\acr{suid}, \acr{sgid}, e
1345 \textsl{sticky}) sono usati per indicare alcune caratteristiche più complesse
1346 su cui torneremo in seguito (vedi \secref{sec:file_suid_sgid} e
1347 \secref{sec:file_sticky}).
1348
1349 Anche i permessi, come tutte le altre informazioni generali, sono tenuti per
1350 ciascun file nell'inode; in particolare essi sono contenuti in alcuni bit
1351 del campo \var{st\_mode} della struttura letta da \func{stat} (di nuovo si veda
1352 \secref{sec:file_stat} per i dettagli).
1353
1354 In genere ci si riferisce a questo raggruppamento dei permessi usando le
1355 lettere \cmd{u} (per \textit{user}), \cmd{g} (per \textit{group}) e \cmd{o}
1356 (per \textit{other}), inoltre se si vuole indicare tutti i raggruppamenti
1357 insieme si usa la lettera \cmd{a} (per \textit{all}). Si tenga ben presente
1358 questa distinzione dato che in certi casi, mutuando la terminologia in uso nel
1359 VMS, si parla dei permessi base come di permessi per \textit{owner},
1360 \textit{group} ed \textit{all}, le cui iniziali possono dar luogo a confusione.
1361 Le costanti che permettono di accedere al valore numerico di questi bit nel
1362 campo \var{st\_mode} sono riportate in \ntab.
1363
1364 \begin{table}[htb]
1365   \centering
1366     \footnotesize
1367   \begin{tabular}[c]{|c|l|}
1368     \hline
1369     \textbf{\var{st\_mode}} bit & \textbf{Significato} \\
1370     \hline 
1371     \hline 
1372     \macro{S\_IRUSR}  &  \textit{user-read}, l'utente può leggere     \\
1373     \macro{S\_IWUSR}  &  \textit{user-write}, l'utente può scrivere   \\
1374     \macro{S\_IXUSR}  &  \textit{user-execute}, l'utente può eseguire \\ 
1375     \hline              
1376     \macro{S\_IRGRP}  &  \textit{group-read}, il gruppo può leggere    \\
1377     \macro{S\_IWGRP}  &  \textit{group-write}, il gruppo può scrivere  \\
1378     \macro{S\_IXGRP}  &  \textit{group-execute}, il gruppo può eseguire\\
1379     \hline              
1380     \macro{S\_IROTH}  &  \textit{other-read}, tutti possono leggere    \\
1381     \macro{S\_IWOTH}  &  \textit{other-write}, tutti possono scrivere  \\
1382     \macro{S\_IXOTH}  &  \textit{other-execute}, tutti possono eseguire\\
1383     \hline              
1384   \end{tabular}
1385   \caption{I bit dei permessi di accesso ai file, come definiti in 
1386     \texttt{<sys/stat.h>}}
1387   \label{tab:file_bit_perm}
1388 \end{table}
1389
1390 Questi permessi vengono usati in maniera diversa dalle varie funzioni, e a
1391 seconda che si riferiscano a file, link simbolici o directory, qui ci
1392 limiteremo ad un riassunto delle regole generali, entrando nei dettagli più
1393 avanti.
1394
1395 La prima regola è che per poter accedere ad un file attraverso il suo pathname
1396 occorre il permesso di esecuzione in ciascuna delle directory che compongono
1397 il pathname, e lo stesso vale per aprire un file nella directory corrente (per
1398 la quale appunto serve il diritto di esecuzione).
1399
1400 Per una directory infatti il permesso di esecuzione ha il significato
1401 specifico che essa può essere attraversata nella risoluzione del pathname, ed
1402 è distinto dal permesso di lettura che invece implica che si può leggere il
1403 contenuto della directory. Questo significa che se si ha il permesso di
1404 esecuzione senza permesso di lettura si potrà lo stesso aprire un file in una
1405 directory (se si hanno i permessi opportuni per il medesimo) ma non si potrà
1406 vederlo con \cmd{ls} (per crearlo occorrerà anche il permesso di scrittura per
1407 la directory).
1408
1409 Avere il permesso di lettura per un file consente di aprirlo con le opzioni di
1410 sola lettura (\macro{O\_RDONLY}) o di lettura/scrittura (\macro{O\_RDWR}) e
1411 leggerne il contenuto. Avere il permesso di scrittura consente di aprire un
1412 file in sola scrittura (\macro{O\_WRONLY}) o lettura/scrittura
1413 (\macro{O\_RDWR}) e modificarne il contenuto, lo stesso permesso è necessario
1414 per poter troncare il file con l'opzione \macro{O\_TRUNC}.
1415
1416 Non si può creare un file fintanto che non si disponga del permesso di
1417 esecuzione e di quello di scrittura per la directory di destinazione; gli
1418 stessi permessi occorrono per cancellare un file da una directory (si ricordi
1419 che questo non implica necessariamente la rimozione del contenuto del file dal
1420 disco), non è necessario nessun tipo di permesso per il file stesso (infatti
1421 esso non viene toccato, viene solo modificato il contenuto della directory,
1422 rimuovendo la voce che ad esso fa rifermento).
1423
1424 Per poter eseguire un file (che sia un programma compilato od uno script di
1425 shell, od un altro tipo di file eseguibile riconosciuto dal kernel), occorre
1426 avere il permesso di esecuzione, inoltre solo i file regolari possono essere
1427 eseguiti.
1428
1429 I permessi per un link simbolico sono ignorati, contano quelli del file a cui
1430 fa riferimento; per questo in genere \cmd{ls} per un link simbolico riporta
1431 tutti i permessi come concessi; utente e gruppo a cui esso appartiene vengono
1432 ignorati quando il link viene risolto, vengono controllati solo quando viene
1433 richiesta la rimozione del link e quest'ultimo è in una directory con lo
1434 \textsl{sticky bit} settato (si veda \secref{sec:file_sticky}).
1435
1436 La procedura con cui il kernel stabilisce se un processo possiede un certo
1437 permesso (di lettura, scrittura o esecuzione) si basa sul confronto fra
1438 l'utente e il gruppo a cui il file appartiene (i valori di \var{st\_uid} e
1439 \var{st\_gid} accennati in precedenza) e l'\textit{effective user id},
1440 l'\textit{effective group id} e gli eventuali \textit{supplementary group id}
1441 del processo\footnote{in realtà Linux per quanto riguarda l'accesso ai file
1442   utilizza al posto degli \textit{effective id} i \textit{filesystem id} (si
1443   veda \secref{sec:proc_perms}), ma essendo questi del tutto equivalenti ai
1444   primi, eccetto il caso in cui si voglia scrivere un server NFS, ignoreremo
1445   questa differenza}.
1446
1447 Per una spiegazione dettagliata degli identificatori associati ai processi si
1448 veda \secref{sec:proc_perms}; normalmente, a parte quanto vedremo in
1449 \secref{sec:file_suid_sgid}, l'\textit{effective user id} e
1450 l'\textit{effective group id} corrispondono a \acr{uid} e \acr{gid}
1451 dell'utente che ha lanciato il processo, mentre i \textit{supplementary group
1452   id} sono quelli dei gruppi cui l'utente appartiene.
1453
1454 I passi attraverso i quali viene stabilito se il processo possiede il diritto
1455 di accesso sono i seguenti:
1456 \begin{enumerate}
1457 \item Se l'\textit{effective user id} del processo è zero (corrispondente
1458   all'amministratore) l'accesso è sempre garantito senza nessun ulteriore
1459   controllo. Per questo motivo \textsl{root} ha piena libertà di accesso a
1460   tutti i file.
1461 \item Se l'\textit{effective user id} del processo è uguale all'\acr{uid} del
1462   proprietario del file (nel qual caso si dice che il processo è proprietario
1463   del file) allora:
1464   \begin{itemize*}
1465   \item se il relativo\footnote{per relativo si intende il bit di user-read se
1466       il processo vuole accedere in scrittura, quello di user-write per
1467       l'accesso in scrittura, etc.} bit dei permessi d'accesso dell'utente è
1468     settato, l'accesso è consentito
1469   \item altrimenti l'accesso è negato
1470   \end{itemize*}
1471 \item Se l'\textit{effective group id} del processo o uno dei
1472   \textit{supplementary group id} dei processi corrispondono al \acr{gid} del
1473   file allora:
1474   \begin{itemize*}
1475   \item se il bit dei permessi d'accesso del gruppo è settato, l'accesso è
1476     consentito, 
1477   \item altrimenti l'accesso è negato
1478   \end{itemize*}
1479 \item se il bit dei permessi d'accesso per tutti gli altri è settato,
1480   l'accesso è consentito, altrimenti l'accesso è negato.
1481 \end{enumerate}
1482
1483 Si tenga presente che questi passi vengono eseguiti esattamente in
1484 quest'ordine. Questo vuol dire che se un processo è il proprietario di un file
1485 l'accesso è consentito o negato solo sulla base dei permessi per l'utente; i
1486 permessi per il gruppo non vengono neanche controllati; lo stesso vale se il
1487 processo appartiene ad un gruppo appropriato, in questo caso i permessi per
1488 tutti gli altri non vengono controllati.
1489
1490
1491 \subsection{I bit \acr{suid} e \acr{sgid}}
1492 \label{sec:file_suid_sgid}
1493
1494 Come si è accennato (in \secref{sec:file_perm_overview}) nei dodici bit del
1495 campo \var{st\_mode} usati per il controllo di accesso oltre ai bit dei
1496 permessi veri e propri, ci sono altri tre bit che vengono usati per indicare
1497 alcune proprietà speciali dei file.  Due di questi sono i bit detti
1498 \acr{suid} (o \textit{set-user-ID bit}) e \acr{sgid} (o
1499 \textit{set-group-ID bit}) che sono identificati dalle costanti
1500 \macro{S\_ISUID} e \macro{S\_ISGID}.
1501
1502 Come spiegato in dettaglio in \secref{sec:proc_exec}, quando si lancia un
1503 programma il comportamento normale del kernel è quello di settare
1504 l'\textit{effective user id} e l'\textit{effective group id} del nuovo
1505 processo all'\acr{uid} e al \acr{gid} del processo corrente, che normalmente
1506 corrispondono dell'utente con cui si è entrati nel sistema.
1507
1508 Se però il file del programma\footnote{per motivi di sicurezza il kernel
1509   ignora i bit \acr{suid} e \acr{sgid} per gli script eseguibili} (che
1510 ovviamente deve essere eseguibile) ha il bit \acr{suid} settato, il kernel
1511 assegnerà come \textit{effective user id} al nuovo processo l'\acr{uid} del
1512 proprietario del file al posto dell'\acr{uid} del processo originario.  Avere
1513 il bit \acr{sgid} settato ha lo stesso effetto sull'\textit{effective group
1514   id} del processo.
1515
1516 I bit \acr{suid} e \acr{sgid} vengono usati per permettere agli utenti normali
1517 di usare programmi che abbisognano di privilegi speciali; l'esempio classico è
1518 il comando \cmd{passwd} che ha la necessità di modificare il file delle
1519 password, quest'ultimo ovviamente può essere scritto solo dall'amministratore,
1520 ma non è necessario chiamare l'amministratore per cambiare la propria
1521 password. Infatti il comando \cmd{passwd} appartiene a root ma ha il bit
1522 \acr{suid} settato per cui quando viene lanciato da un utente normale parte
1523 con i privilegi di root.
1524
1525 Chiaramente avere un processo che ha privilegi superiori a quelli che avrebbe
1526 normalmente l'utente che lo ha lanciato comporta vari rischi, e questo tipo di
1527 programmi devono essere scritti accuratamente per evitare che possano essere
1528 usati per guadagnare privilegi non consentiti (torneremo sull'argomento in
1529 \secref{sec:proc_perms}).
1530
1531 La presenza dei bit \acr{suid} e \acr{sgid} su un file può essere
1532 rilevata con il comando \cmd{ls -l}, in tal caso comparirà la lettera \cmd{s}
1533 al posto della \cmd{x} in corrispondenza dei permessi di utente o gruppo. La
1534 stessa lettera \cmd{s} può essere usata nel comando \cmd{chmod} per settare
1535 questi bit. Infine questi bit possono essere controllati all'interno di
1536 \var{st\_mode} con l'uso delle due costanti \macro{S\_ISUID} e
1537 \macro{S\_IGID}, i cui valori sono riportati in
1538 \tabref{tab:file_mode_flags}.
1539
1540 Gli stessi bit vengono ad assumere in significato completamente diverso per le
1541 directory, normalmente infatti Linux usa la convenzione di SVR4 per indicare
1542 con questi bit l'uso della semantica BSD nella creazione di nuovi file (si
1543 veda \secref{sec:file_ownership} per una spiegazione dettagliata al
1544 proposito).
1545
1546 Infine Linux utilizza il bit \acr{sgid} per una ulteriore estensione
1547 mutuata da SVR4. Il caso in cui il file abbia il bit \acr{sgid} settato ma
1548 non il corrispondente bit di esecuzione viene utilizzato per attivare per
1549 quel file il \textit{mandatory locking} (argomento che affronteremo nei
1550 dettagli in \secref{sec:file_mand_locking}).
1551
1552
1553 \subsection{Il bit \textsl{sticky}}
1554 \label{sec:file_sticky}
1555
1556 L'ultimo dei bit rimanenti, identificato dalla costante \macro{S\_ISVTX}, è in
1557 parte un rimasuglio delle origini dei sistemi unix. A quell'epoca infatti la
1558 memoria virtuale e l'accesso ai files erano molto meno sofisticati e per
1559 ottenere la massima velocità possibile per i programmi usati più comunemente
1560 si poteva settare questo bit.
1561
1562 L'effetto di questo bit era che il segmento di testo del programma (si veda
1563 \secref{sec:proc_mem_layout} per i dettagli) veniva scritto nella swap la
1564 prima volta che questo veniva lanciato, e vi permaneva fino al riavvio della
1565 macchina (da questo il nome di \textsl{sticky bit}); essendo la swap un file
1566 continuo indicizzato direttamente in questo modo si poteva risparmiare in
1567 tempo di caricamento rispetto alla ricerca del file su disco. Lo
1568 \textsl{sticky bit} è indicato usando la lettera \cmd{t} al posto della
1569 \cmd{x} nei permessi per gli altri.
1570
1571 Ovviamente per evitare che gli utenti potessero intasare la swap solo
1572 l'amministratore era in grado di settare questo bit, che venne chiamato anche
1573 con il nome di \textit{saved text bit}, da cui deriva quello della costante.
1574 Le attuali implementazioni di memoria virtuale e filesystem rendono
1575 sostanzialmente inutile questo procedimento.
1576
1577 Benché ormai non venga più utilizzato per i file, lo \textsl{sticky bit} ha
1578 assunto un uso corrente per le directory\footnote{lo \textsl{sticky bit} per
1579   le directory è una estensione non definita nello standard POSIX, Linux però
1580   la supporta, così come BSD e SVR4}, in questo caso se il bit è settato un
1581 file potrà essere rimosso dalla directory soltanto se l'utente ha il permesso
1582 di scrittura ed inoltre è vera una delle seguenti condizioni:
1583 \begin{itemize*}
1584 \item l'utente è proprietario del file
1585 \item l'utente è proprietario della directory
1586 \item l'utente è l'amministratore 
1587 \end{itemize*}
1588 un classico esempio di directory che ha questo bit settato è \file{/tmp}, i
1589 permessi infatti di solito sono settati come:
1590 \begin{verbatim}
1591 $ ls -ld /tmp
1592 drwxrwxrwt    6 root     root         1024 Aug 10 01:03 /tmp
1593 \end{verbatim}%$
1594 in questo modo chiunque può leggere, scrivere ed eseguire i file temporanei
1595 ivi memorizzati, sia crearne di nuovi, ma solo l'utente che ha creato un file
1596 nella directory potrà cancellarlo o rinominarlo, così si può evitare che un
1597 utente possa, più o meno consapevolmente, cancellare i file degli altri.
1598
1599
1600 \subsection{La titolarità di nuovi file e directory}
1601 \label{sec:file_ownership}
1602
1603 Vedremo in \secref{sec:file_base_func} come creare nuovi file, ma se è
1604 possibile specificare in sede di creazione quali permessi applicare ad un
1605 file, non si può indicare a quale utente e gruppo esso deve appartenere.  Lo
1606 stesso problema di presenta per la creazione di nuove directory (procedimento
1607 descritto in \secref{sec:file_dir_creat_rem}).
1608
1609 Lo standard POSIX prescrive che l'\acr{uid} del nuovo file corrisponda
1610 all'\textit{effective user id} del processo che lo crea; per il \acr{gid}
1611 invece prevede due diverse possibilità:
1612 \begin{itemize*}
1613 \item il \acr{gid} del file corrisponde all'\textit{effective group id} del
1614   processo.
1615 \item il \acr{gid} del file corrisponde al \acr{gid} della directory in cui
1616   esso è creato.
1617 \end{itemize*}
1618 in genere BSD usa sempre la seconda possibilità, che viene per questo chiamata
1619 semantica BSD. Linux invece segue quella che viene chiamata semantica SVr4; di
1620 norma cioè il nuovo file viene creato, seguendo la prima opzione, con il
1621 \acr{gid} del processo, se però la directory in cui viene creato il file ha il
1622 bit \acr{sgid} settato allora viene usata la seconda opzione.
1623
1624 Usare la semantica BSD ha il vantaggio che il \acr{gid} viene sempre
1625 automaticamente propagato, restando coerente a quello della directory di
1626 partenza, in tutte le sottodirectory. La semantica SVr4 offre una maggiore
1627 possibilità di scelta, ma per ottenere lo stesso risultato necessita che per
1628 le nuove directory venga anche propagato anche il bit \acr{sgid}. Questo è
1629 comunque il comportamento di default di \func{mkdir}, ed é in questo modo ad
1630 esempio che Debian assicura che le sottodirectory create nelle home di un
1631 utente restino sempre con il \acr{gid} del gruppo primario dello stesso.
1632
1633
1634 \subsection{La funzione \func{access}}
1635 \label{sec:file_access}
1636
1637 Come detto in \secref{sec:file_access_control} il controllo di accesso ad
1638 un file viene fatto usando \textit{effective user id} e \textit{effective
1639   group id} del processo, ma ci sono casi in cui si può voler effettuare il
1640 controllo usando il \textit{real user id} e il \textit{real group id} (cioè
1641 l'\acr{uid} dell'utente che ha lanciato il programma, che, come accennato in
1642 \secref{sec:file_suid_sgid} e spiegato in \secref{sec:proc_perms} non è
1643 detto sia uguale all'\textit{effective user id}). Per far questo si può usare
1644 la funzione \func{access}, il cui prototipo è:
1645 \begin{prototype}{unistd.h}
1646 {int access(const char *pathname, int mode)}
1647
1648 Verifica i permessi di accesso, indicati da \var{mode}, per il file indicato
1649 da \var{pathname}.
1650   
1651 \bodydesc{La funzione ritorna 0 se l'accesso è consentito, -1 altrimenti; in
1652   quest'ultimo caso la variabile \var{errno} viene settata secondo i codici di
1653   errore: \macro{EACCES}, \macro{EROFS}, \macro{EFAULT}, \macro{EINVAL},
1654   \macro{ENAMETOOLONG}, \macro{ENOENT}, \macro{ENOTDIR}, \macro{ELOOP},
1655   \macro{EIO}.}
1656 \end{prototype}
1657
1658 I valori possibili per il parametro \var{mode} sono esprimibili come
1659 combinazione delle costanti numeriche riportate in \ntab\ (attraverso un OR
1660 binario). I primi tre valori implicano anche la verifica dell'esistenza del
1661 file, se si vuole verificare solo quest'ultima si può usare \macro{F\_OK}, o
1662 anche direttamente \func{stat}. In caso \var{pathname} si riferisca ad un link
1663 simbolico il controllo è fatto sul file a cui esso fa riferimento.
1664
1665 La funzione controlla solo i bit dei permessi di accesso, si ricordi che il
1666 fatto che una directory abbia permesso di scrittura non significa che ci si
1667 possa scrivere come in un file, e il fatto che un file abbia permesso di
1668 esecuzione non comporta che contenga un programma eseguibile. La funzione
1669 ritorna zero solo se tutte i permessi controllati sono disponibili, in caso
1670 contrario (o di errore) ritorna -1.
1671 \begin{table}[htb]
1672   \centering
1673   \footnotesize
1674   \begin{tabular}{|c|l|}
1675     \hline
1676     \textbf{\var{mode}} & \textbf{Significato} \\
1677     \hline
1678     \hline
1679     \macro{R\_OK} & verifica il permesso di lettura \\
1680     \macro{W\_OK} & verifica il permesso di scritture \\
1681     \macro{X\_OK} & verifica il permesso di esecuzione \\
1682     \macro{F\_OK} & verifica l'esistenza del file \\
1683     \hline
1684   \end{tabular}
1685   \caption{Valori possibile per il parametro \var{mode} della funzione 
1686     \func{access}}
1687   \label{tab:file_access_mode_val}
1688 \end{table}
1689
1690 Un esempio tipico per l'uso di questa funzione è quello di un processo che sta
1691 eseguendo un programma coi privilegi di un altro utente (attraverso l'uso del
1692 \acr{suid} bit) che vuole controllare se l'utente originale ha i permessi per
1693 accedere ad un certo file.
1694
1695
1696 \subsection{Le funzioni \func{chmod} e \func{fchmod}}
1697 \label{sec:file_chmod}
1698
1699 Per cambiare i permessi di un file il sistema mette ad disposizione due
1700 funzioni, che operano rispettivamente su un filename e su un file descriptor,
1701 i loro prototipi sono:
1702 \begin{functions}
1703   \headdecl{sys/types.h} 
1704   \headdecl{sys/stat.h} 
1705   
1706   \funcdecl{int chmod(const char *path, mode\_t mode)} Cambia i permessi del
1707   file indicato da \var{path} al valore indicato da \var{mode}.
1708   
1709   \funcdecl{int fchmod(int fd, mode\_t mode)} Analoga alla precedente, ma usa
1710   il file descriptor \var{fd} per indicare il file.
1711   
1712   \bodydesc{Le funzioni restituiscono zero in caso di successo e -1 per
1713     un errore, in caso di errore \var{errno} può assumere i valori:
1714   \begin{errlist}
1715   \item[\macro{EPERM}] L'\textit{effective user id} non corrisponde a quello
1716     del proprietario del file o non è zero.
1717   \end{errlist}
1718   ed inoltre \macro{EROFS} e \macro{EIO}; \func{chmod} restituisce anche
1719   \macro{EFAULT}, \macro{ENAMETOOLONG}, \macro{ENOENT}, \macro{ENOMEM},
1720   \macro{ENOTDIR}, \macro{EACCES}, \macro{ELOOP}; \func{fchmod} anche
1721   \macro{EBADF}.}
1722 \end{functions}
1723
1724 I valori possibili per \var{mode} sono indicati in \ntab. I valori possono
1725 esser combinati con l'OR binario delle relative costanti simboliche, o
1726 specificati direttamente, come per l'analogo comando di shell, con il valore
1727 numerico (la shell lo vuole in ottale, dato che i bit dei permessi sono
1728 divisibili in gruppi di tre). Ad esempio i permessi standard assegnati ai
1729 nuovi file (lettura e scrittura per il proprietario, sola lettura per il
1730 gruppo e gli altri) sono corrispondenti al valore ottale $0644$, un programma
1731 invece avrebbe anche il bit di esecuzione attivo, con un valore di $0755$, se
1732 si volesse attivare il bit \acr{suid} il valore da fornire sarebbe $4755$.
1733
1734 \begin{table}[!htb]
1735   \centering
1736   \footnotesize
1737   \begin{tabular}[c]{|c|c|l|}
1738     \hline
1739     \textbf{\var{mode}} & \textbf{Valore} & \textbf{Significato} \\
1740     \hline
1741     \hline
1742     \macro{S\_ISUID} & 04000 & set user ID \\
1743     \macro{S\_ISGID} & 02000 & set group ID \\
1744     \macro{S\_ISVTX} & 01000 & sticky bit \\
1745     \hline
1746     \macro{S\_IRWXU} & 00700 & l'utente ha tutti i permessi \\
1747     \macro{S\_IRUSR} & 00400 & l'utente ha il permesso di lettura  \\
1748     \macro{S\_IWUSR} & 00200 & l'utente ha il permesso di scrittura \\
1749     \macro{S\_IXUSR} & 00100 & l'utente ha il permesso di esecuzione \\
1750     \hline
1751     \macro{S\_IRWXG} & 00070 & il gruppo ha tutti i permessi  \\
1752     \macro{S\_IRGRP} & 00040 & il gruppo ha il permesso di lettura  \\
1753     \macro{S\_IWGRP} & 00020 & il gruppo ha il permesso di scrittura \\
1754     \macro{S\_IXGRP} & 00010 & il gruppo ha il permesso di esecuzione \\
1755     \hline
1756     \macro{S\_IRWXO} & 00007 & gli altri hanno tutti i permessi \\
1757     \macro{S\_IROTH} & 00004 & gli altri hanno il permesso di lettura  \\
1758     \macro{S\_IWOTH} & 00002 & gli altri hanno il permesso di scrittura \\
1759     \macro{S\_IXOTH} & 00001 & gli altri hanno il permesso di esecuzione \\
1760     \hline
1761   \end{tabular}
1762   \caption{I valori delle costanti usate per indicare i permessi dei file.}
1763   \label{tab:file_permission_const}
1764 \end{table}
1765
1766 Il cambiamento dei permessi di un file attraverso queste funzioni ha comunque
1767 alcune limitazioni, provviste per motivi di sicurezza. Questo significa che
1768 anche se si è proprietari del file non tutte le operazioni sono permesse, in
1769 particolare:
1770 \begin{enumerate}
1771 \item siccome solo l'amministratore può settare lo \textit{sticky bit}; se
1772   l'\textit{effective user id} del processo non è zero esso viene
1773   automaticamente cancellato (senza notifica di errore) qualora sia stato
1774   indicato in \var{mode}.
1775 \item per via della semantica SVR4 nella creazione dei nuovi file, si può
1776   avere il caso in cui il file creato da un processo è assegnato a un gruppo
1777   per il quale il processo non ha privilegi. Per evitare che si possa
1778   assegnare il bit \acr{sgid} ad un file appartenente a un gruppo per cui
1779   non si hanno diritti, questo viene automaticamente cancellato (senza
1780   notifica di errore) da \var{mode} qualora il gruppo del file non corrisponda
1781   a quelli associati al processo (la cosa non avviene quando
1782   l'\textit{effective user id} del processo è zero).
1783 \end{enumerate}
1784
1785 Per alcuni filesystem\footnote{il filesystem \acr{ext2} supporta questa
1786   caratteristica, che è mutuata da BSD.} è inoltre prevista una ulteriore
1787 misura di sicurezza, volta ad scongiurare l'abuso dei bit \acr{suid} e
1788 \acr{sgid}; essa consiste nel cancellare automaticamente questi bit qualora un
1789 processo che non appartenga all'amministratore scriva su un file. In questo
1790 modo anche se un utente malizioso scopre un file \acr{suid} su cui può
1791 scrivere, un eventuale modifica comporterà la perdita di ogni ulteriore
1792 privilegio.
1793
1794 \subsection{La funzione \func{umask}}
1795 \label{sec:file_umask}
1796
1797 Oltre che dai valori indicati in sede di creazione, i permessi assegnati ai
1798 nuovi file sono controllati anche da una maschera di bit settata con la
1799 funzione \func{umask}, il cui prototipo è:
1800 \begin{prototype}{stat.h}
1801 {mode\_t umask(mode\_t mask)}
1802
1803   Setta la maschera dei permessi dei bit al valore specificato da \var{mask}
1804   (di cui vengono presi solo i 9 bit meno significativi).
1805   
1806   \bodydesc{La funzione ritorna il precedente valore della maschera. È una
1807     delle poche funzioni che non restituisce codici di errore.}
1808 \end{prototype}
1809
1810 Questa maschera è una caratteristica di ogni processo e viene utilizzata per
1811 impedire che alcuni permessi possano essere assegnati ai nuovi file in sede di
1812 creazione, i bit indicati nella maschera vengono infatti esclusi quando un
1813 nuovo file viene creato.
1814
1815 In genere questa maschera serve per impostare un default che escluda alcuni
1816 permessi (usualmente quello di scrittura per il gruppo e gli altri,
1817 corrispondente ad un valore di $022$). Essa è utile perché le routine
1818 dell'interfaccia ANSI C degli stream non prevedono l'esistenza dei permessi, e
1819 pertanto tutti i nuovi file vengono sempre creati con un default di $666$
1820 (cioè permessi di lettura e scrittura per tutti, si veda
1821 \tabref{tab:file_permission_const} per un confronto); in questo modo è
1822 possibile cancellare automaticamente i permessi non voluti, senza doverlo fare
1823 esplicitamente.
1824
1825 In genere il valore di \func{umask} viene stabilito una volta per tutte al
1826 login a $022$, e di norma gli utenti non hanno motivi per modificarlo. Se però
1827 si vuole che un processo possa creare un file che chiunque possa leggere
1828 allora occorrerà cambiare il valore di \func{umask}.
1829
1830
1831 \subsection{Le funzioni \func{chown}, \func{fchown} e \func{lchown}}
1832 \label{sec:file_chown}
1833
1834 Come per i permessi, il sistema fornisce anche delle funzioni che permettano
1835 di cambiare utente e gruppo cui il file appartiene; le funzioni in questione
1836 sono tre e i loro prototipi sono i seguenti:
1837 \begin{functions}
1838   \headdecl{sys/types.h} 
1839   \headdecl{sys/stat.h} 
1840   
1841   \funcdecl{int chown(const char *path, uid\_t owner, gid\_t group)}
1842   \funcdecl{int fchown(int fd, uid\_t owner, gid\_t group)}
1843   \funcdecl{int lchown(const char *path, uid\_t owner, gid\_t group)}
1844
1845   Le funzioni cambiano utente e gruppo di appartenenza di un file ai valori
1846   specificati dalle variabili \var{owner} e \var{group}. 
1847   
1848   \bodydesc{Le funzioni restituiscono zero in caso di successo e -1 per
1849     un errore, in caso di errore \texttt{errno} viene settato ai valori:
1850   \begin{errlist}
1851   \item[\macro{EPERM}] L'\textit{effective user id} non corrisponde a quello
1852     del proprietario del file o non è zero, o utente e gruppo non sono validi
1853   \end{errlist}
1854   Oltre a questi entrambe restituiscono gli errori \macro{EROFS} e
1855   \macro{EIO}; \func{chown} restituisce anche \macro{EFAULT},
1856   \macro{ENAMETOOLONG}, \macro{ENOENT}, \macro{ENOMEM}, \macro{ENOTDIR},
1857   \macro{EACCES}, \macro{ELOOP}; \func{fchown} anche \macro{EBADF}.}
1858 \end{functions}
1859
1860 In Linux soltanto l'amministratore può cambiare il proprietario di un file,
1861 seguendo la semantica di BSD che non consente agli utenti di assegnare i loro
1862 file ad altri (per evitare eventuali aggiramenti delle quote).
1863 L'amministratore può cambiare il gruppo di un file, il proprietario può
1864 cambiare il gruppo dei file che gli appartengono solo se il nuovo gruppo è il
1865 suo gruppo primario o uno dei gruppi a cui appartiene.
1866
1867 La funzione \func{chown} segue i link simbolici, per operare direttamente su
1868 in link simbolico si deve usare la funzione \func{lchown}\footnote{fino alla
1869   versione 2.1.81 in Linux \func{chown} non seguiva i link simbolici, da
1870   allora questo comportamento è stato assegnato alla funzione \func{lchown},
1871   introdotta per l'occasione, ed è stata creata una nuova system call per
1872   \func{chown} che seguisse i link simbolici}. La funzione \func{fchown} opera
1873 su un file aperto, essa è mutuata da BSD, ma non è nello standard POSIX.
1874 Un'altra estensione rispetto allo standard POSIX è che specificando -1 come
1875 valore per \var{owner} e \var{group} i valori restano immutati. 
1876
1877 Quando queste funzioni sono chiamate con successo da un processo senza i
1878 privilegi di root entrambi i bit \acr{suid} e \acr{sgid} vengono
1879 cancellati. Questo non avviene per il bit \acr{sgid} nel caso in cui esso
1880 sia usato (in assenza del corrispondente permesso di esecuzione) per indicare
1881 che per il file è attivo il \textit{mandatory locking}.
1882
1883 %La struttura fondamentale che contiene i dati essenziali relativi ai file è il
1884 %cosiddetto \textit{inode}; questo conterrà informazioni come il
1885 %tipo di file (file di dispositivo, directory, file di dati, per un elenco
1886 %completo vedi \ntab), i permessi (vedi \secref{sec:file_perms}), le date (vedi
1887 %\secref{sec:file_times}).
1888
1889 \subsection{La funzione \func{chroot}}
1890 \label{sec:file_chroot}
1891
1892 Benché non abbia niente a che fare con permessi, utenti e gruppi, questa
1893 funzione viene usata spesso per restringere le capacità di acccesso di un
1894 programma ad una sezione limitata del filesystem, per cui ne parleremo in
1895 questa sezione.
1896
1897 Come accennato in \secref{sec:proc_fork} ogni processo oltre ad una directory
1898 di lavoro corrente, ha anche una directory radice, cioè una directory che per
1899 il processo costituisce la radice dell'albero del filesystem. Questa viene
1900 eredidata dal padre per ogni processo figlio, (come si può vedere da
1901 \figref{fig:proc_task_struct} è tenuta nella struttura \type{fs\_struct}
1902 insieme alla directory di lavoro corrente e alla \var{umask}) e quindi di
1903 norma coincide con la \file{/} del sistema.
1904
1905 In certe situazioni però per motivi di sicurezza non si vuole che un processo
1906 possa accedere a tutto il filesystem; per questo si può cambiare la directory
1907 radice con la funzione \func{chroot}, il cui prototipo è:
1908 \begin{prototype}{unistd.h}{int chroot(const char *path)}
1909   Cambia la directory radice del processo a quella specificata da
1910   \param{path}..
1911   
1912 \bodydesc{La funzione restituisce zero in caso di successo e -1 per
1913     un errore, in caso di errore \texttt{errno} viene settato ai valori:
1914   \begin{errlist}
1915   \item[\macro{EPERM}] L'\textit{effective user id} non è zero.
1916   \end{errlist}
1917   ed inoltre \macro{EFAULT}, \macro{ENAMETOOLONG}, \macro{ENOENT},
1918   \macro{ENOMEM}, \macro{ENOTDIR}, \macro{EACCES}, \macro{ELOOP};
1919   \macro{EROFS} e \macro{EIO}.}
1920 \end{prototype}
1921
1922
1923
1924
1925
1926 un caso tipico è quello di un server
1927 ftp che dovrebbe limitarsi 
1928
1929
1930 Il sistema però consente di cambiare questa directory con la funzione
1931 \func{chroot}
1932