From: Simone Piccardi <piccardi@gnulinux.it>
Date: Sun, 11 Sep 2011 18:08:46 +0000 (+0000)
Subject: Piccole aggiunte sulle capabilities
X-Git-Url: https://gapil.gnulinux.it/gitweb/?p=gapil.git;a=commitdiff_plain;h=048e7e785e47e46da760906b86d545fe5bdd3020

Piccole aggiunte sulle capabilities
---

diff --git a/filedir.tex b/filedir.tex
index 461bcac..c5aee4e 100644
--- a/filedir.tex
+++ b/filedir.tex
@@ -5610,6 +5610,30 @@ meno banale, otterremo per \texttt{init} una rappresentazione nella forma
 ``\texttt{=ep cap\_setpcap-e}'' dato che come accennato tradizionalmente
 \const{CAP\_SETPCAP} è sempre stata rimossa da detto processo.
 
+Viceversa per passare ottenere un \textit{capability state} dalla sua
+rappresentazione testuale si può usare \funcd{cap\_from\_text}, il cui
+prototipo è:
+\begin{functions}
+  \headdecl{sys/capability.h}
+
+  \funcdecl{cap\_t cap\_from\_text(const char *string)}
+
+  Crea un \textit{capability state} dalla sua rappresentazione testuale.
+
+  \bodydesc{La funzione ritorna un puntatore valido in caso di successo e
+    \val{NULL} in caso di errore, nel qual caso \var{errno} può assumere i
+    valori \errval{EINVAL} o \errval{ENOMEM}.}
+\end{functions}
+
+La funzione restituisce il puntatore ad un \textit{capability state}
+inizializzato con i valori indicati nella stringa \param{string} che ne
+contiene la rappresentazione testuale. La memoria per il \textit{capability
+  state} viene allocata automaticamente dalla funzione e dovrà essere liberata
+con \func{cap\_free}.
+
+Alle due funzioni citate se ne aggiungono altre due che consentono di
+convertire 
+
 Fin quei abbiamo trattato solo le funzioni di servizio relative alla
 manipolazione dei \textit{capability state}; l'interfaccia di gestione prevede
 però anche le funzioni per la gestione delle \textit{capabilities} stesse. La