.\" Copyright (c) 1985, 1991, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) resolver. 3 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/net/resolver. 3, v 1.11. 2.7 2001/12/14 18:33:55 ru Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/resolver. 3, v 1.5 2002/05/18 07:12:56 horikawa Exp $ .\" .Dd June 4, 1993 .Dt RESOLVER 3 .Os .Sh 명칭 .Nm res_query , .Nm res_search , .Nm res_mkquery , .Nm res_send , .Nm res_init , .Nm dn_comp , .Nm dn_expand .Nd resolver routine .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/types.h .In netinet/in.h .In arpa/nameser.h .In resolv.h .Ft int .Fo res_query .Fa "const char *dname" .Fa "int class" .Fa "int type" .Fa "u_char *answer" .Fa "int anslen" .Fc .Ft int .Fo res_search .Fa "const char *dname" .Fa "int class" .Fa "int type" .Fa "u_char *answer" .Fa "int anslen" .Fc .Ft int .Fo res_mkquery .Fa "int op" .Fa "const char *dname" .Fa "int class" .Fa "int type" .Fa "const u_char *data" .Fa "int datalen" .Fa "const u_char *newrr_in" .Fa "u_char *buf" .Fa "int buflen" .Fc .Ft int .Fo res_send .Fa "const u_char *msg" .Fa "int msglen" .Fa "u_char *answer" .Fa "int anslen" .Fc .Ft int .Fn res_init .Fo dn_comp .Fa "const char *exp_dn" .Fa "u_char *comp_dn" .Fa "int length" .Fa "u_char **dnptrs" .Fa "u_char **lastdnptr" .Fc .Ft int .Fo dn_expand .Fa "const u_char *msg" .Fa "const u_char *eomorig" .Fa "const u_char *comp_dn" .Fa "char *exp_dn" .Fa "int length" .Fc .Sh 해설 이러한 routine는, 인터넷 도메인 네임서버를 사용해, 문의와 응답 메세지의 작성, 송신, 해석을 실시합니다. .Pp resolver routine가 사용하는 글로벌인 설정과 상태의 정보는, 구조체 .Em _res 에 보존됩니다. 대부분의 값은, 적절한 기본값이 되어 있으므로 무시할 수 있습니다. .Em _res.options 에 보존되는 옵션은, .Pa resolv.h 그리고 이하와 같이 정의되고 있습니다. 옵션은, 유효한 옵션의 비트 논리합을 취한, 단순한 비트 마스크로서 보존되고 있습니다. .Bl -tag -width RES_USE_INET6 .It Dv RES_INIT 초기 네임서버 주소와 디폴트 도메인명이 초기화되고 있는 경우는 진입니다 ( .Fn res_init 하지만 불려 갔을 경우 등). .It Dv RES_DEBUG 디버그 메세지를 출력합니다. .It Dv RES_AAONLY 신뢰할 수 있는 응답만을 받아들입니다. 이 옵션을 사용했을 경우, 신뢰할 수 있는 응답이나 에러가 발견될 때까지 .Fn res_send (을)를 계속할 필요가 있습니다. 현재로서는, 이것은 실장되고 있지 않습니다. .It Dv RES_USEVC UDP 데이터 그램 대신에 .Tn TCP 접속을 문의해에 사용합니다. .It Dv RES_STAYOPEN .Dv RES_USEVC (와)과 함께 사용해, 문의와 문의의 사이도 .Tn TCP 접속을 연 채로에 유지합니다. 많은 문의를 정기적으로 실시하는 프로그램만으로 편리합니다. 통상의 사용에는 .Tn UDP (을)를 사용해야 합니다. .It Dv RES_IGNTC 현재는 사용되지 않습니다 (트란케이션에라를 무시합니다, 즉, .Tn TCP 그리고 재시행하지 않습니다). .It Dv RES_RECURSE 문의의 반복 요구 비트를 설정합니다. 이것이 디폴트입니다 ( .Fn res_send (은)는 반복 문의를 행하지 않고, 네임서버가 반복을 처리하는 것을 기대합니다). .It Dv RES_DEFNAMES 설정하면(자), .Fn res_search 하지만 싱글 컴퍼넌트명 (닷을 포함하지 않는 이름)에 디폴트의 도메인명을 추가하게 됩니다. 이 옵션은 디폴트로 유효하게 되어 있습니다. .It Dv RES_DNSRCH 이 옵션을 설정하면(자), .Fn res_search 하지만, 현재의 도메인과 친도메인으로 호스트명을 검색하게 됩니다. .Xr hostname 7 (을)를 참조해 주세요. 이것은, 표준 호스트 검색 routine .Xr gethostbyname 3 에 의해 사용됩니다. 이 옵션은 디폴트로 유효하게 되어 있습니다. .It Dv NOALIASES 이 옵션은, .Dq Ev HOSTALIASES 환경 변수에 의해 제어되는 유저 레벨의 앨리어싱(aliasing) 기능을 무효로 합니다. 네트워크 demon에서는, 이 옵션을 설정할 필요가 있습니다. .It Dv RES_USE_INET6 IPv6 만의 어플리케이션의 서포트를 유효하게 합니다. IPv4 주소는 IPv4 투영 주소로서 돌려주어지게 됩니다. 예를 들어, .Li 10.1. 1.1 하 .Li ::ffff:10. 1.1. 1 (와)과 같이 돌려주어집니다. 이 옵션은, 특정의 커널 configuration의 경우에만 의미가 있습니다. .It Dv RES_USE_EDNS0 EDNS0 확장의 OPT pseudo-RR 의 서포트를 유효하게 합니다. 이 옵션에 의해, resolver 코드는 DNS 문의에 OPT pseudo-RR 를 더해, 이쪽의 수취 버퍼의 크기를 통지합니다. 이 옵션에 의해, DNS 서버는 디폴트가 아닌 크기의 수취 버퍼를 이용할 수 있으므로, 보다 큰 응답을 보낼 수가 있게 됩니다. EDNS0 확장된 DNS 문의 패킷은 비 EDNS0 DNS 서버란 호환성이 없습니다. .El .Pp .Fn res_init routine는, 설정 파일을 읽어들여 (설정 파일이 존재하는 경우. .Xr resolver 5 참조), 디폴트 도메인명, 검색 리스트, 로컬 네임서버의 인터넷 주소를 입수합니다. 서버가 설정되어 있지 않은 경우는, resolver를 실행하고 있는 호스트가 시험 받습니다. 현재의 도메인명은, 설정 파일로 지정되어 있지 않은 경우, 호스트명으로 정의됩니다만, 환경 변수 .Ev LOCALDOMAIN 그리고 덧쓰기할 수도 있습니다. 검색 리스트를 프로세스 마다 덧쓰기하는 경우는, 공백에서 단락지어진 복수의 토큰을 이 환경 변수에 포함합니다. 이것은, 설정 파일의 .Em search 명령을 닮아 있습니다. 다른 환경 변수 .Dq Ev RES_OPTIONS (을)를 설정하면, 특정의 내부 resolver 옵션을 덧쓰기할 수 있습니다. 내부 resolver 옵션은, 덧쓰기되지 않으면, .Em _res 구조체의 필드를 변경하는 것으로 설정되는지, 설정 파일의 .Em options 명령로부터 계승됩니다. .Dq Ev RES_OPTIONS 환경 변수의 문장구조법에 대해서는, .Xr resolver 5 (을)를 참조해 주세요. 통상의 경우, 초기화는 이하의 routine를 처음으로 호출했을 때에 실행됩니다. .Pp .Fn res_query 함수는, 서버 문의 메카니즘의 인터페이스를 제공하는 것으로, 문의의 작성, 작성된 문의의 로컬 서버에의 송신, 응답의 대기, 응답의 예비 체크를 실시합니다. 문의는, 완전한 형태에서의 도메인명 .Fa dname 에 대한, 지정되었다 .Fa type (와)과 .Fa class 의 정보를 요구합니다. 응답 메세지는 .Fa answer 버퍼에 남겨져 호출측이 지정한다 .Fa anslen 의 길이가 되어 있습니다. .Pp .Fn res_search routine는, .Fn res_query (와)과 같이 문의의 작성과 응답의 대기를 실시합니다만, 거기에 더해 .Dv RES_DEFNAMES (와)과 .Dv RES_DNSRCH 옵션에 의해 제어되는 디폴트와 검색 규칙도 실장하고 있습니다. 이 routine는 최초로 성공한 응답을 돌려줍니다. .Pp 나머지의 routine는, .Fn res_query 하지만 사용하는 저레벨 routine입니다. .Fn res_mkquery 함수는, 표준 문의 메세지를 작성해 .Fa buf 에 배치해, 문의의 사이즈를 돌려줍니다. 문의가 .Fa buflen 보다 긴 경우는 -1 을 돌려줍니다. 문의 타입 .Fa op (은)는, 통상의 경우 .Dv QUERY 그렇지만, .Aq Pa arpa/nameser.h 그리고 정의되고 있는 어느 문의 타입에도 할 수 있습니다. 문의의 도메인명은 .Fa dname 그리고 지정합니다. .Fa newrr (은)는 현재 사용되고 있지 않습니다만, 갱신 메세지를 작성하기 위한의 것입니다. .Pp .Fn res_send routine는, 사전 포맷 끝나 문의를 송신해, 응답을 돌려줍니다. .Dv RES_INIT 하지만 설정되어 있지 않은 경우는 .Fn res_init (을)를 호출합니다. 로컬 네임서버에의 문의의 송신, 및 타임 아웃과 재시행의 처리도 실시합니다. 응답 메세지의 길이를 돌려줍니다만, 에러가 있었을 경우는 -1 을 돌려줍니다. .Pp .Fn dn_comp 함수는, 도메인명 .Fa exp_dn (을)를 압축해, .Fa comp_dn 에 보존합니다. 압축된 이름의 사이즈를 돌려줍니다만, 에러가 있었을 경우는 -1 을 돌려줍니다. .Fa comp_dn 하지만 가리키는 배열의 사이즈는 .Fa length 그리고 지정합니다. 압축때, 현재의 메세지로 그때까지 압축된 이름을 가리키는 포인터 .Fa dnptrs 의 배열을 사용합니다. 최초의 포인터는 메세지의 최초를 가리켜, 리스트는 .Dv NULL 그리고 끝납니다. 배열의 제한은 .Fa lastdnptr 그리고 지정합니다. .Fn dn_comp 의 부작용은, 이름이 압축되었을 때에 메세지에 삽입되는 label의 포인터의 리스트가 갱신되는 것입니다. .Em dnptr 하지만 .Dv NULL 인 경우, 이름은 압축되지 않습니다. .Fa lastdnptr 하지만 .Dv NULL 인 경우, label의 리스트는 갱신되지 않습니다. .Pp .Fn dn_expand 엔트리는, 압축된 도메인명 .Fa comp_dn (을)를 완전한 도메인명에 전개합니다. 압축된 이름은, 문의하고 혹은 응답 메세지에 포함됩니다. .Fa msg (은)는, 메세지의 최초를 가리키는 포인터입니다. 전개된 이름은, .Fa exp_dn 하지만 가리키는 사이즈 .Fa length 의 버퍼에 배치됩니다. 압축된 이름의 사이즈가 돌려주어집니다만, 에러가 있었을 경우는 -1 이 돌려주어집니다. .Sh 관련 파일 .Bl -tag -width /etc/resolv.conf .It Pa /etc/resolv.conf 설정 파일. .Xr resolver 5 (을)를 참조. .El .Sh 관련 항목 .Xr gethostbyname 3 , .Xr resolver 5 , .Xr hostname 7 , .Xr named 8 .Pp . %T RFC1032 , . %T RFC1033 , . %T RFC1034 , . %T RFC1035 , . %T RFC974 .Rs . %T "Name Server Operations Guide for BIND" .Re .Sh 역사 .Fn res_query 함수는 .Bx 4.3 그리고 등장했습니다.