.\" Copyright (c) 1983, 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.
.\"
.\"     @(#) readlink. 2	8.1 (Berkeley) 6/4/93
.\" %FreeBSD: src/lib/libc/sys/readlink. 2, v 1.7. 2.4 2001/12/14 18:34:01 ru Exp %
.\"
.\" $FreeBSD: doc/ja_JP.eucJP/man/man2/readlink. 2, v 1.7 2001/12/23 00:03:42 horikawa Exp $
.Dd June 4, 1993
.Dt READLINK 2
.Os
.Sh 명칭
.Nm readlink
.Nd 기호 연결의 값을 독해
.Sh 프로그램 라이브러리
.Lb libc
.Sh 서식
.In unistd.h
.Ft int
.Fn readlink "const char *path" "char *buf" "int bufsiz"
.Sh 해설
.Fn readlink
(은)는,
.Fa bufsiz
사이즈인 버퍼
.Fa buf
안에 기호 연결
.Fa path
의 내용을 배치합니다.
.Fn readlink
함수는
.Fa buf
의 말미에
.Dv NUL
캐릭터를 추가하지 않습니다.
.Sh 반환값
호출이 정상적으로 완료했을 경우, 버퍼내에 배치한 캐릭터수를 돌려줍니다.
에러가 일어났을 경우는 -1 을 돌려주어, 에러 코드가 글로벌 변수
.Va errno
(으)로 설정됩니다.
.Sh 에러
.Fn readlink
(은)는 다음의 경우에 실패합니다.
.Bl -tag -width Er
.It Bq Er ENOTDIR
패스의 원가요소중에 디렉토리 이외의 것이 포함되어 있습니다.
.It Bq Er ENAMETOOLONG
패스명의 원가요소가 255 캐릭터를 넘고 있는지,
또는 패스명 전체가 1023 캐릭터를 넘고 있습니다.
.It Bq Er ENOENT
지정된 파일이 존재하지 않습니다.
.It Bq Er EACCES
지정된 패스에는, 검색이 허가되어 있지 않은 디렉토리가 포함되어 있습니다.
.It Bq Er ELOOP
패스명을 변환할 경우에 검출된 기호 연결이 너무 많습니다.
.It Bq Er EINVAL
지정의 파일이 기호 연결이 아닙니다.
.It Bq Er EIO
파일 시스템으로부터 독해간에 입출력 에러가 발생했습니다.
.It Bq Er EFAULT
.Fa buf
(은)는, 프로세스에 할당할 수 있었던 address 공간의 범위외를 가리키고 있습니다.
.El
.Sh 관련 항목
.Xr lstat 2 ,
.Xr stat 2 ,
.Xr symlink 2 ,
.Xr symlink 7
.Sh 역사
.Fn readlink
함수는
.Bx 4.2
그리고 등장했습니다.