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.10 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  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.

Linux                                           15 september 2017                                       UTIME(2)