Linux Certif

Toute la documentation sur la certification Linux LPI

utime

̾Á°

utime, utimes - inode ¤Î¥¢¥¯¥»¥¹»þ¹ï/½¤Àµ»þ¹ï¤òÊѹ¹¤¹¤ë

½ñ¼°

#include <sys/types.h>




#include <utime.h>



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



#include <sys/time.h>



int utimes(const char *filename, const struct timeval times[2]);

ÀâÌÀ

utime() ¤Ï filename ¤Ç¼¨¤µ¤ì¤ë inode ¤Î¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï¤ò buf Ãæ¤Î actime ¤È modtime ¤Ë¤½¤ì¤¾¤ìÊѹ¹¤¹¤ë¡£

buf ¤¬ NULL ¤Î¾ì¹ç¡¢¥Õ¥¡¥¤¥ë¤Î¥¢¥¯¥»¥¹»þ¹ï¤È½¤Àµ»þ¹ï¤Ï¸½ºß¤Î»þ¹ï¤ËÀßÄꤵ¤ì¤ë¡£

¥¿¥¤¥à¥¹¥¿¥ó¥×¤ÎÊѹ¹¤Ï°Ê²¼¤Î¾ì¹ç¤Ëµö²Ä¤µ¤ì¤ë: ¥×¥í¥»¥¹¤ËŬÀÚ¤ÊÆø¢¤¬¤¢¤ë (Linux ¤Ç¤Ï CAP_FOWNER ¥±¡¼¥Ñ¥Ó¥ê¥Æ¥£ (capability) ¤¬¤¢¤ë)¡£ ¤Þ¤¿¤Ï¼Â¸ú (effective) ¥æ¡¼¥¶ ID ¤¬¡¢¥Õ¥¡¥¤¥ë¤Î¥æ¡¼¥¶ ID ¤ÈÅù¤·¤¤¡£ ¤Þ¤¿¤Ï buf ¤¬ NULL ¤Ç¡¢¤«¤Ä¥×¥í¥»¥¹¤¬¥Õ¥¡¥¤¥ë¤Ø¤Î½ñ¤­¹þ¤ßµö²Ä¤ò»ý¤Ã¤Æ¤¤¤ë¡£

¹½Â¤ÂÎ utimbuf ¤Ï°Ê²¼¤Ë¼¨¤¹¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤ë¡£

struct utimbuf {

    time_t actime;       /* ¥¢¥¯¥»¥¹»þ¹ï */

    time_t modtime;      /* ½¤Àµ»þ¹ï */

};

´Ø¿ô utime() ¤Ï 1 ÉäÎʬ²òǽ¤Ç¥¿¥¤¥à¥¹¥¿¥ó¥×¤ò»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤ë¡£ ´Ø¿ô utimes() ¤Ï utime() ¤ÈƱÍͤǤ¢¤ë¤¬¡¢1 ¥Þ¥¤¥¯¥íÉäÎʬ²òǽ¤Ç¥¿¥¤¥à¥¹¥¿¥ó¥×¤ò»ØÄꤹ¤ë¤³¤È¤¬¤Ç¤­¤ë¡£ ¤³¤³¤Ç¡¢ times[0] ¤Ï¥¢¥¯¥»¥¹»þ¹ï¤ò»²¾È¤·¡¢ times[1] ¤Ï½¤Àµ»þ¹ï¤ò»²¾È¤¹¤ë¡£

¹½Â¤ÂÎ timeval ¤Ï°Ê²¼¤Ë¼¨¤¹Ä̤ê¤Ç¤¢¤ë¡£

struct timeval {

    long tv_sec;        /* ÉÃ */

    long tv_usec;       /* ¥Þ¥¤¥¯¥íÉà */

};

ÊÖ¤êÃÍ

À®¸ù¤·¤¿¾ì¹ç 0 ¤¬Ê֤롣¼ºÇÔ¤·¤¿¾ì¹ç -1 ¤¬Ê֤ꡢ errno ¤¬¥¨¥é¡¼¤ÎÆâÍƤ˽¾¤Ã¤ÆÀßÄꤵ¤ì¤ë¡£

¥¨¥é¡¼

EACCES

path ¤ò¹½À®¤¹¤ë²¿¤ì¤«¤Î¥Ç¥£¥ì¥¯¥È¥ê¤Ë¸¡º÷µö²Ä¤¬¤Ê¤¤ (path_resolution(7) ¤â»²¾È¤¹¤ë¤³¤È)¡£ ¤Þ¤¿¤Ï buf ¤¬ NULL ¤Ç¡¢¤«¤Ä¥×¥í¥»¥¹¤Ë¥¿¥¤¥à¥¹¥¿¥ó¥×¤ÎÊѹ¹µö²Ä¤¬¤Ê¤¤ (¾åµ­¤ò»²¾È¤¹¤ë¤³¤È)¡£

ENOENT

filename ¤¬Â¸ºß¤·¤Ê¤¤¡£

EPERM

buf ¤¬ NULL ¤Ç¤Ê¤¯¡¢¤«¤Ä¥×¥í¥»¥¹¤Ë¥¿¥¤¥à¥¹¥¿¥ó¥×¤ÎÊѹ¹µö²Ä¤¬¤Ê¤¤¡£

EROFS

path ¤¬Æɤ߹þ¤ßÀìÍѤΥե¡¥¤¥ë¥·¥¹¥Æ¥à¾å¤Ë¤¢¤ë¡£

½àµò

utime(): SVr4, POSIX.1-2001.
utimes(): 4.3BSD

Ãí°Õ

Linux ¤Ç¤Ï¡¢ÉÔÊÑ (immutable) ¥Õ¥¡¥¤¥ë¤Î¥¿¥¤¥à¥¹¥¿¥ó¥×¤òÊѹ¹¤·¤¿¤ê¡¢ ÄɲÃÀìÍÑ (append-only) ¤Î¥Õ¥¡¥¤¥ë¤Ë¸½ºß»þ¹ï°Ê³°¤Î¥¿¥¤¥à¥¹¥¿¥ó¥×¤ò ÀßÄꤷ¤¿¤ê¤¹¤ë¤³¤È¤Ï¡¢µö²Ä¤µ¤ì¤Æ¤¤¤Ê¤¤¡£

libc4 ¤È libc5 ¤Ç¤Ï¡¢ utimes() ¤Ïñ¤Ë utime() ¤Î¥é¥Ã¥Ñ¡¼ (wrapper) ¤Ç¤¢¤ë¡£ ¤½¤Î¤¿¤áÉðʲ¼¤ò»ØÄꤹ¤ë¤³¤È¤Ï¤Ç¤­¤Ê¤¤¡£

POSIX.1-2001 ¤Ç¤Ï utimes() ¤Ï²áµî¤Î̾»Ä¤Ç¤¢¤ë¤È¤µ¤ì¤Æ¤¤¤ë¤¬¡¢ÉԻ׵Ĥʤ³¤È¤Ë utimes() ¤Ï utime() ¤è¤ê¤â¹âµ¡Ç½¤Ç¤¢¤ë¡£

¥Ð¥°

Linux ¤Ï EACCES ¤È EPERM ¥¨¥é¡¼¤Î¶èÊ̤ËÃí°Õ¤òʧ¤Ã¤Æ¤¤¤Ê¤¤¡£ ¤Þ¤¿ POSIX.1-2001 ¤Ç¤Ï utimes() ¤Î¥¨¥é¡¼¤Îµ­½Ò¤Ë¥Ð¥°¤¬¤¢¤ë¡£

´ØÏ¢¹àÌÜ

chattr(1), futimesat(2), stat(2), futimes(3)