Scroll to navigation

UTIME(2) Linux Programmeurs Handleiding 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.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.

15 september 2017 Linux