| | 1 | .Dd Aug 13, 2006 |
| | 2 | .Dt LUTIMES 3 |
| | 3 | .Os |
| | 4 | .Sh NAME |
| | 5 | .Nm lutimes |
| | 6 | .Nd set file access and modification times of symlink |
| | 7 | .Sh SYNOPSIS |
| | 8 | .In sys/time.h |
| | 9 | .Ft int |
| | 10 | .Fn lutimes "const char *path" "struct timeval times[2]" |
| | 11 | .Sh DESCRIPTION |
| | 12 | The access and modification times of the file named by |
| | 13 | .Fa path |
| | 14 | are changed as specified by the argument |
| | 15 | .Fa times , |
| | 16 | even if |
| | 17 | .Fa path |
| | 18 | specifies a symbolic link (for |
| | 19 | .Xr utimes 2 |
| | 20 | the times of the file referenced by the symbolic link are changed). |
| | 21 | .Pp |
| | 22 | If |
| | 23 | .Fa times |
| | 24 | is |
| | 25 | .Dv NULL , |
| | 26 | the access and modification times are set to the current time. |
| | 27 | The caller must be the owner of the file, have permission to |
| | 28 | write the file, or be the super-user. |
| | 29 | .Pp |
| | 30 | If |
| | 31 | .Fa times |
| | 32 | is |
| | 33 | .Pf non- Dv NULL , |
| | 34 | it is assumed to point to an array of two timeval structures. |
| | 35 | The access time is set to the value of the first element, and the |
| | 36 | modification time is set to the value of the second element. |
| | 37 | The caller must be the owner of the file or be the super-user. |
| | 38 | .Pp |
| | 39 | In either case, the inode-change-time of the file is set to the current |
| | 40 | time. |
| | 41 | .Sh NOTE |
| | 42 | Instead of being a system call, |
| | 43 | .Fn lutimes |
| | 44 | is emulated using |
| | 45 | .Xr setattrlist 2 . |
| | 46 | Not all file systems support |
| | 47 | .Xr setattrlist 2 . |
| | 48 | .Sh RETURN VALUES |
| | 49 | Upon successful completion, a value of 0 is returned. |
| | 50 | Otherwise, -1 is returned and the global variable |
| | 51 | .Va errno |
| | 52 | is set to indicate the error. |
| | 53 | .Sh ERRORS |
| | 54 | The |
| | 55 | .Fn lutimes |
| | 56 | call may return the same errors as |
| | 57 | .Xr utimes 2 |
| | 58 | and |
| | 59 | .Xr setattrlist 2 . |
| | 60 | .Sh SEE ALSO |
| | 61 | .Xr utimes 2 , |
| | 62 | .Xr setattrlist 2 |
projects / apple / libc.git / blame_incremental