.\" -*- coding: UTF-8 -*- .\" Copyright (c) 1986 The Regents of the University of California. .\" All rights reserved. .\" .\" %%%LICENSE_START(PERMISSIVE_MISC) .\" Redistribution and use in source and binary forms are permitted .\" provided that the above copyright notice and this paragraph are .\" duplicated in all such forms and that any documentation, .\" advertising materials, and other materials related to such .\" distribution and use acknowledge that the software was developed .\" by the University of California, Berkeley. The name of the .\" University may not be used to endorse or promote products derived .\" from this software without specific prior written permission. .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. .\" %%%LICENSE_END .\" .\" @(#)resolver.5 5.9 (Berkeley) 12/14/89 .\" $Id: resolver.5,v 8.6 1999/05/21 00:01:02 vixie Exp $ .\" .\" Added ndots remark by Bernhard R. Link - debian bug #182886 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH resolv.conf 5 "5 maja 2023 r." "Linux man\-pages 6.05.01" .UC 4 .SH NAZWA resolv.conf \- plik konfiguracyjny mechanizmu obsługi nazw (ang. resolver) .SH SKŁADNIA .nf \fB/etc/resolv.conf\fP .fi .SH OPIS Obsługa nazw (\fIresolver\fP) jest zbiorem funkcji biblioteki C, które umożliwiają dostęp do internetowego systemu serwerów nazw (DNS). Plik konfiguracyjny zawiera informacje, odczytywane przez procedury obsługi nazw podczas ich pierwszego wywołania przez proces, i jest czytelny zarówno dla maszyny, jak i dla człowieka. Zawiera listę słów kluczowych z wartościami, które udostępniają różne informacje dotyczące obsługi nazw. Plik konfiguracyjny jest uważany za zaufane źródło informacji DNS; więcej informacji w opisie opcji \fBtrust\-ad\fP. .PP Jeśli ten plik nie istnieje, to jedynym odpytywanym serwerem nazw jest wtedy ten z maszyny lokalnej, a lista przeszukiwań zawierająca nazwę lokalnej domeny jest konstruowana z nazwy komputera. .PP Opcje konfiguracji są następujące: .TP \fBnameserver\fP Adres IP serwera nazw. Adres internetowy serwera nazw, który powinien być odpytywany przez funkcje obsługi nazw albo jako adres IPv4 (w notacji kropkowej) lub jako adres IPv6 w notacji dwukropkowej (i być może kropkowej) zgodnie z RFC 2373. W pliku można podać maksymalnie \fBMAXNS\fP (obecnie 3, patrz \fI\fP) serwery nazw, po jednym przy słowie kluczowym. Jeśli jest kilka serwerów, biblioteka obsługi nazw odpytuje je w kolejności, w jakiej zostały wymienione. Jeśli nie ma żadnego wpisu \fBnameserver\fP, domyślnym zachowaniem jest korzystanie z serwera nazw na maszynie lokalnej. (Stosowany algorytm polega na próbie odpytania serwera nazw, a jeśli przekroczy ona czas oczekiwania, następuje próba odpytania następnego, aż zabraknie serwerów nazw. Następnie występuje ściśle określona liczba ponownych odpytań wszystkich serwerów nazw). .TP \fBsearch\fP Lista przeszukiwania nazw komputerów. By default, the search list contains one entry, the local domain name. It is determined from the local hostname returned by \fBgethostname\fP(2); the local domain name is taken to be everything after the first \[aq].\[aq]. Finally, if the hostname does not contain a \[aq].\[aq], the root domain is assumed as the local domain name. .IP .\" When having a resolv.conv with a line .\" search subdomain.domain.tld domain.tld .\" and doing a hostlookup, for example by .\" ping host.anothersubdomain .\" it sends dns-requests for .\" host.anothersubdomain. .\" host.anothersubdomain.subdomain.domain.tld. .\" host.anothersubdomain.domain.tld. .\" thus not only causing unnecessary traffic for the root-dns-servers .\" but broadcasting information to the outside and making man-in-the-middle .\" attacks possible. Można to zmienić, przez podanie żądanej ścieżki poszukiwania domeny po słowie kluczowym \fIsearch\fP, używając spacji lub tabulacji do oddzielenia nazw. Funkcje obsługi nazw dla zapytań zawierających w sobie mniej niż \fIndots\fP kropek (domyślnie \- 1) będą próbowały kolejnych składników ścieżki poszukiwania, aż do znalezienia. Dla środowisk z wieloma poddomenami, proszę przeczytać poniżej \fBoptions ndots:\fP\fIn\fP, aby uniknąć ataków typu man\-in\-the\-middle oraz niepotrzebnego odpytywania głównych serwerów nazw. Należy zauważyć, że proces ten może być powolny i powodować duże obciążenie sieci, jeśli serwery dla podanych domen nie są lokalne, a czas oczekiwania na odpowiedź po zapytaniu przekracza czas oczekiwania, gdy dla którejś z domen wszystkie serwery są niedostępne. .IP Jeśli występuje wiele wpisów \fBsearch\fP, użyta będzie wyłącznie lista przeszukiwań z ostatniego wpisu. .IP .\" glibc commit 3f853f22c87f0b671c0366eb290919719fa56c0e W glibc 2.25 i wcześniejszych, lista przeszukiwania jest ograniczona do sześciu domen z maksymalną liczbą 256 znaków. Od glibc 2.26 brak limitów listy przeszukiwania. .IP Opcja \fBdomain\fP jest przestarzałym odpowiednikiem listy przeszukiwania \fBsearch\fP, która obsługuje tylko pojedynczy wpis. .TP \fBsortlist\fP Umożliwia sortowanie adresów zwracanych przez \fBgethostbyname\fP(3). Lista sortowania jest podawana przez pary adresów IP i masek sieci. Maska sieci jest opcjonalna i domyślnie ma wartość naturalnej maski dla danej sieci. Adres IP jest oddzielany od maski sieci ukośnikiem. W polu tym można podawać do 10 par. Przykład: .IP .in +4n sortlist 130.155.160.0/255.255.240.0 130.155.0.0 .in .TP \fBoptions\fP Pole to umożliwia modyfikację pewnych wewnętrznych zmiennych funkcji obsługi nazw. Jego składnia to: .RS .IP \fBoptions\fP \fIopcja\fP \fI...\fP .PP gdzie \fIopcja\fP jest jedną z następujących: .TP \fBdebug\fP .\" Since glibc 2.2? Ustawia \fBRES_DEBUG\fP w \fI_res.options\fP (działa tylko gdy glibc został zbudowany z obsługą debugowania; zobacz \fBresolver\fP(3)). .TP \fBndots:\fP\fIn\fP .\" Since glibc 2.2 Ustawia próg liczby kropek, które muszą pojawić się w nazwie podanej do \fBres_query\fP (zobacz \fBresolver\fP(3)) przed wykonaniem \fIpoczątkowego absolutnego zapytania\fP. Domyślną wartością jest "1", co oznacza, że jeśli w nazwie znajdują się jakieś kropki, to powinna być najpierw sprawdzona jako nazwa absolutna, bez dokonywania żadnych podstawień listy poszukiwania. Maksymalną wartością jest 15, większe wartości zostaną zmniejszone, bez wypisywania żadnych ostrzeżeń. .TP \fBtimeout:\fP\fIn\fP .\" Since glibc 2.2 Ustawia czas, przez który funkcja obsługi nazw będzie czekać na odpowiedź ze zdalnego serwera nazw przed wysłaniem zapytania do innego serwera nazw. Może to \fBnie\fP być całkowity czas, jaki jaki zajmie wywołanie interfejsu obsługi nazw i brak gwarancji, że pojedyncze wywołanie odpowiada jednemu limitowi czasu. Wyrażony w sekundach, domyślnie \- \fBRES_TIMEOUT\fP (obecnie 5, patrz ). Maksymalną wartością jest 30, większe wartości zostaną zmniejszone, bez wypisywania żadnych ostrzeżeń. .TP \fBattempts:\fP\fIn\fP Ustawia liczbę prób wysyłania przez funkcję obsługi nazw zapytań do serwerów nazw przed poddaniem się i zwróceniem błędu. Domyślnie \- \fBRES_DFLRETRY\fP (obecnie 2, patrz ). Maksymalną wartością jest 5, większe wartości zostaną zmniejszone, bez wypisywania żadnych ostrzeżeń. .TP \fBrotate\fP .\" Since glibc 2.2 Ustawia \fBRES_ROTATE\fP w \fI_res.options\fP, powodując wybór serwera nazw spośród wymienionych serwerów za pomocą algorytmu round\-robin. Efektem tej opcji jest rozłożenie obciążenia zapytaniami wszystkich wymienionych serwerów nazw, zamiast odpytywania za każdym razem pierwszego z nich. .TP \fBno\-aaaa (since glibc 2.36)\fP .\" f282cdbe7f436c75864e5640a409a10485e9abb2 Sets \fBRES_NOAAAA\fP in \fI_res.options\fP, which suppresses AAAA queries made by the stub resolver, including AAAA lookups triggered by NSS\-based interfaces such as \fBgetaddrinfo\fP(3). Only DNS lookups are affected: IPv6 data in \fBhosts\fP(5) is still used, \fBgetaddrinfo\fP(3) with \fBAI_PASSIVE\fP will still produce IPv6 addresses, and configured IPv6 name servers are still used. To produce correct Name Error (NXDOMAIN) results, AAAA queries are translated to A queries. This option is intended preliminary for diagnostic purposes, to rule out that AAAA DNS queries have adverse impact. It is incompatible with EDNS0 usage and DNSSEC validation by applications. .TP \fBno\-check\-names\fP .\" since glibc 2.2 Ustawia \fBRES_NOCHECKNAME\fP w \fI_res.options\fP, co wyłącza sprawdzanie przez nowoczesne serwery BIND przychodzących nazw komputerów i nazw pocztowych pod kątem niepoprawnych znaków, takich jak podkreślenie (_), znaki nie\-ASCII lub znaki sterujące. .TP \fBinet6\fP .\" Since glibc 2.2 .\" b76e065991ec01299225d9da90a627ebe6c1ac97 Ustawia \fBRES_USE_INET6\fP w \fI_res.options\fP. Efektem tego jest próbowanie zapytań AAAA przed zapytaniami A wewnątrz funkcji \fIgethostbyname\fP(3) i mapowanie odpowiedzi IPv4 na "tunelowaną formę" IPv6, jeżeli znaleziono tylko rekordy A, bez rekordów AAAA. Od glibc 2.25 opcja ta jest przestarzała, aplikacje powinny korzystać z \fBgetaddrinfo\fP(3), zamiast z \fBgethostbyname\fP(3). .PP Niektóre programy zachowują się dziwacznie, jeśli ta opcja jest włączona. .TP \fBip6\-bytestring\fP (since glibc 2.3.4 to glibc 2.24) Ustawia \fBRES_USE_BSTRING\fP w \fI_res.options\fP. Powoduje to, że odwrotne wyszukiwania IPv6 będą używać formatu etykiet bitowych ("bit\-label") opisanego w RFC\ 2673. Jeśli ta opcja nie jest ustawiona (tak jest domyślnie), to będzie używany format półbajtowy. Opcja usunięta w glibc 2.25, ponieważ korzystała z niekompatybilnego wstecznie rozszerzenia DNS, które nigdy nie zostało zaimplementowane w Internecie. .TP \fBip6\-dotint\fP/\fBno\-ip6\-dotint\fP (glibc 2.3.4 to glibc 2.24) Clear/set \fBRES_NOIP6DOTINT\fP in \fI_res.options\fP. When this option is clear (\fBip6\-dotint\fP), reverse IPv6 lookups are made in the (deprecated) \fIip6.int\fP zone; when this option is set (\fBno\-ip6\-dotint\fP), reverse IPv6 lookups are made in the \fIip6.arpa\fP zone by default. These options are available up to glibc 2.24, where \fBno\-ip6\-dotint\fP is the default. Since \fBip6\-dotint\fP support long ago ceased to be available on the Internet, these options were removed in glibc 2.25. .TP \fBedns0\fP (od wersji 2.6 biblioteki glibc) Ustawia \fBRES_USE_EDNS0\fP w \fI_res.options\fP. Włącza to obsługę rozszerzeń DNS opisanych w RFC\ 2671. .TP \fBsingle\-request\fP (od wersji 2.10 biblioteki glibc) Sets \fBRES_SNGLKUP\fP in \fI_res.options\fP. By default, glibc performs IPv4 and IPv6 lookups in parallel since glibc 2.9. Some appliance DNS servers cannot handle these queries properly and make the requests time out. This option disables the behavior and makes glibc perform the IPv6 and IPv4 requests sequentially (at the cost of some slowdown of the resolving process). .TP \fBsingle\-request\-reopen\fP (od wersji 2.9 biblioteki glibc) Ustawia \fBRES_SNGLKUPREOP\fP w \fI_res.options\fP. Mechanizm rozwiązujący używa tych samych gniazd do żądań A i AAAA. Część rozwiązań sprzętowych nieprawidłowo odsyła pojedynczą odpowiedź. Gdy tak się stanie, klient systemowy poczeka na drugą odpowiedź. Włączenie tej opcji zmienia to zachowanie, dzięki czemu jeśli dwa żądania z tego samego portu nie są poprawnie obsługiwane, to nastąpi zamknięcie oraz otworzenie nowego gniazda przed wysłaniem drugiego żądania. .TP \fBno\-tld\-query\fP (od wersji 2.14 biblioteki glibc) Ustawia \fBRES_NOTLDQUERY\fP w \fI_res.options\fP. Ta opcja powoduje, że \fBres_nsearch\fP() nie próbuje rozwiązywać niejednoznacznej nazwy w sposób, jak gdyby była ona domeną najwyższego poziomu (ang. top level domain \- TLD). Ta opcja może powodować problemy, gdy strona jako TLD ma "localhost", zamiast umieścić "localhost" jako jeden z elementów listy wyszukiwania. Opcja nie działa, jeśli nie ustawiono ani RES_DEFNAMES, ani RES_DNSRCH. .TP \fBuse\-vc\fP (od wersji 2.14 biblioteki glibc) .\" aef16cc8a4c670036d45590877d411a97f01e0cd Ustawia \fBRES_USEVC\fP w \fI_res.options\fP. Wymusza użycie TCP do rozwiązywania nazw DNS. .TP \fBno\-reload\fP (od wersji 2.26 biblioteki glibc) Ustawia \fBRES_NORELOAD\fP w \fI_res.options\fP. Opcja wyłącza automatyczne przeładowanie zmienionego pliku konfiguracyjnego. .TP \fBtrust\-ad\fP (od wersji 2.31 biblioteki glibc) .\" 446997ff1433d33452b81dfa9e626b8dccf101a4 Ustawia \fBRES_TRUSTAD\fP w \fI_res.options\fP. Opcja kontroluje zachowanie bitu AD w minimalnym mechanizmie rozwiązującym nazwy (ang. stub resolver). Jeśli walidująca funkcja obsługi nazw ustawi bit AD w odpowiedzi, oznacza to że dane zawarte w odpowiedzi zostały zweryfikowane zgodnie z protokołem DNSSEC. Aby móc polegać na bicie AD, lokalny system musi ufać zarówno walidującej funkcji, jak i ścieżce sieciowej prowadzającej do niej \- co jest powodem konieczności jawnego włączenia tego ustawienia. Jeśli opcja \fBtrust\-ad\fP jest aktywna, minimalny mechanizm rozwiązujący nazwy ustawia bit AD w wychodzących zapytaniach DNS (aby włączyć obsługę bitu AD) i zachowuje go w odpowiedziach. Bez tej opcji, bit AD nie jest ustawiany w zapytaniach oraz jest zawsze usuwany z odpowiedzi, przed ich przekazaniem aplikacjom. Oznacza to, że aplikacje mogą zaufać bitowi AD w odpowiedziach, jeśli opcja \fBtrust\-ad\fP została prawidłowo ustawiona. .IP In glibc 2.30 and earlier, the AD is not set automatically in queries, and is passed through unchanged to applications in responses. .RE .PP Słowo kluczowe \fIsearch\fP systemowego \fIresolv.conf\fP można nadpisać dla danego procesu nadając zmiennej środowiskowej \fBLOCALDOMAIN\fP wartość będącą rozdzieloną spacjami listą domen poszukiwania. .PP Słowo kluczowe \fIoptions\fP systemowego \fIresolv.conf\fP można poprawić dla danego procesu nadając zmiennej środowiskowej \fBRES_OPTIONS\fP wartość będącą rozdzieloną spacjami listą opcji obsługi nazw (opcje opisano powyżej, pod hasłem \fBoptions\fP). .PP Słowo kluczowe i wartość muszą pojawiać się w tej samej linii oraz słowo kluczowe (np. \fBnameserver\fP) musi rozpoczynać linię. Wartość jest elementem następującym po słowie kluczowym i jest od niego oddzielona znakiem spacji lub tabulacji. .PP Linie zaczynające się od znaku średnika (";") lub hasha ("#") są traktowane jako komentarze. .SH PLIKI \fI/etc/resolv.conf,\fP \fI\fP .SH "ZOBACZ TAKŻE" \fBgethostbyname\fP(3), \fBresolver\fP(3), \fBhost.conf\fP(5), \fBhosts\fP(5), \fBnsswitch.conf\fP(5), \fBhostname\fP(7), \fBnamed\fP(8) .PP Name Server Operations Guide for BIND .PP .SH TŁUMACZENIE Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Przemek Borys , Robert Luberda i Michał Kułach . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .