utime(2) - file의 최종 접근 및 최종 변경시간 변경

utime(2)

#include <sys/types.h>
#include <utime.h>

int utime(const char *filename, const struct utimbuf *times);

파일의 최종 접근(access) 시간 및 최종변경(modification) 시간을 초 단위(time_t)로 변경하는 함수입니다. times가 NULL이면 현재시간으로 변경합니다.

 

 

파라미터

filename
    - 시간을 변경하려는 full path 파일명 또는 상대 path 파일명

times
    - 변경하려는 시간을 저장하는 구조체.
    - times를 NULL로 설정하면 현재 시간으로 접근 및 변경시간이 설정됩니다.

   struct utimbuf 구조체는 아래와 같습니다.
   struct utimbuf {
       time_t actime;       /* access time */
       time_t modtime;      /* modification time */
   };

 

RETURN

0
    - 정상적으로 처리되었습니다.


-1
    - 오류가 발생하였으며, 상세한 오류내용은 errno 전역변수에 설정됩니다.
 
 EACCES : filename을 구성하는 directory 중에서 search permission이 없음.(디렉토리에 x권한없음)
 EACCES : filenmae 파일에 대해서 쓰기 권한이 없음
 ENOENT : 없는 파일임.
 EPERM : 쓰기 권한이 없음.
 EROFS : File system이 읽기 전용 file system임.

 

---

활용 예제

 

Sample

#include <sys/types.h>
#include <utime.h>
#include <stdio.h>
#include <errno.h>

......

/* filename의 최종 접근 및 최종 수정 시간을 현재시간으로 변경합니다. */
if(utime(filename, NULL) == -1) {
    fprintf(stderr, "utime error: %s\n", strerror(errno));
    return -1;
}

......

 

---

 

see also :

    File 속성 정보 및 파일 관리 Library

    Directory 정보 조회 및 관리 Library

    System Call File I/O Library

    Stream File I/O Library