.\" Copyright (c) 1995 .\" Bill Paul . 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 Bill Paul. .\" 4. Neither the name of the author nor the names of any co-contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY Bill Paul 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. .\" .\" %FreeBSD: src/lib/libc/net/ethers. 3, v 1.10. 2.10 2001/12/14 18:33:55 ru Exp % .\" $FreeBSD: doc/ja_JP.eucJP/man/man3/ethers. 3, v 1.6 2002/05/18 07:12:54 horikawa Exp $ .\" .Dd April 12, 1995 .Dt ETHERS 3 .Os .Sh 명칭 .Nm ethers , .Nm ether_line , .Nm ether_aton , .Nm ether_ntoa , .Nm ether_ntohost , .Nm ether_hostton .Nd 이더넷 어드레스 변환 및 조사 routine .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/types.h .In sys/socket.h .In net/ethernet.h .Ft int .Fn ether_line "const char *l" "struct ether_addr *e" "char *hostname" .Ft struct ether_addr * .Fn ether_aton "const char *a" .Ft char * .Fn ether_ntoa "const struct ether_addr *n" .Ft int .Fn ether_ntohost "char *hostname" "const struct ether_addr *e" .Ft int .Fn ether_hostton "const char *hostname" "struct ether_addr *e" .Sh 해설 이러한 함수는, .Ar ether_addr 구조체를 사용해 이더넷 어드레스를 조작합니다. 이 구조체는 헤더 파일 .Aq Pa netinet/if_ether.h 에 정의되고 있습니다. .Bd -literal -offset indent /* * 이더넷(ethernet)(MAC) 주소의 바이트수 */ #define ETHER_ADDR_LEN 6 /* * 48 비트 이더넷 어드레스의 구조체 */ struct ether_addr { u_char octet[ETHER_ADDR_LEN]; }; .Ed .Pp .Fn ether_line 함수는, .Xr ethers 5 형식의 .Tn ASCII 캐릭터 라인이다 .Ar l (을)를 주사 해, 캐릭터 라인으로 지정된 이더넷 어드레스를 .Ar e (으)로 설정해, 호스트명을 .Ar h (으)로 설정합니다. 이 함수는, .Pa /etc/ethers 의 행을 그 구성 부분에 퍼스 하는데 사용됩니다. .Pp .Fn ether_aton 함수는, 이더넷 어드레스의 .Tn ASCII 표현을 .Ar ether_addr 구조체로 변환합니다. 같이 .Fn ether_ntoa (은)는, .Ar ether_addr 구조체로서 지정된 이더넷 어드레스를 .Tn ASCII 캐릭터 라인으로 변환합니다. .Pp .Fn ether_ntohost 함수와 .Fn ether_hostton 함수는, 이더넷 어드레스를 .Pa /etc/ethers 데이타베이스로 지정된 대응하는 호스트명에 MAP 합니다. .Fn ether_ntohost (은)는, 이더넷 어드레스로부터 호스트명에의 변환을 실시해, .Fn ether_hostton (은)는, 호스트명으로부터 이더넷 어드레스에의 변환을 실시합니다. .Sh 반환값 .Fn ether_line (은)는, 처리가 성공하면(자) 0 을 돌려줍니다. 주어진 행 .Ar l 의 일부에서도 퍼스 할 수 없었던 경우는 0 이 아닌 값을 돌려줍니다. 추출된 이더넷 어드레스가 주어졌다 .Ar ether_addr 구조체 .Ar e 에 돌려주어, 호스트명이 주어진 캐릭터 라인 .Ar h 에 돌려줍니다. .Pp .Fn ether_ntoa (은)는, 처리가 성공하면(자) 이더넷 어드레스의 .Tn ASCII 표현이 들어간 캐릭터 라인에의 포인터를 돌려줍니다. 주어졌다 .Ar ether_addr 구조체를 변환할 수 없었던 경우는, .Dv NULL 포인터를 돌려줍니다. 똑같이, .Fn ether_aton (은)는 성공하면(자) .Ar ether_addr 구조체에의 포인터를 돌려주어, 실패하면(자) .Dv NULL 포인터를 돌려줍니다. .Pp .Fn ether_ntohost 함수와 .Fn ether_hostton 함수는 양쪽 모두, 성공했을 경우는 0 을 돌려주어, .Pa /etc/ethers 데이타베이스내에 일치하는 것을 찾아낼 수 없었던 경우는 0 이 아닌 값을 돌려줍니다. .Sh 주 유저는, .Fn ether_line , .Fn ether_ntohost 및 .Fn ether_hostton 의 각 함수에게 건네지는 호스트 명문자열이, 돌려주어진 호스트명을 넣을 수 있을 만큼 큰 일을 프로텍션할 필요가 있습니다. .Sh NIS 상호작용 .Pa /etc/ethers 의 안에 1 개의 것 + 이 들어간 행이 있는 경우, .Fn ether_ntohost 함수와 .Fn ether_hostton 함수는, .Pa /etc/ethers 파일내의 데이터에 가세해, NIS .Pa ethers.byname 및 .Pa ethers.byaddr MAP를 조사하려고 합니다. .Sh 관련 항목 .Xr yp 4 , .Xr ethers 5 .Sh 버그 .Fn ether_aton 함수와 .Fn ether_ntoa 함수는, 이것들이 다음에 불려 갔을 때에는 덧쓰기될 가능성이 있는 정적 메모리 area에 보존된 값을 돌려줍니다. .Sh 역사 .Nm 프로그램 라이브러리 함수의 이 실장은, .Fx 2.1 (을)를 위해서(때문에) 작성되어 등장했습니다.