X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=blobdiff_plain;f=filedir.tex;h=30d71caf2719152003dd00200760dbfe78023d7a;hp=c1bb182b55d93865bc3f79cbd79ec761be294b10;hb=4d9f9d2efab74ce8580fddb05dbdbe754014cdea;hpb=34f320bccbbb744f178061b94e3a7197c35edd28 diff --git a/filedir.tex b/filedir.tex index c1bb182..30d71ca 100644 --- a/filedir.tex +++ b/filedir.tex @@ -283,7 +283,7 @@ specificato. La funzione che permette di creare un nuovo link simbolico \param{oldpath}. \bodydesc{La funzione restituisce zero in caso di successo e -1 per un - errore, nel qual caso la variabile \var{errno} restituisce i valori: + errore, nel qual caso la variabile \var{errno} assumerà i valori: \begin{errlist} \item[\macro{EPERM}] il filesystem che contiene \param{newpath} non supporta i link simbolici. @@ -362,7 +362,7 @@ la funzione \func{readlink}, il cui prototipo \bodydesc{La funzione restituisce il numero di caratteri letti dentro \var{buff} o -1 per un errore, nel qual caso la variabile - \var{errno} viene impostata a: + \var{errno} assumerà i valori: \begin{errlist} \item[\macro{EINVAL}] \param{path} non è un link simbolico o \param{size} non è positiva. @@ -676,7 +676,7 @@ appunto per \textit{change directory}, il suo prototipo Cambia la directory di lavoro corrente in \param{pathname}. \bodydesc{La funzione restituisce 0 in caso di successo e -1 per un errore, - nel qual caso \var{errno} viene impostata a: + nel qual caso \var{errno} assumerà i valori: \begin{errlist} \item[\macro{ENOTDIR}] Non si è specificata una directory. \item[\macro{EACCESS}] Manca il permesso di ricerca su uno dei componenti di @@ -696,8 +696,8 @@ usa \func{fchdir}, il cui prototipo pathname. \bodydesc{La funzione restituisce zero in caso di successo e -1 per un - errore, in caso di errore \var{errno} viene impostata ai valori - \macro{EBADF} o \macro{EACCES}.} + errore, in caso di errore \var{errno} assumerà i valori \macro{EBADF} o + \macro{EACCES}.} \end{prototype} \noindent anche in questo caso \param{fd} deve essere un file descriptor valido che fa riferimento ad una directory. Inoltre l'unico errore di accesso @@ -780,7 +780,7 @@ POSIX definisce la funzione \func{tempfile}, il cui prototipo \bodydesc{La funzione ritorna il puntatore allo stream associato al file temporaneo in caso di successo e \macro{NULL} in caso di errore, nel qual - caso \var{errno} viene impostata a + caso \var{errno} assumerà i valori: \begin{errlist} \item[\macro{EINTR}] La funzione è stata interrotta da un segnale. \item[\macro{EEXIST}] Non è stato possibile generare un nome univoco. @@ -807,8 +807,8 @@ il suo prototipo \param{template}. \bodydesc{La funzione ritorna il puntatore \param{template} in caso di - successo e \macro{NULL} in caso di errore, nel qual caso \var{errno} viene - impostata a: + successo e \macro{NULL} in caso di errore, nel qual caso \var{errno} + assumerà i valori: \begin{errlist} \item[\macro{EINVAL}] \param{template} non termina con \code{XXXXXX}. \end{errlist}} @@ -833,7 +833,7 @@ prototipo finali di \param{template}. \bodydesc{La funzione ritorna il file descriptor in caso successo e - -1 in caso di errore, nel qual caso \var{errno} viene impostata a: + -1 in caso di errore, nel qual caso \var{errno} assumerà i valori: \begin{errlist} \item[\macro{EINVAL}] \param{template} non termina con \code{XXXXXX}. \item[\macro{EEXIST}] non è riuscita a creare un file temporano, il @@ -858,8 +858,8 @@ In OpenBSD \code{XXXXXX} finali di \param{template}. \bodydesc{La funzione ritorna il puntatore al nome della directory in caso - successo e \macro{NULL} in caso di errore, nel qual caso \var{errno} viene - impostata a: + successo e \macro{NULL} in caso di errore, nel qual caso \var{errno} + assumerà i valori: \begin{errlist} \item[\macro{EINVAL}] \param{template} non termina con \code{XXXXXX}. \end{errlist} @@ -909,11 +909,10 @@ queste funzioni sono i seguenti: eccetto che si usa con un file aperto, specificato tramite il suo file descriptor \var{filedes}. - \bodydesc{Le funzioni restituiscono zero in caso di successo e -1 per - un errore, in caso di errore \var{errno} può assumere uno dei - valori: \macro{EBADF}, \macro{ENOENT}, \macro{ENOTDIR}, - \macro{ELOOP}, \macro{EFAULT}, \macro{EACCESS}, \macro{ENOMEM}, - \macro{ENAMETOOLONG}.} + \bodydesc{Le funzioni restituiscono 0 in caso di successo e -1 per un + errore, nel qual caso \var{errno} assumerà uno dei valori: \macro{EBADF}, + \macro{ENOENT}, \macro{ENOTDIR}, \macro{ELOOP}, \macro{EFAULT}, + \macro{EACCESS}, \macro{ENOMEM}, \macro{ENAMETOOLONG}.} \end{functions} \noindent il loro comportamento è identico, solo che operano rispettivamente su un file, su un link simbolico e su un file descriptor. @@ -1285,12 +1284,12 @@ Cambia i tempi di ultimo accesso e modifica dell'inode specificato da \param{filename} secondo i campi \var{actime} e \var{modtime} di \param{times}. Se questa è \macro{NULL} allora viene usato il tempo corrente. -\bodydesc{La funzione restituisce zero in caso di successo e -1 in caso - di errore, nel qual caso \var{errno} è impostata opportunamente. -\begin{errlist} -\item[\macro{EACCESS}] non si ha il permesso di scrittura sul file. -\item[\macro{ENOENT}] \param{filename} non esiste. -\end{errlist}} +\bodydesc{La funzione restituisce 0 in caso di successo e -1 in caso di + errore, nel qual caso \var{errno} assumerà uno dei valori: + \begin{errlist} + \item[\macro{EACCESS}] non si ha il permesso di scrittura sul file. + \item[\macro{ENOENT}] \param{filename} non esiste. + \end{errlist}} \end{prototype} La struttura \var{utimebuf} usata da \func{utime} è definita come: @@ -1676,14 +1675,21 @@ questo si pu \begin{prototype}{unistd.h} {int access(const char *pathname, int mode)} -Verifica i permessi di accesso, indicati da \var{mode}, per il file indicato -da \var{pathname}. +Verifica i permessi di accesso, indicati da \param{mode}, per il file indicato +da \param{pathname}. -\bodydesc{La funzione ritorna 0 se l'accesso è consentito, -1 altrimenti; in - quest'ultimo caso la variabile \var{errno} viene impostata secondo i codici - di errore: \macro{EACCES}, \macro{EROFS}, \macro{EFAULT}, \macro{EINVAL}, - \macro{ENAMETOOLONG}, \macro{ENOENT}, \macro{ENOTDIR}, \macro{ELOOP}, - \macro{EIO}.} +\bodydesc{La funzione ritorna 0 se l'accesso è consentito, -1 se l'accesso non + è consentito ed in caso di errore; nel qual caso la variabile \var{errno} + assumerà i valori: + \begin{errlist} + \item[\macro{EINVAL}] il valore di \param{mode} non è valido. + \item[\macro{EACCES}] l'accesso al file non è consentito, o non si ha il + permesso di attraversare una delle directory di \param{pathname}. + \item[\macro{EROFS}] si è richiesto l'accesso in scrittura per un file su un + filesystem montato in sola lettura. + \end{errlist} + ed inoltre \macro{EFAULT}, \macro{ENAMETOOLONG}, \macro{ENOENT}, + \macro{ENOTDIR}, \macro{ELOOP}, \macro{EIO}.} \end{prototype} I valori possibili per l'argomento \param{mode} sono esprimibili come @@ -1882,7 +1888,7 @@ sono tre e i loro prototipi sono i seguenti: specificati dalle variabili \var{owner} e \var{group}. \bodydesc{Le funzioni restituiscono zero in caso di successo e -1 per - un errore, in caso di errore \var{errno} viene impostata ai valori: + un errore, in caso di errore \var{errno} può assumere i valori: \begin{errlist} \item[\macro{EPERM}] L'userid effettivo non corrisponde a quello del proprietario del file o non è zero, o utente e gruppo non sono validi @@ -1947,7 +1953,7 @@ radice con la funzione \func{chroot}, il cui prototipo \param{path}. \bodydesc{La funzione restituisce zero in caso di successo e -1 per - un errore, in caso di errore \var{errno} viene impostata ai valori: + un errore, in caso di errore \var{errno} può assumere i valori: \begin{errlist} \item[\macro{EPERM}] L'userid effettivo del processo non è zero. \end{errlist}