options option ...

où option est une des options suivantes :

debug

Définition de RES_DEBUG dans _res.options (effectif uniquement si la glibc a été construite avec la prise en charge du débogage ; consulter resolver(3)).

ndots:n

Définition d’un seuil pour le nombre de points qui doivent apparaître dans un nom fourni à res_query(3) (consulter resolver(3)) avant qu'une requête absolue initiale soit entreprise. La valeur par défaut pour n est 1, ce qui signifie que dès qu'un point apparaît dans un nom, ce dernier sera d'abord essayé en tant que nom absolu avant d'ajouter tout élément de la liste de recherche search. La valeur de cette option est silencieusement plafonnée à 15.

timeout:n

Définition du temps pendant lequel la bibliothèque de résolution attendra la réponse d'un serveur de noms distant avant de réessayer une requête sur un serveur de noms différent. Cela peut ne pas être le temps total pris par n’importe quel appel d’API de résolution et il n’y a aucune garantie qu’un seul appel corresponde à un seul délai. Exprimée en secondes, la valeur par défaut est RES_TIMEOUT (actuellement 5, voir <resolv.h>). La valeur de cette option est plafonnée silencieusement à 30.

attempts:n

Définition du nombre de fois que la bibliothèque de résolution enverra une requête à ses serveurs de noms avant d'abandonner et renvoyer une erreur à l'application appelante. La valeur par défaut est RES_DFLRETRY (actuellement 2, voir <resolv.h>). La valeur de cette option est silencieusement plafonnée à 5.

rotate

Définition de RES_ROTATE dans _res.options, ce qui provoque une sélection en tourniquet des serveurs de noms parmi ceux qui sont listés. Cela a pour effet de répartir la charge de la requête parmi tous les serveurs listés en évitant que tous les clients essayent à chaque fois le premier serveur listé.

no-aaaa (depuis la glibc 2.36)

Définition de RES_NOAAAA dans _res.options, ce qui supprime les requêtes AAAA faites par le « stub resolver », y compris les requêtes déclenchées par les interfaces basées sur NSS telles que getaddrinfo(3). Seules les recherches de DNS sont affectées : les données IPv6 dans hosts(5) sont encore utilisées, getaddrinfo(3) avec AI_PASSIVE produira encore des adresses IPv6 et les serveurs de noms IPv6 configurés seront toujours utilisés. Pour produire des résultats d'erreur de nom corrects (NXDOMAIN), les requêtes AAAA sont traduites en requêtes A. Cette option est destinée en premier lieu à des diagnostics pour éliminer le fait que les requêtes de DNS AAAA ont un impact inverse. Elle est incompatible avec l'utilisation de EDNS0 et la validation DNSSEC par les applications.

no-check-names

Définition de RES_NOCHECKNAME dans _res.options, ce qui désactive la vérification BIND moderne des noms d'hôtes et de courriers entrants pour les caractères non autorisés comme le caractère de soulignement « _ », les caractères non ASCII ou les caractères de contrôle.

inet6

Définition de RES_USE_INET6 dans _res.options. Cela a pour effet d'essayer une requête AAAA avant une requête A dans la fonction gethostbyname(3), et le mappage des réponses IPv4 dans la « forme tunnellisée » d’IPv6 si aucun enregistrement AAAA n'est trouvé alors qu'un ensemble d’enregistrements A existe. Depuis la glibc 2.25, cette option est obsolète. Les applications doivent utiliser getaddrinfo(3) plutôt que gethostbyname(3).

ip6-bytestring (glibc 2.3.4 à glibc 2.24)

Définition de RES_USE_BSTRING dans _res.options. Cela implique que les recherches IPv6 inverses sont effectuées avec le format d’étiquette binaire décrit dans la RFC 2673. Si cette option n'est pas activée (réglage par défaut), le format nibble est utilisé. Cette option a été retirée depuis la glibc 2.25, puisqu’elle repose sur une extension DNS non rétro-compatible n’ayant jamais été déployée dans l’Internet.

ip6-dotint/no-ip6-dotint (glibc 2.3.4 à glibc 2.24)

Activation ou désactivation de RES_NOIP6DOTINT dans _res.options. Quand cette option est désactivée (ip6-dotint), les recherches inverses IPv6 sont effectuées dans la zone (obsolète) ip6.int ; quand cette option est activée ((no-ip6-dotint), les recherches inverses IPv6 sont effectuées par défaut dans la zone ip6.arpa. Puisque la prise en charge de ip6-dotint a cessé depuis longtemps dans l’Internet, ces options ont été retirées dans la glibc 2.25.

edns0 (depuis la glibc 2.6)

Définition de RES_USE_EDNSO dans _res.options. Cela active la prise en charge des extensions DNS décrites dans la RFC 2671.

single-request (depuis la glibc 2.10)

Définition de RES_SNGLKUP dans _res.options. Par défaut, la glibc réalise des recherches IPv4 et IPv6 en parallèle depuis sa version 2.9. Certains serveurs DNS d’équipement dédié ne peuvent pas traiter correctement ces demandes et font expirer les requêtes. Cette option désactive ce comportement et force la glibc à réaliser les requêtes IPv4 et IPv6 de façon séquentielle (au prix de quelques ralentissements du processus de résolution).

single-request-reopen (depuis la glibc 2.9)

Définition de RES_SNGLKUPREOP dans _res.options. La bibliothèque de résolution utilise le même socket pour les requêtes A et AAAA. Certains matériels ne renvoient par erreur qu'une seule réponse. Quand cela arrive, le système client est bloqué en attendant la deuxième réponse. Activer cette option modifie le comportement de telle façon qu’en cas de traitement incorrect de deux requêtes venant du même port, le socket sera fermé et un nouveau sera ouvert avant d'envoyer la deuxième requête.

no-tld-query (depuis la glibc 2.14)

Définition de RES_NOTLDQUERY dans _res.options. Cette option fait que res_nsearch() n’essaie pas de résoudre un nom non qualifié comme s’il était un domaine de premier niveau (top level domain — TLD). Cette option peut causer des problèmes si le site a « localhost » comme TLD plutôt que d’avoir localhost dans un ou plus éléments dans la liste de recherche. Cette option n’a aucun effet si ni RES_DEFNAMES ni RES_DNSRCH ne sont définis.

use-vc (depuis la glibc 2.14)

Définition de RES_USE_EDNSO dans _res.options. Cette option oblige l’utilisation de TCP dans la résolution DNS.

no-reload (depuis la glibc 2.26)

Définition de RES_USE_EDNSO dans _res.options. Cette option désactive le rechargement automatique d’un fichier de configuration modifié.

trust-ad (depuis la glibc 2.31)

Définition de RES_TRUSTAD dans _res.options. Cette option contrôle le comportement du bit AD (authenticated data) du « stub resolver ». Si un résolveur de validation définit un bit AD dans une réponse, il indique que les données dans cette réponse ont été vérifiées selon le protocole DNSSEC. Pour pouvoir se fier au bit AD, le système local doit faire confiance à la fois au résolveur de validation DNSSEC et au chemin réseau vers celui-ci, ce qui est la raison pour laquelle une option d’inclusion explicite est nécessaire. Si l’option trust-ad est active, le « stub resolver » définit le bit AD dans les requêtes DNS sortantes (pour activer la prise en charge du bit AD) et préserve le bit AD dans les réponses. Sans cette option, le bit AD n’est pas défini dans les requêtes et est toujours supprimé des réponses avant qu’elles ne soient renvoyées à l’application. Cela signifie que les applications peuvent faire confiance au bit AD dans les réponses si l’option trust-ad a été définie correctement.

Dans la glibc 2.30 et ses versions précédentes, le bit AD n’est pas défini automatiquement dans les requêtes et est répercuté inchangé aux applications dans les réponses.