.\" Copyright (c) 1980, 1991, 1993, 1994 .\" 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. .\" .\" @(#) stat. 2 8.4 (Berkeley) 5/1/95 .\" %FreeBSD: src/lib/libc/sys/stat. 2, v 1.16. 2.7 2001/12/14 18:34:01 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/stat. 2, v 1.10 2002/01/19 04:13:35 horikawa Exp $ .Dd May 1, 1995 .Dt STAT 2 .Os .Sh 명칭 .Nm stat , .Nm lstat , .Nm fstat .Nd file status의 취득 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/types.h .In sys/stat.h .Ft int .Fn stat "const char *path" "struct stat *sb" .Ft int .Fn lstat "const char *path" "struct stat *sb" .Ft int .Fn fstat "int fd" "struct stat *sb" .Sh 해설 .Fn stat 함수는, .Fa path 하지만 가리키는 파일의 정보를 취득합니다. 지정한 파일의 읽기권, 기록권, 실행권은 필요 없습니다. 그러나, 그 파일에 도달하는 패스명으로 열거된 모든 디렉토리는, 검색 가능하다라고 하는 것이 필요합니다. .Pp .Fn lstat 하 .Fn stat (을)를 닮아 있습니다만, 지정한 파일이 기호 연결인 경우는 다릅니다. .Fn lstat (은)는 링크의 정보를 되돌립니다만, .Fn stat (은)는 링크가 참조하는 파일의 정보를 돌려줍니다. .Pp .Fn fstat (은)는, 파일 기술자 .Fa fd 그리고 구별되는 오픈 파일에 대해, 위와 같은 정보를 취득합니다. .Pp 인수 .Fa sb (은)는, 구조체 .Fn stat 에의 포인터입니다. 이것은, .Aq Pa sys/stat.h (아래와 같이 참조)(으)로 정의되어 파일에 관한 정보를 보관 유지합니다. .Bd -literal struct stat { dev_t st_dev; /* inode 의 디바이스 */ ino_t st_ino; /* inode 번호 */ mode_t st_mode; /* inode 보호 모드 */ nlink_t st_nlink; /* 하드 링크수 */ uid_t st_uid; /* 파일 소유자의 유저 ID */ gid_t st_gid; /* 파일 그룹의 그룹 ID */ dev_t st_rdev; /* 디바이스 타입 */ #ifndef _POSIX_SOURCE struct timespec st_atimespec; /* 마지막 액세스 시각 */ struct timespec st_mtimespec; /* 마지막 데이터 수정 시각 */ struct timespec st_ctimespec; /* 마지막 file status 수정 시각 */ #else time_t st_atime; /* 마지막 액세스 시각 */ long st_atimensec; /* 마지막 액세스 시각의 나노초 */ time_t st_mtime; /* 마지막 데이터 수정 시각 */ long st_mtimensec; /* 마지막 데이터 수정 시각의 나노초 */ time_t st_ctime; /* 마지막 file status 수정 시각 */ long st_ctimensec; /* 마지막 file status 수정 시각의 나노초 */ #endif off_t st_size; /* 바이트 단위의 파일의 크기 */ int64_t st_blocks; /* 파일에 할당할 수 있었던 블록수 */ u_int32_t st_blksize; /* 입출력에 최적인 블록 사이즈 */ u_int32_t st_flags; /* 파일에 대한 유저 정의 플래그 */ u_int32_t st_gen; /* 파일 생성 번호 */ }; .Ed .Pp .Fa struct stat 의 시각에 관한 필드는, 이하대로입니다. .Bl -tag -width XXXst_mtime .It st_atime 파일의 데이터가 마지막에 액세스 되었을 때 각. .Xr mknod 2 , .Xr utimes 2 , .Xr read 2 시스템 콜로 변경됩니다. .It st_mtime 파일의 데이터가 마지막에 수정되었을 때 각. .Xr mknod 2 , .Xr utimes 2 , .Xr write 2 시스템 콜로 변경됩니다. .It st_ctime file status가 마지막에 변경되었을 때 각 (inode 데이터의 수정). .Xr chmod 2 , .Xr chown 2 , .Xr link 2 , .Xr mknod 2 , .Xr rename 2 , .Xr unlink 2 , .Xr utimes 2 , .Xr write 2 시스템 콜로 변경됩니다. .El .Pp .Dv _POSIX_SOURCE 하지만 정의되어 있지 않은 경우, 시각에 관한 필드는 이하와 같이 정의됩니다. .Bd -literal #ifndef _POSIX_SOURCE #define st_atime st_atimespec.tv_sec #define st_mtime st_mtimespec.tv_sec #define st_ctime st_ctimespec.tv_sec #endif .Ed .Pp .Fa struct stat 의 사이즈에 관한 필드는, 이하대로입니다. .Bl -tag -width XXXst_blksize .It st_blksize 파일의 최적인 입출력 블록 사이즈. .It st_blocks 파일에 512 바이트 단위로 할당할 수 있었던 블록의 실제의 수. 짧은 기호 연결이 inode 에 보관 유지되고 있는 경우, 이 수치가 0 이 되는 일이 있습니다. .El .Pp 스테이터스 정보 워드 .Fa st_mode 에는, 이하와 같은 비트가 있습니다. .Bd -literal #define S_IFMT 0170000 /* 파일의 타입 */ #define S_IFIFO 0010000 /* 이름 첨부 파이프 (fifo) */ #define S_IFCHR 0020000 /* 캐릭터형 특수 파일 */ #define S_IFDIR 0040000 /* 디렉토리 */ #define S_IFBLK 0060000 /* 블록형 특수 파일 */ #define S_IFREG 0100000 /* 통상 */ #define S_IFLNK 0120000 /* 기호 연결 */ #define S_IFSOCK 0140000 /* 소켓 */ #define S_IFWHT 0160000 /* 화이트 아웃 */ #define S_ISUID 0004000 /* 실행시에 유저 ID 를 설정 */ #define S_ISGID 0002000 /* 실행시에 그룹 ID 를 설정 */ #define S_ISVTX 0001000 /* 사용후에도 스왑 된 텍스트를 보존 */ #define S_IRUSR 0000400 /* 읽기 권한의 소유자 */ #define S_IWUSR 0000200 /* 기입 권한의 소유자 */ #define S_IXUSR 0000100 /* 실행/검색 권한의 소유자 */ .Ed 액세스 모드의 리스트에 대해서는, .Aq Pa sys/stat.h , .Xr access 2 , .Xr chmod 2 (을)를 참조해 주세요. .Sh 반환값 .Rv -std .Sh 호환성 이전의 버젼의 시스템에서는, .Li st_dev , .Li st_uid , .Li st_gid , .Li st_rdev , .Li st_size , .Li st_blksize , .Li st_blocks 필드에 다른 타입을 사용하고 있었습니다. .Sh 에러 .Fn stat (와)과 .Fn lstat (은)는, 이하와 같은 경우에 에러가 됩니다. .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 EFAULT .Fa sb 인가 .Em name (은)는, 프로세스에 할당할 수 있었던 address 공간의 범위외를 가리키고 있습니다. .It Bq Er EIO 파일 시스템에서의 읽고 쓰기중에 입출력 에러가 발생했습니다. .El .Pp .Fn fstat (은)는, 이하와 같은 경우에 에러가 됩니다. .Bl -tag -width Er .It Bq Er EBADF .Fa fd 하지만, 유효한 기술자가 아닙니다. .It Bq Er EFAULT .Fa sb (은)는, 프로세스에 할당할 수 있었던 address 공간의 범위외를 가리키고 있습니다. .It Bq Er EIO 파일 시스템에 읽고 쓰기하고 있는 동안에 입출력 에러가 발생했습니다. .El .Sh 관련 항목 .Xr access 2 , .Xr chmod 2 , .Xr chown 2 , .Xr utimes 2 , .Xr symlink 7 .Sh 버그 .Fn fstat (을)를 소켓 ( 및 파이프)에 적용하면(자), 블록 사이즈 필드, 및 고유 디바이스와 inode 번호 이외에 0 이 들어간 버퍼가 되돌려집니다. .Sh 표준 .Fn stat 함수 호출과 .Fn fstat 함수 호출은, .St -p1003.1-90 에 준거하고 있습니다. .Sh 역사 .Fn stat 함수 호출과 .Fn fstat 함수 호출은, .At v7 그리고 등장했습니다. .Fn lstat 함수 호출은 .Bx 4.2 그리고 등장했습니다. .\" Amended by N.Kumagai 2000-3-18