UTIME(2)

NAAM
utime, utimes - verander toegangs en/of wijzigings tijden van een bestand

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

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

#include <sys/time.h>

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

BESCHRIJVING
OPMERKING: moderne applicaties zouden beter de interfaces gebruiken zoals beschreven in utimensat(2).

utime() veranderd de toegangs- en wijzigingstijden van een inode, opgegeven in bestandsnaam naar respectievelijk de actime en modtime velden van buf.

Als buf NULL is, dan worden de toegangs- en wijzigingstijden van het bestand naar de huidige tijd gezet.

Het veranderen van tijdstempels is toegestaan indien: of het proces heeft passende rechten, of het effectieve gebruiker ID is gelijk aan het gebruiker ID van het bestand, of times is NULL en het proces heeft schrijfrechten voor het bestand.

De utimbuf structuur is:

    struct utimbuf {
        time_t actime;       /* toegangs tijd */
        time_t modtime;      /* wijziging tijd */
    };

De utime() systeem aanroep staat specificatie van de tijdstempels met een resolutie van 1 seconde toe.

De utimes() systeem aanroep is vergelijkbaar, maar het times argument verwijst naar een tabel in plaats van een structure. De elementen van de tabel zijn timeval structures, die toestaan de precisie van tijdstempels met 1 microseconde op te geven. De timeval structure is:

    struct timeval {
        long tv_sec;        /* seconden */
        long tv_usec;       /* microseconden */
    };

times[0] specificeert de nieuwe toegangstijd, en times[1] specificeert te nieuwe wijzigingstijd. Als times gelijk is aan NULL, dan worden analoog aan utime(), de toegangs- en wijzigingstijd van het bestand gezet op de huidige tijd.

EIND WAARDE
Bij succes wordt nul teruggegeven. Bij falen wordt -1 teruggegeven en wordt errno overeenkomstig gezet.

FOUTEN

EACCES
    Zoek rechten werden geweigerd voor een van de mappen in het pad voorvoegsel van pad (zie ook path_resolution(7)).

EACCES
    times is NULL, de effectieve gebruiker ID komt niet overeen met de eigenaar van het bestand, de aanroeper heeft geen schrijfrechten naar het bestand en de aanroeper is niet gerechtigd (Linux: heeft ofwel de CAP_DAC_OVERRIDE ofwel de CAP_FOWNER capaciteit niet).

ENOENT
    bestandsnaam bestaat niet.

EPERM
    times is niet NULL, de effectieve gebruiker ID komt niet overeen met de eigenaar van het bestand, de aanroeper is niet gerechtigd (Linux: heeft ofwel de de CAP_FOWNER capaciteit niet).

EROFS
    pad verblijft op een alleen-lezen bestandsysteem.

VOLDOET AAN
utime(): SVr4, POSIX.1-2001. POSIX.1-2008 markeert utime() als verouderd.

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

OPMERKINGEN
Linux staat niet toe tijdstempels op een onveranderlijk bestand te veranderen, of het zetten van tijdstempels op iets anders dan de huidige tijd op een alleen-toevoegen bestand.

ZIE OOK
chattr(1), touch(1), futimesat(2), stat(2), utimensat(2), futimens(3), futimes(3), inode(7)

COLOFON
Deze pagina is onderdeel van release 5.11 van het Linux man-pages-project. Een beschrijving van het project, informatie over het melden van bugs en de nieuwste versie van deze pagina zijn op https://www.kernel.org/doc/man-pages/ te vinden.

VERTALING
De Nederlandse vertaling van deze handleiding is geschreven door Jos Boersema <joshb@xs4all.nl>, Mario Blättermann <mario.blaettermann@gmail.com> en Luc Castermans <luc.castermans@gmail.com> Deze vertaling is vrije documentatie; lees de GNU General Public License Version 3 (https://www.gnu.org/licenses/gpl-3.0.html) of later over de Copyright-voorwaarden. Er is geen AANSPRAKELIJKHEID. Indien U fouten in de vertaling van deze handleiding zou vinden, stuur een e-mail naar debian-l10n-dutch@lists.debian.org.