stat — Interpreting stat() results

소스 코드: Lib/stat.py


The stat module defines constants and functions for interpreting the results of os.stat(), os.fstat() and os.lstat() (if they exist). For complete details about the stat(), fstat() and lstat() calls, consult the documentation for your system.

버전 3.4에서 변경: stat 모듈은 C 구현으로 지원됩니다.

stat 모듈은 특정 파일 유형을 검사하기 위해 다음 함수를 정의합니다:

stat.S_ISDIR(mode)

mode가 디렉터리로부터 왔으면 0이 아닌 값을 반환합니다.

stat.S_ISCHR(mode)

mode가 문자 특수 장치(character special device) 파일로부터 왔으면 0이 아닌 값을 반환합니다.

stat.S_ISBLK(mode)

mode가 블록 특수 장치(block special device) 파일로부터 왔으면 0이 아닌 값을 반환합니다.

stat.S_ISREG(mode)

mode가 일반 파일로부터 왔으면 0이 아닌 값을 반환합니다.

stat.S_ISFIFO(mode)

mode가 FIFO(네임드 파이프)로부터 왔으면 0이 아닌 값을 반환합니다.

stat.S_ISLNK(mode)

mode가 심볼릭 링크로부터 왔으면 0이 아닌 값을 반환합니다.

stat.S_ISSOCK(mode)

mode가 소켓으로부터 왔으면 0이 아닌 값을 반환합니다.

stat.S_ISDOOR(mode)

mode가 door로부터 왔으면 0이 아닌 값을 반환합니다.

Added in version 3.4.

stat.S_ISPORT(mode)

mode가 이벤트 포트(event port)로부터 왔으면 0이 아닌 값을 반환합니다.

Added in version 3.4.

stat.S_ISWHT(mode)

mode가 화이트 아웃(whiteout)으로부터 왔으면 0이 아닌 값을 반환합니다.

Added in version 3.4.

파일의 모드(mode)를 보다 일반적으로 조작하기 위한 두 가지 추가 함수가 정의됩니다:

stat.S_IMODE(mode)

os.chmod()로 설정할 수 있는 파일 모드 부분을 반환합니다 —즉, 파일의 권한(permission) 비트, 끈끈한(sticky) 비트, set-group-id 및 set-user-id 비트 (지원하는 시스템에서).

stat.S_IFMT(mode)

Return the portion of the file’s mode that describes the file type (used by the S_IS*() functions above).

Normally, you would use the os.path.is*() functions for testing the type of a file; the functions here are useful when you are doing multiple tests of the same file and wish to avoid the overhead of the stat() system call for each test. These are also useful when checking for information about a file that isn’t handled by os.path, like the tests for block and character devices.

예제:

import os, sys
from stat import *

def walktree(top, callback):
    '''recursively descend the directory tree rooted at top,
       calling the callback function for each regular file'''

    for f in os.listdir(top):
        pathname = os.path.join(top, f)
        mode = os.lstat(pathname).st_mode
        if S_ISDIR(mode):
            # It's a directory, recurse into it
            walktree(pathname, callback)
        elif S_ISREG(mode):
            # It's a file, call the callback function
            callback(pathname)
        else:
            # Unknown file type, print a message
            print('Skipping %s' % pathname)

def visitfile(file):
    print('visiting', file)

if __name__ == '__main__':
    walktree(sys.argv[1], visitfile)

파일의 모드를 사람이 읽을 수 있는 문자열로 변환하기 위한 추가 유틸리티 함수가 제공됩니다:

stat.filemode(mode)

파일의 mode를 ‘-rwxrwxrwx’ 형식의 문자열로 변환합니다.

Added in version 3.3.

버전 3.4에서 변경: 이 함수는 S_IFDOOR, S_IFPORTS_IFWHT를 지원합니다.

아래의 모든 변수는 단순히 os.stat(), os.fstat() 또는 os.lstat()에 의해 반환된 10-튜플에 대한 기호 인덱스입니다.

stat.ST_MODE

아이 노드(inode) 보호 모드.

stat.ST_INO

아이 노드(inode) 번호.

stat.ST_DEV

아이 노드(inode)가 위치한 장치.

아이 노드(inode)에 대한 링크 수.

stat.ST_UID

소유자의 사용자 id.

stat.ST_GID

소유자의 그룹 id.

stat.ST_SIZE

일반 파일의 크기(바이트); 일부 특수 파일에서는 대기중인 데이터의 양.

stat.ST_ATIME

마지막 액세스 시간.

stat.ST_MTIME

마지막 수정 시간.

stat.ST_CTIME

운영 체제에서 보고한 “ctime”. (유닉스와 같은) 일부 시스템에서는 마지막 메타 데이터 변경 시간이고, (윈도우와 같은) 다른 시스템에서는 생성 시간입니다 (자세한 내용은 플랫폼 설명서를 참조하십시오).

“파일 크기”의 해석은 파일 유형에 따라 달라집니다. 일반 파일에서는 바이트로 표현한 파일의 크기입니다. 대부분의 유닉스(특히 리눅스를 포함하는)의 FIFO와 소켓에서, “크기”는 os.stat(), os.fstat() 또는 os.lstat()를 호출한 시점에 읽기 대기 중인 바이트 수입니다; 이것은 때때로, 특히 비 블로킹으로 연 후에 이러한 특수 파일 중 하나를 폴링할 때 유용할 수 있습니다. 다른 문자와 블록 장치에서 크기 필드의 의미는 하부 시스템 호출의 구현에 따라 더 다양합니다.

아래의 변수는 ST_MODE 필드에서 사용되는 플래그를 정의합니다.

첫 번째 플래그 집합을 사용하는 것보다 위의 함수를 사용하는 것이 더 이식성 있습니다:

stat.S_IFSOCK

소켓.

stat.S_IFLNK

심볼릭 링크.

stat.S_IFREG

일반 파일.

stat.S_IFBLK

블록 장치.

stat.S_IFDIR

디렉터리.

stat.S_IFCHR

문자 장치.

stat.S_IFIFO

FIFO.

stat.S_IFDOOR

Door.

Added in version 3.4.

stat.S_IFPORT

이벤트 포트.

Added in version 3.4.

stat.S_IFWHT

화이트 아웃(whiteout).

Added in version 3.4.

참고

플랫폼이 파일 유형을 지원하지 않으면, S_IFDOOR, S_IFPORT 또는 S_IFWHT는 0으로 정의됩니다.

다음 플래그는 os.chmod()mode 인자에서도 사용할 수 있습니다:

stat.S_ISUID

Set-user-ID 비트.

stat.S_ISGID

Set-group-ID 비트. 이 비트는 몇 가지 특별한 용도로 사용됩니다. 디렉터리에서는 그 디렉터리가 BSD의 의미가 있음을 나타냅니다: 여기에 만들어진 파일은 만드는 프로세스의 유효 그룹 ID가 아니라 디렉터리에서 그룹 ID를 상속받고, S_ISGID 비트 설정도 얻습니다. 그룹 실행 비트(S_IXGRP)가 설정되지 않은 파일의 경우, set-group-ID 비트는 필수 파일/레코드 잠금을 나타냅니다 (S_ENFMT도 참조하십시오).

stat.S_ISVTX

끈끈한(sticky) 비트. 이 비트가 디렉터리에 설정되면, 해당 디렉터리의 파일은 파일의 소유자, 디렉터리의 소유자 또는 권한 있는(privileged) 프로세스에 의해서만 이름이 바뀌거나 삭제될 수 있음을 의미합니다.

stat.S_IRWXU

파일 소유자 권한(permission) 마스크.

stat.S_IRUSR

소유자에게 읽기 권한이 있습니다.

stat.S_IWUSR

소유자에게 쓰기 권한이 있습니다.

stat.S_IXUSR

소유자에게 실행 권한이 있습니다.

stat.S_IRWXG

그룹 권한 마스크.

stat.S_IRGRP

그룹에 읽기 권한이 있습니다.

stat.S_IWGRP

그룹에 쓰기 권한이 있습니다.

stat.S_IXGRP

그룹에 실행 권한이 있습니다.

stat.S_IRWXO

다른 사용자(그룹에 없는)에 대한 권한 마스크.

stat.S_IROTH

다른 사용자에게 읽기 권한이 있습니다.

stat.S_IWOTH

다른 사용자에게 쓰기 권한이 있습니다.

stat.S_IXOTH

다른 사용자에게 실행 권한이 있습니다.

stat.S_ENFMT

System V 파일 잠금 강제. 이 플래그는 S_ISGID와 공유됩니다: 파일/레코드 잠금이 그룹 실행 비트(S_IXGRP)가 설정되지 않은 파일에 적용됩니다.

stat.S_IREAD

S_IRUSR에 대한 유닉스 V7 동의어.

stat.S_IWRITE

S_IWUSR에 대한 유닉스 V7 동의어.

stat.S_IEXEC

S_IXUSR에 대한 유닉스 V7 동의어.

다음 플래그는 os.chflags()flags 인자에서 사용될 수 있습니다:

stat.UF_SETTABLE

All user settable flags.

Added in version 3.13.

stat.UF_NODUMP

파일을 덤프하지 마십시오.

stat.UF_IMMUTABLE

파일을 변경할 수 없습니다.

stat.UF_APPEND

파일은 덧붙이기만 할 수 있습니다.

stat.UF_OPAQUE

디렉터리는 유니언 스택(union stack)을 통해 볼 때 불투명합니다.

파일의 이름을 변경하거나 삭제할 수 없습니다.

stat.UF_COMPRESSED

The file is stored compressed (macOS 10.6+).

stat.UF_TRACKED

Used for handling document IDs (macOS)

Added in version 3.13.

stat.UF_DATAVAULT

The file needs an entitlement for reading or writing (macOS 10.13+)

Added in version 3.13.

stat.UF_HIDDEN

The file should not be displayed in a GUI (macOS 10.5+).

stat.SF_SETTABLE

All super-user changeable flags

Added in version 3.13.

stat.SF_SUPPORTED

All super-user supported flags

Availability: macOS

Added in version 3.13.

stat.SF_SYNTHETIC

All super-user read-only synthetic flags

Availability: macOS

Added in version 3.13.

stat.SF_ARCHIVED

파일을 보관(archive)할 수 있습니다.

stat.SF_IMMUTABLE

파일을 변경할 수 없습니다.

stat.SF_APPEND

파일은 덧붙이기만 할 수 있습니다.

stat.SF_RESTRICTED

The file needs an entitlement to write to (macOS 10.13+)

Added in version 3.13.

파일의 이름을 변경하거나 삭제할 수 없습니다.

stat.SF_SNAPSHOT

파일은 스냅숏(snapshot) 파일입니다.

The file is a firmlink (macOS 10.15+)

Added in version 3.13.

stat.SF_DATALESS

The file is a dataless object (macOS 10.15+)

Added in version 3.13.

See the *BSD or macOS systems man page chflags(2) for more information.

윈도우에서 os.stat()에 의해 반환된 st_file_attributes 멤버의 비트를 검사할 때 다음 파일 어트리뷰트 상수를 사용할 수 있습니다. 이러한 상수의 의미에 대한 자세한 내용은 Windows API documentation을 참조하십시오.

stat.FILE_ATTRIBUTE_ARCHIVE
stat.FILE_ATTRIBUTE_COMPRESSED
stat.FILE_ATTRIBUTE_DEVICE
stat.FILE_ATTRIBUTE_DIRECTORY
stat.FILE_ATTRIBUTE_ENCRYPTED
stat.FILE_ATTRIBUTE_HIDDEN
stat.FILE_ATTRIBUTE_INTEGRITY_STREAM
stat.FILE_ATTRIBUTE_NORMAL
stat.FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
stat.FILE_ATTRIBUTE_NO_SCRUB_DATA
stat.FILE_ATTRIBUTE_OFFLINE
stat.FILE_ATTRIBUTE_READONLY
stat.FILE_ATTRIBUTE_REPARSE_POINT
stat.FILE_ATTRIBUTE_SPARSE_FILE
stat.FILE_ATTRIBUTE_SYSTEM
stat.FILE_ATTRIBUTE_TEMPORARY
stat.FILE_ATTRIBUTE_VIRTUAL

Added in version 3.5.

윈도우에서, os.lstat()이 반환한 st_reparse_tag 멤버와 비교하기 위해 다음 상수를 사용할 수 있습니다. 이것들은 잘 알려진 상수이지만, 완전한 목록은 아닙니다.

stat.IO_REPARSE_TAG_MOUNT_POINT

Added in version 3.8.