NAAM

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

BIBLIOTHEEK

       Standard C bibliotheek  (libc, -lc)

SAMENVATTING

       #include <time.h>

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

       #include <sys/time.h>

       int utimes(const char *bestandsnaam,
                 const struct timeval times[_NULL_baar 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 times. De status change
       time (ctime) wordt gezet op het huidige tijdstip, zelfs als de  andere  tijdstempel,  niet
       daadwerkelijk verandert.

       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)

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