.\" %NetBSD: utimes. 2, v 1.13 1999/03/22 19:45:11 garbled Exp % .\" .\" Copyright (c) 1990, 1993 .\" The Regents of the University of California. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the University of .\" California, Berkeley and its contributors. .\" 4. Neither the name of the University nor the names of its contributors .\" may be used to endorse or promote products derived from this software .\" without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" .\" @(#) utimes. 2 8.1 (Berkeley) 6/4/93 .\" %FreeBSD: src/lib/libc/sys/utimes. 2, v 1.8. 2.4 2001/12/14 18:34:02 ru Exp % .\" .\" $FreeBSD: doc/ja_JP.eucJP/man/man2/utimes. 2, v 1.9 2002/01/19 04:13:35 horikawa Exp $ .Dd June 4, 1993 .Dt UTIMES 2 .Os .Sh 명칭 .Nm utimes , .Nm lutimes , .Nm futimes .Nd 파일 액세스 시각과 갱신 시각의 설정 .Sh 프로그램 라이브러리 .Lb libc .Sh 서식 .In sys/time.h .Ft int .Fn utimes "const char *path" "const struct timeval *times" .Ft int .Fn lutimes "const char *path" "const struct timeval *times" .Ft int .Fn futimes "int fd" "const struct timeval *times" .Sh 해설 .Fa path 그리고 지정한 파일인가 .Fa fd 하지만 참조하는 파일의 액세스 시각과 갱신 시각을, 인수 .Fa times 그리고 지정된 것처럼 변경합니다. .Pp .Fa times 하지만 .Dv NULL 인 경우, 액세스 시각과 갱신 시각은 현재의 시각으로 설정됩니다. 호출측은 파일의 소유자로 파일의 기록권이 있는지, 슈퍼 유저일 필요가 있습니다. .Pp .Fa times 하지만 NULL 이외인 경우, .Fa times (은)는 2 개의 timeval 구조체의 배열을 가리키고 있는 것이 전제가 됩니다. 액세스 시각은 최초의 요소에, 갱신 시각은 다음의 요소에 설정합니다. 소환측은 파일의 소유자일까 슈퍼 유저일 필요가 있습니다. .Pp 어느 쪽의 경우에서도, 파일의 inode 변경 시각은 현재의 시각으로 설정됩니다. .Pp .Fn lutimes (은)는 지정한 파일이 기호 연결 이외에서는 .Fn utimes (와)과 같습니다. 기호 연결의 경우 .Fn lutimes (은)는 링크의 액세스 시각과 갱신 시각을 변경하는데 대해, .Fn utimes (은)는 링크가 참조하는 파일의 시각을 변경합니다. .Sh 반환값 .Rv -std .Sh 에러 .Fn utimes (와)과 .Fn lutimes (은)는, 이하와 같은 경우에 에러가 됩니다. .Bl -tag -width Er .It Bq Er EACCES 지정된 패스에는, 검색이 허가되어 있지 않은 디렉토리가 포함되어 있습니다. 혹은 .Fa times 인수가 NULL 로, 프로세스의 실효 유저 ID 가 파일의 소유자와 일치하지 않고, 게다가 슈퍼 유저도 아니고, 기록 액세스가 거부되었습니다. .It Bq Er EFAULT .Fa path 또는 .Fa times (은)는, 프로세스에 할당할 수 있었던 address 공간의 범위외를 가리키고 있습니다. .It Bq Er EIO 변경되는 inode 의 읽기 쓰기의 사이에 입출력 에러가 발생했습니다. .It Bq Er ELOOP 패스명을 변환할 경우에 검출된 기호 연결이 너무 많습니다. .It Bq Er ENAMETOOLONG 패스명의 원가요소가 .Dv NAME_MAX 캐릭터를 넘고 있는지, 또는 패스명 전체 .Dv PATH_MAX 캐릭터를 넘고 있습니다. .It Bq Er ENOENT 지정한 파일이 존재하지 않습니다. .It Bq Er ENOTDIR 패스의 원가요소중에 디렉토리 이외의 것이 포함되어 있습니다. .It Bq Er EPERM .Fa times 인수가 눌이 아니고, 호출측 프로세스의 실효 유저 ID 가, 파일의 소유자와 일치하지 않고, 게다가 슈퍼 유저가 아닙니다. .It Bq Er EROFS 그 파일을 포함한 파일 시스템이, 읽기 전용으로 mount 되고 있습니다. .El .Pp .Fn futimes (은)는, 이하의 경우에 에러가 됩니다. .Bl -tag -width Er .It Bq Er EBADF .Fa fd 하지만, 유효한 기술자를 참조하고 있지 않습니다. .El .Pp 모든 함수는, 이하의 경우에 에러가 됩니다. .Bl -tag -width Er .It Bq Er EACCES .Fa times 인수가 .Dv 눌 (이어)여, 프로세스의 실효 유저 ID 가 파일의 소유자와 일치하지 않고, 게다가 슈퍼 유저도 아니고, 기록 액세스가 거부되었습니다. .It Bq Er EFAULT .Fa times (은)는, 프로세스에 할당할 수 있었던 address 공간의 범위외를 가리키고 있습니다. .It Bq Er EIO 변경되는 inode 의 읽고 쓰기중에 입출력 에러가 발생했습니다. .It Bq Er EPERM .Fa times 인수가 .Dv 눌 (이)가 아니고, 호출측 프로세스의 실효 유저 ID 가, 파일의 소유자와 일치하지 않고, 게다가 슈퍼 유저이기도 하지 않습니다. .It Bq Er EROFS 그 파일을 포함한 파일 시스템이 읽기 전용으로 mount 되고 있습니다. .El .Sh 관련 항목 .Xr stat 2 , .Xr utime 3 .Sh 역사 .Fn utimes 함수는 .Bx 4.2 그리고 등장했습니다. .Fn futimes 함수와 .Fn lutimes 함수는 .Fx 3.0 그리고 처음 등장했습니다.