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

       POSIX.1-2008.

GESCHIEDENIS

       utime()
              SVr4, POSIX.1-2001. POSIX.1-2008 markeert het 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 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 man-pagina's 6.9.1                           2 mei 2024                                           utime(2)