<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.1//EN"> 
<chapter lang=ko> 
<!-- 작성자 : yundream             --> 
<!-- 작성일 : 2004/01/27           --> 
<!-- 연락처 : yundream@joinc.co.kr -->  
 
<!-- 함수 이름을 입력합니다 --> 
<title>stat(2)</title> 
 
<!-- 이건 함수에 대한 대략적인 설명이구요 --> 
<para> 
    파일의 상태를 얻어온다. 
</para> 
  
<!-- 여기에 함수의 간단한 사용법이 들어갑니다 --> 
<section> 
    <title>사용법</title> 
    <para> 
        <screen> 
#include <sys/types.h> 
#include <sys/stat.h> 
#include <unistd.h> 
 
int stat(const char *file_name, struct stat *buf); 
int fstat(int filedes, struct stat *buf); 
int lstat(const char *file_name, struct stat *buf); 
        </screen> 
    </para> 
</section> 
 
<!-- 여기엔 함수의 자세한 설명 이 들어갑니다 --> 
<section> 
    <title>설명</title> 
    <para> 
        stat() 함수를 이용하면 파일의 상태를 알아올수 있다. 첫번째 인자로  
        주어진 file_name 의 상태를 얻어와서 두번째 인자인 buf 에 채워 넣는다.  
    </para> 
    <para> 
        lstat() 함수는 심볼릭 링크파일의 원본파일의 상태를 얻어온다는 것을  
        제외하고는 stat() 함수와 동일하다.  
    </para> 
    <para> 
        fstat() 는 open(2) 등을 통해서 만들어진 파일지시자를 인자로  
        받아들인다는 점 외에는 stat() 와 동일한 일을 수행한다.  
    </para> 
    <para> 
        이들 함수는 성공적으로 수행될경우 파일의 정보를  
        <emphasis>stat</emphasis>구조체에 복사한다. stat구조체는 다음과 같이 
        정의되어 있다. 
        <screen> 
struct stat { 
    dev_t         st_dev;      /* device */ 
    ino_t         st_ino;      /* inode */ 
    mode_t        st_mode;     /* protection */ 
    nlink_t       st_nlink;    /* number of hard links */ 
    uid_t         st_uid;      /* user ID of owner */ 
    gid_t         st_gid;      /* group ID of owner */ 
    dev_t         st_rdev;     /* device type (if inode device) */ 
    off_t         st_size;     /* total size, in bytes */ 
    blksize_t     st_blksize;  /* blocksize for filesystem I/O */ 
    blkcnt_t      st_blocks;   /* number of blocks allocated */ 
    time_t        st_atime;    /* time of last access */ 
    time_t        st_mtime;    /* time of last modification */ 
    time_t        st_ctime;    /* time of last change */ 
}; 
        </screen> 
    </para> 
</section> 
 
<!-- 함수가 되돌려주는 값이구요 --> 
<section> 
    <title>반환값</title> 
    <para> 
        성공할경우 0을 실패했을경우에는 -1을 반환하며, 적당한 errno 값을  
        설정한다.  
    </para> 
</section> 
 
<!-- 에러가 발생했을때 되돌려주는 값들입니다 --> 
<section> 
    <title>에러</title> 
    <para> 
        <variablelist>     
            <varlistentry> 
            <term>EBADF</term>     
            <listitem> 
                <para>     
                    잘못된 파일 지정자 
                </para>     
            </listitem> 
            </varlistentry> 
 
            <varlistentry> 
            <term>ENOENT</term> 
            <listitem> 
                <para> 
                    파일이름을 찾기 위한 경로의 구성요수중 존재하지 않는  
                    경로가 있을 경우 
                </para> 
            </listitem> 
            </varlistentry> 
            <varlistentry> 
            <term>EACCESST</term> 
            <listitem> 
                <para> 
                    읽기 권한이 없다. 
                </para> 
            </listitem> 
            </varlistentry> 
            <varlistentry> 
            <term>ENOTDIR</term> 
            <listitem> 
                <para> 
                    구성요소중 디렉토리가 아닌게 있다. 
                </para> 
            </listitem> 
            </varlistentry> 
        </variablelist>     
    </para> 
</section> 
 
<!-- 마지막으로 에제 입니다                                                 --> 
<!-- 여기에는 완전한 예제가 들어가 있는데, 굳이 완전한 예제를 만들필요 없이 --> 
<!-- 코드 일부분만 작성해서 올려주셔도 됩니다                               -->  
<!-- "<", ">", "&" 등은 변환해 주셔야 하는데, 귀찮으시면 :-) 변환 하지 않   --> 
<!-- 아도 됩니다. 제가 검사 해서 올리겠습니다                               --> 
<!-- 예제에 대한 간단한 설명을 적어주셔도 되구요                            --> 
<section> 
    <title>예제</title> 
    <para> 
        <screen> 
#include <unistd.h> 
#include <sys/types.h> 
#include <sys/stat.h> 
#include <unistd.h> 
#include <stdio.h> 
#include <pwd.h> 
#include <grp.h> 
 
int main(int argc, char **argv) 
{ 
    int return_stat; 
    char *file_name; 
    struct stat file_info; 
 
    struct passwd *my_passwd; 
    struct group  *my_group; 
 
    mode_t file_mode; 
     
    if (argc != 2 ) 
    { 
        printf("Usage : ./file_info [file name]\n"); 
        exit(0); 
    } 
    file_name = argv[1];     
 
    if ((return_stat = stat(file_name, &file_info)) == -1) 
    { 
        perror("Error : "); 
        exit(0); 
    } 
 
    file_mode = file_info.st_mode; 
    printf("파일이름 : %s\n", file_name); 
    printf("=======================================\n"); 
    printf("파일 타입 : "); 
    if (S_ISREG(file_mode)) 
    { 
        printf("정규파일\n"); 
    } 
    else if (S_ISLNK(file_mode)) 
    { 
        printf("심볼릭 링크\n"); 
    } 
    else if (S_ISDIR(file_mode)) 
    { 
        printf("디렉토리\n");     
    } 
    else if (S_ISCHR(file_mode)) 
    { 
        printf("문자 디바이스\n"); 
    } 
    else if (S_ISBLK(file_mode)) 
    { 
        printf("블럭 디바이스\n"); 
    } 
    else if (S_ISFIFO(file_mode)) 
    { 
        printf("FIFO\n"); 
    } 
    else if (S_ISSOCK(file_mode)) 
    { 
        printf("소켓\n"); 
    } 
 
    my_passwd = getpwuid(file_info.st_uid); 
    my_group  = getgrgid(file_info.st_gid); 
    printf("OWNER : %s\n", my_passwd->pw_name); 
    printf("GROUP : %s\n", my_group->gr_name); 
    printf("FILE SIZE IS : %d\n", file_info.st_size); 
    printf("마지막 읽은 시간 : %d\n", file_info.st_atime); 
    printf("마지막 수정 시간 : %d\n", file_info.st_mtime); 
    printf("하드링크된 파일수 : %d\n", file_info.st_nlink); 
} 
        </screen> 
    </para> 
</section> 
</chapter>