futimesat(2) - wariua/manpages-ko GitHub Wiki

futimesat - 디렉터리 파일 디스크립터 기준으로 파일의 타임스탬프 바꾸기

#include <fcntl.h> /* AT_* 상수 정의 */
#include <sys/time.h>

int futimesat(int dirfd, const char *pathname,
              const struct timeval times[2]);

glibc 기능 확인 매크로 요건 (feature_test_macros(7) 참고):

futimesat():

_GNU_SOURCE

이 시스템 호출은 구식이다. 대신 utimensat(2)을 사용하라.

futimesat() 시스템 호출은 이 매뉴얼 페이지에서 기술하는 차이점들을 제외하면 utimes(2)와 정확히 동일하게 동작한다.

pathname으로 준 경로명이 상대적인 경우에는 (utimes(2)에서 상대 경로명에 대해 하듯 호출 프로세스의 현재 작업 디렉터리 기준이 아니라) 파일 디스크립터 dirfd가 가리키는 디렉터리를 기준으로 해석한다.

pathname이 상대적이고 dirfd가 특수한 값 AT_FDCWD인 경우에는 (utimes(2)처럼) 호출 프로세스의 현재 작업 디렉터리를 기준으로 pathname을 해석한다.

pathname이 절대적인 경우에는 dirfd를 무시한다.

성공 시 futimesat()은 0을 반환한다. 오류 시 -1을 반환하며 오류를 나타내도록 errno를 설정한다.

utimes(2)에 발생할 수 있는 것과 같은 오류들이 futimesat()에도 발생할 수 있다. 그리고 futimesat()에는 다음 오류들이 추가로 발생할 수 있다.

EBADF

dirfd가 유효한 파일 디스크립터가 아니다.

ENOTDIR

pathname이 상대적인데 dirfd가 디렉터리 아닌 파일을 가리키는 파일 디스크립터이다.

리눅스 커널 2.6.16에 futimeat()이 추가되었다. glibc 버전 2.6에서 라이브러리 지원이 추가되었다.

이 시스템 호출은 비표준이다. POSIX.1에 제안되었던 명세에 따라 구현이 이뤄졌는데 그 명세가 utimensat(2) 명세로 교체되었다.

솔라리스에 비슷한 시스템 호출이 있다.

pathname이 NULL인 경우에 glibc의 futimesat() 래퍼 함수는 dirfd가 가리키는 파일의 시간들을 갱신한다.

stat(2), utimensat(2), utimes(2), futimes(3), path_resolution(7)

2017-09-15