.\" Copyright (c) 1983, 1990, 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. .\" .\" From: @(#) inet. 3 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/net/inet. 3, v 1.8. 2.8 2001/12/01 21:15:38 cjc Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/inet. 3, v 1.6 2002/05/18 07:12:55 horikawa Exp $ .\" .Dd June 17, 1996 .Dt INET 3 .Os .Sh 명칭 .Nm inet_aton , .Nm inet_addr , .Nm inet_network , .Nm inet_ntoa , .Nm inet_ntop , .Nm inet_pton , .Nm inet_makeaddr , .Nm inet_lnaof , .Nm inet_netof .Nd 인터넷 주소 조작 함수 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/types.h .In sys/socket.h .In netinet/in.h .In arpa/inet.h .Ft int .Fn inet_aton "const char *cp" "struct in_addr *pin" .Ft unsigned long .Fn inet_addr "const char *cp" .Ft unsigned long .Fn inet_network "const char *cp" .Ft char * .Fn inet_ntoa "struct in_addr in" .Ft const char * .Fn inet_ntop "int af" "const void *src" "char *dst" "size_t size" .Ft int .Fn inet_pton "int af" "const char *src" "void *dst" .Ft struct in_addr .Fn inet_makeaddr "unsigned long net" "unsigned long lna" .Ft unsigned long .Fn inet_lnaof "struct in_addr in" .Ft unsigned long .Fn inet_netof "struct in_addr in" .Sh 해설 .Fn inet_aton , .Fn inet_addr 및 .Fn inet_network routine는, 인터넷 표준의 .Ql . \& 표기법으로 나타나는 수치를 표현하고 있는 캐릭터 라인을 해석합니다. .Pp .Fn inet_pton 함수는, 표시 형식의 주소 (즉 캐릭터 라인으로 보관 유지되고 있는 인자 가능한 형식)로부터 네트워크 형식 (통상 .Ft struct in_addr 혹은 다른 내부적인 바이너리 표현 형식에서, 네트워크 바이트 오더)에의 변환을 실시합니다. 이 함수는, 지정된 주소 패밀리에 있어, 주소가 유효한 것이면 1 을 돌려주어, 퍼스 할 수 없으면 0 을 돌려줍니다. 또 시스템 우류가 발생했을 때 (이 경우는 .Va errno 하지만 설정됩니다)에는,-1 을 돌려줍니다. 이 함수는 현재 .Dv AF_INET (와)과 .Dv AF_INET6 에 대해서 유효합니다. .Pp .Fn inet_aton routine는, 지정된 캐릭터 라인을 인터넷 주소로서 해석해, 주어진 구조체안에 주소를 설정합니다. 캐릭터 라인이 정상적으로 해석되면(자) 동routine는 1 을 돌려주어, 캐릭터 라인이 무효 때 0 을 돌려줍니다. .Fn inet_addr (와)과 .Fn inet_network 함수는 각각, 인터넷 주소와 인터넷 네트워크 번호로서 사용하는데 적합한 수치를 돌려줍니다. .Pp .Fn inet_ntop 함수는, 네트워크 형식 (통상 .Ft struct in_addr 혹은 다른 내부적인 바이너리 형식에서, 네트워크 바이트 오더)로부터 표시 형식 (외부에 표시하는데 적합한 형식)에의 변환을 실시합니다. 이 함수는, 시스템 우류가 발생했을 때 (이 경우는 .Va errno 하지만 설정됩니다)에는 눌을 돌려주어, 그 이외때는 목적의 캐릭터 라인에의 포인터를 돌려줍니다. 이 함수는 현재 .Dv AF_INET (와)과 .Dv AF_INET6 에 대해서 유효합니다. .Pp .Fn inet_ntoa routine는, 인터넷 주소를 받아 .Ql . \& 표기법의 주소를 나타낸다 .Tn ASCII 캐릭터 라인을 돌려줍니다. .Fn inet_makeaddr routine는 인터넷 네트워크 번호와 로컬 네트워크 주소를 받아, 그것을 기본으로 해 인터넷 주소를 생성합니다. .Fn inet_netof (와)과 .Fn inet_lnaof routine는 인터넷 호스트 주소를 분할해, 각각 네트워크 번호와 로컬 네트워크 주소부로서 돌려줍니다. .Pp 모든 인터넷 주소는 네트워크 오더 (왼쪽에서 오른쪽에의 바이트순서)로 돌려주어집니다. 네트워크 번호와 로컬 주소부는 모두 머신 형식의 정수치로 돌려주어집니다. .Pp .Sh 인터넷 주소 .Ql . \& 표기법으로 지정되는 값은 다음의 어떤 것인가 하나의 형식을 취합니다. .Bd -literal -offset indent a.b.c.d a.b.c a.b a .Ed .Pp 4 개의 부분 주소가 지정되면(자), 각 부분은 1 바이트의 데이터라고 해석되어, 왼쪽에서 오른쪽의 순서로 인터넷 주소의 4 바이트에 할당할 수 있습니다. 인터넷 주소가 .Tn VAX 위에서 32 비트의 정수치이다고 보여질 때, 상기에 해당하는 바이트는, .Dq Li d.c.b.a (이)라고 표시되는 것에 주의해 주세요. 즉, .Tn VAX 의 바이트 오더는 오른쪽에서 왼쪽의 순서가 됩니다. .Pp 3 개의 부분 주소가 지정되면(자), 마지막 부분이 16 비트치라고 해석되어, 네트워크 주소의 우단의 2 바이트가 됩니다. 이것에 의해 3 개의 부분 주소 형식에서 Class B 네트워크 주소를 .Dq Li 128.net.host (와)과 지정할 수 있어 편리합니다. .Pp 2 개의 부분 주소가 주어지면(자), 마지막 부분 주소가 24 비트치로서 해석되어, 네트워크 주소의 우단의 3 바이트가 됩니다. 이것에 의해 2 개의 부분 주소 형식에서 Class A 네트워크 주소를 .Dq Li net.host (와)과 지정할 수 있어 편리합니다. .Pp 1 개의 부분 주소만 지정되면(자), 값은 바이트의 재조정없이 직접 네트워크 주소에 보존됩니다. .Pp .Ql . \& 표기법으로 .Dq 부분 (으)로서 공급되는 수치는 모두, C 언어로 지정되는 10 진수, 8 진수, 16 진수의 몇개의 형식을 취할 수가 있습니다 (즉, 선행의 0x 또는 0X 는 16 진수를 의미해, 선행하는 0 은 8 진수를 의미해, 수치는 10 진수라고 해석됩니다) . .Pp .Fn inet_aton (와)과 .Fn inet_ntoa 함수는 약간 피해야 할 함수로, 오히려 .Xr addr2ascii 3 패밀리가 사용됩니다. 그러나, 이러한 함수는 아직 넓게 실장되어 있지 않기 때문에, 당면, 이식성이 있는 프로그램은 이러한 함수에 의존하지 못하고, .Xr inet 3 함수가 계속 사용되겠지요. .Sh 진단 .Fn inet_addr (와)과 .Fn inet_network (은)는 형식 위반의 요구에 대해 .Dv INADDR_NONE 정수를 돌려줍니다. .Sh 관련 항목 .Xr addr2ascii 3 , .Xr gethostbyname 3 , .Xr getnetent 3 , .Xr hosts 5 , .Xr networks 5 .Rs . %R RFC . %N 2373 . %D July 1998 . %T "IP Version 6 Addressing Architecture" .Re .Sh 표준 .Fn inet_ntop (와)과 .Fn inet_pton 함수는, .St -xns5. 2 에 적합하고 있습니다. .Fn inet_pton 함수는, 1 개, 2 개 혹은 3 개의 닷 형식의 주소에는 대응하고 있지 않는 것에 주의해 주세요. 주소는 4 개로 나누어, 10 진수로 지정하지 않으면 안됩니다. 이것은 .Fn inet_aton 함수가 받을 수 있는 입력 세트보다 좁은 것입니다. .Sh 역사 이러한 함수는 .Bx 4.2 그리고 등장했습니다. .Pp .Sh 버그 .Dv INADDR_NONE (0xffffffff) 값은 유효한 브로드캐스트 어드레스입니다만, .Fn inet_addr (은)는 이 값을 돌려줄 때에 실패를 나타내 버립니다. 새롭다 .Fn inet_aton 함수에서는, 이 문제는 해결되고 있습니다. 호스트 바이트 오더대 네트워크 아르바이트 오더의 문제는 혼란하기 쉽상입니다. .Fn inet_ntoa 하지만 돌려주는 캐릭터 라인은 정적 메모리 area에 거둘 수 있습니다. .Pp inet_addr 는 .Fa struct in_addr (을)를 돌려줄 필요가 있습니다.