BSD 4_4 development
[unix-history] / usr / share / man / cat3 / utime.0
UTIME(3) BSD Programmer's Manual UTIME(3)
N\bNA\bAM\bME\bE
u\but\bti\bim\bme\be - set file times
S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/t\bty\byp\bpe\bes\bs.\b.h\bh>\b>
#\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<u\but\bti\bim\bme\be.\b.h\bh>\b>
_\bi_\bn_\bt
u\but\bti\bim\bme\be(_\bc_\bo_\bn_\bs_\bt _\bc_\bh_\ba_\br _\b*_\bf_\bi_\bl_\be, _\bc_\bo_\bn_\bs_\bt _\bs_\bt_\br_\bu_\bc_\bt _\bu_\bt_\bi_\bm_\bb_\bu_\bf _\b*_\bt_\bi_\bm_\be_\bp);
D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
T\bTh\bhi\bis\bs i\bin\bnt\bte\ber\brf\bfa\bac\bce\be i\bis\bs o\bob\bbs\bso\bol\ble\bet\bte\bed\bd b\bby\by u\but\bti\bim\bme\bes\bs(\b(2\b2)\b) .\b.
The u\but\bti\bim\bme\be() function sets the access and modification times of the named
file from the structures in the argument array _\bt_\bi_\bm_\be_\bp.
If the times are specified (the _\bt_\bi_\bm_\be_\bp argument is non-NULL) the caller
must be the owner of the file or be the super-user.
If the times are not specified (the _\bt_\bi_\bm_\be_\bp argument is NULL) the caller
must be the owner of the file, have permission to write the file, or be
the super-user.
E\bER\bRR\bRO\bOR\bRS\bS
The u\but\bti\bim\bme\be() function may fail and set _\be_\br_\br_\bn_\bo for any of the errors speci-
fied for the library function utimes(2).
S\bSE\bEE\bE A\bAL\bLS\bSO\bO
utimes(2), stat(2)
H\bHI\bIS\bST\bTO\bOR\bRY\bY
A u\but\bti\bim\bme\be() function appeared in Version 7 AT&T UNIX.
S\bST\bTA\bAN\bND\bDA\bAR\bRD\bDS\bS
The u\but\bti\bim\bme\be function conforms to IEEE Std1003.1-1988 (``POSIX'').
4th Berkeley Distribution June 4, 1993 1