Piccole aggiunte sulle capabilities
authorSimone Piccardi <piccardi@gnulinux.it>
Sun, 11 Sep 2011 18:08:46 +0000 (18:08 +0000)
committerSimone Piccardi <piccardi@gnulinux.it>
Sun, 11 Sep 2011 18:08:46 +0000 (18:08 +0000)
filedir.tex

index 461bcacb47675dc6acad30db75d0c61558eee390..c5aee4ee7d8229ec8569b7b3b3f1ee1bb1335efd 100644 (file)
@@ -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