Richiede la risoluzione inversa di un indirizzo IP.
\bodydesc{La funzione restituisce l'indirizzo ad una struttura
- \struct{hostent} in caso di successo ed \const{NULL} in caso di errore.}
+ \struct{hostent} in caso di successo ed \val{NULL} in caso di errore.}
\end{functions}
In questo caso l'argomento \param{addr} dovrà essere il puntatore ad una
indirizzo IP.
\bodydesc{Entrambe le funzioni restituiscono l'indirizzo ad una struttura
- \struct{hostent} in caso di successo ed \const{NULL} in caso di errore.}
+ \struct{hostent} in caso di successo ed \val{NULL} in caso di errore.}
\end{functions}
Entrambe le funzioni supportano esplicitamente la scelta di una famiglia di
Risolvono il nome di un servizio nel rispettivo numero di porta e viceversa.
\bodydesc{Ritornano il puntatore ad una struttura \struct{servent} con i
- risultati in caso di successo, o \const{NULL} in caso di errore.}
+ risultati in caso di successo, o \val{NULL} in caso di errore.}
\end{functions}
Entrambe le funzioni prendono come ultimo argomento una stringa \param{proto}
\bodydesc{Le due funzioni \func{setservent} e \func{endservent} non
restituiscono nulla, \func{getservent} restituisce il puntatore ad una
- struttura \struct{servent} in caso di successo e \const{NULL} in caso di
+ struttura \struct{servent} in caso di successo e \val{NULL} in caso di
errore o fine del file.}
\end{functions}
può anche specificare il nome di una rete invece che di una singola macchina.
Il secondo argomento, \param{service}, specifica invece il nome del servizio
che si intende risolvere. Per uno dei due argomenti si può anche usare il
-valore \const{NULL}, nel qual caso la risoluzione verrà effettuata soltanto
+valore \val{NULL}, nel qual caso la risoluzione verrà effettuata soltanto
sulla base del valore dell'altro.
Il terzo argomento, \param{hints}, deve essere invece un puntatore ad una
\struct{addrinfo} della lista.
Ovviamente non è necessario dare dei suggerimenti in ingresso, ed usando
-\const{NULL} come valore per l'argomento \param{hints} si possono compiere
+\val{NULL} come valore per l'argomento \param{hints} si possono compiere
ricerche generiche. Se però si specifica un valore non nullo questo deve
puntare ad una struttura \struct{addrinfo} precedentemente allocata nella
quale siano stati opportunamente impostati i valori dei campi
\const{AI\_PASSIVE} & Viene utilizzato per ottenere un indirizzo in
formato adatto per una successiva chiamata a
\func{bind}. Se specificato quando si è usato
- \const{NULL} come valore per \param{node} gli
+ \val{NULL} come valore per \param{node} gli
indirizzi restituiti saranno inizializzati al
valore generico (\const{INADDR\_ANY} per IPv4 e
\const{IN6ADDR\_ANY\_INIT} per IPv6), altrimenti
validi. \\
\const{EAI\_NONAME} & Il nome a dominio o il servizio non sono noti,
viene usato questo errore anche quando si specifica
- il valore \const{NULL} per entrambi gli argomenti
+ il valore \val{NULL} per entrambi gli argomenti
\param{node} e \param{service}. \\
\const{EAI\_SERVICE} & Il servizio richiesto non è disponibile per il tipo
di socket richiesto, anche se può esistere per
\param{host} e \param{serv}, che dovranno essere state precedentemente
allocate per una lunghezza massima che deve essere specificata con gli altri
due argomenti \param{hostlen} e \param{servlen}. Si può, quando non si è
-interessati ad uno dei due, passare il valore \const{NULL} come argomento,
+interessati ad uno dei due, passare il valore \val{NULL} come argomento,
così che la corrispondente informazione non verrà richiesta. Infine l'ultimo
argomento \param{flags} è una maschera binaria i cui bit consentono di
impostare le modalità con cui viene eseguita la ricerca, e deve essere
server in ascolto su uno solo dei possibili diversi indirizzi presenti su di
una macchina. Se non si vuole che la funzione esegua \func{bind} su un
indirizzo specifico, ma utilizzi l'indirizzo generico, occorrerà avere cura di
-passare un valore \const{NULL} come valore per l'argomento \var{host}; l'uso
+passare un valore \val{NULL} come valore per l'argomento \var{host}; l'uso
del valore \const{AI\_PASSIVE} serve ad ottenere il valore generico nella
rispettiva struttura degli indirizzi.
poi l'opzione esprime una condizione logica, il valore è sempre un intero, ma
si dovrà usare un valore non nullo per abilitarla ed un valore nullo per
disabilitarla. Se invece l'opzione non prevede di dover ricevere nessun tipo
-di valore si deve impostare \param{optval} a \const{NULL}. Un piccolo numero
+di valore si deve impostare \param{optval} a \val{NULL}. Un piccolo numero
di opzioni però usano dei tipi di dati peculiari, è questo il motivo per cui
\param{optval} è stato definito come puntatore generico.
projects / gapil.git / blobdiff