.\" Copyright (c) 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. .\" .\" @(#) pathconf. 2 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/sys/pathconf. 2, v 1.4. 2.6 2001/12/14 18:34:01 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/pathconf. 2, v 1.8 2001/12/23 00:03:42 horikawa Exp $ .Dd June 4, 1993 .Dt PATHCONF 2 .Os .Sh 명칭 .Nm pathconf , .Nm fpathconf .Nd 구성 가능한 패스명 변수를 취득한다 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In unistd.h .Ft long .Fn pathconf "const char *path" "int name" .Ft long .Fn fpathconf "int fd" "int name" .Sh 해설 .Fn pathconf 함수와 .Fn fpathconf 함수는, 구성 가능한 시스템 한계의 현재가, 또는 패스명이나 파일 기술자에게 대응하는 옵션 변수를 어플리케이션이 판정하는 방법을 제공합니다. .Pp .Fn pathconf 의 경우, .Fa path 인수는 파일 또는 디렉토리의 이름입니다. .Fn fpathconf 의 경우, .Fa fd 인수는 오픈 파일의 기술자입니다. .Fa name 인수는, 조회하는 시스템 변수를 지정합니다. 각각의 이름에 관한 상징적 정수는 인클루드 파일 .Li 에 있습니다. .Pp 이용 가능한 값은 다음과 같습니다. .Pp .Bl -tag -width 6n .Pp .It Li _PC_LINK_MAX 최대의 파일 링크 카운트. .It Li _PC_MAX_CANON 단말의 표준 모드 입력 기다리는 행렬의 최대 바이트수. .It Li _PC_MAX_INPUT 단말 입력 기다리는 행렬내 공간에서 이용할 수 있는 최대 바이트수의 최소치. .It Li _PC_NAME_MAX 파일명의 최대 바이트수. .It Li _PC_PATH_MAX 패스명의 최대 바이트수. .It Li _PC_PIPE_BUF 파이프에 자동적으로 쓰기최대 바이트수. .It Li _PC_CHOWN_RESTRICTED .Xr chown 2 시스템 콜을 실행하는데, 적절한 특권이 필요한 경우는 1 을 돌려주어, 그렇지 않은 경우는 0 을 돌려줍니다. .It Li _PC_NO_TRUNC KERN_NAME_MAX 보다 긴 파일명을 잘라 버릴 수 있는 경우는 1 을 돌려줍니다. .It Li _PC_VDISABLE 단말 제어 캐릭터를 무효로 하기 위한 값을 돌려줍니다. .El .Sh 반환값 .Fn pathconf 또는 .Fn fpathconf 의 호출이 정상적으로 완료하지 않는 경우는 -1 이 돌려주어 .Va errno 하지만 적절한 값으로 설정됩니다. 변수에 연결시킬 수 있었던 기능이 시스템내에 한계를 가지지 않을 때, -1 하지만 돌려주어 .Va errno (은)는 수정되지 않습니다. 그 이외의 경우, 현재의 변수치가 돌려주어집니다. .Sh 에러 다음의 조건의 어떤 것인가가 일어났을 경우, .Fn pathconf 함수와 .Fn fpathconf 함수는 -1 을 돌려주어, .Va errno 에 대응하는 값을 설정합니다. .Bl -tag -width Er .It Bq Er EINVAL .Fa name 인수의 값이 무효입니다. .It Bq Er EINVAL 이 파일과 이 변수와의 관계는, 실장되고 있지 않습니다. .El .Pp .Fn pathconf (은)는 다음의 경우에 실패합니다. .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 EIO 파일 시스템에 읽고 쓰기하고 있는 동안에 입출력 에러가 발생했습니다. .El .Pp .Bl -tag -width Er .Fn fpathconf (은)는 다음의 경우에 실패합니다. .It Bq Er EBADF .Fa fd (은)는 유효한 오픈 파일 기술자가 아닙니다. .It Bq Er EIO 파일 시스템에 읽고 쓰기하고 있는 동안에 입출력 에러가 발생했습니다. .El .Sh 관련 항목 .Xr sysctl 3 .Sh 역사 .Fn pathconf 함수와 .Fn fpathconf 함수는 .Bx 4.4 그리고 처음 등장했습니다.