Sous-routine gethostent

Objectif

Extrait une entrée d'hôte de réseau.

Bibliothèque

Standard C Library (libc.a)
(libbind)
(libnis)
(liblocal)

Syntaxe

#include <netdb.h>
 
struct hostent *gethostent ()

Descriptif

La sous-routine gethostent admet les unités d'exécution multiples. Cependant, la valeur de retour pointe vers des données statiques qui sont écrasées par les appels suivants. Ces données doivent être copiées pour être sauvegardées en vue de leur utilisation par les appels suivants.

Lors de l'utilisation de la résolution de service de nom DNS/BIND, la sous-routine gethostent n'est pas définie.

Lors de l'utilisation de la résolution de service annuaire NIS ou de la recherche dans le fichier /etc/hosts local, la sous-routine gethostent lit la ligne suivante du fichier /etc/hosts , ouvrir le fichier si nécessaire.

Le sous-programme gethostent renvoie un pointeur vers une structure hostent , qui contient les zones équivalentes pour une ligne de description d'hôte dans le fichier /etc/hosts . La structure hostent est définie dans le fichier netdb.h .

Valeurs renvoyées

Une fois l'opération terminée, la sous-routine gethostent renvoie un pointeur vers une structure hostent .

Si une erreur se produit ou que la fin du fichier est atteinte, la sous-routine gethostent renvoie un pointeur null.

Fichiers