utime(2)

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

BIBLIOTHEEK
Standaard C bibliotheek (libc, -lc)

SAMENVATTING
#include <time.h>

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

#include <sys/time.h>

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

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

The utime() system call changes the access and modification times of the inode specified by path to the actime and modtime fields of times respectively. The status change time (ctime) will be set to the current time, even if the other time stamps don't actually change.

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

EFAULT
    path points to an invalid address.

ENOENT
    path does not exist.

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.

STANDAARDEN

utime()
    None.

utimes()
    POSIX.1-2024.

HISTORIE

utime()
    SVr4, POSIX.1-2001. Obsoleted in POSIX.1-2008. Removed in POSIX.1-2024.

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.