utime(2)

NAVN
utime, utimes - ændr filers tidspunkter for tilgået og ændret

BIBLIOTEK
C-standardbibliotek (libc, -lc)

SYNOPSIS
#include <utime.h>

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

#include <sys/time.h>

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

BESKRIVELSE
Note: moderne programmer kan foretrække at bruge grænsefladerne beskrevet i utimensat(2).

Systemkaldet utime() ændrer tidspunkterne for tilgået og ændret for iknuden angivet af sti til actime- modtime-felterne for times respektivt. Statusændringstidspunktet (ctime) vil blive angivet til den aktuelle tid, selv om andre tidsstempler ikke ændrer sig.

Hvis times er NULL, så er tidspunkterne for tilgået og ændret for filerne angivet til det aktuelle tidspunkt.

Ændring af tidsstempler er tilladt når: enten processen har passende privilegier eller det effektive bruger-id svarer til bruger-id'et for filen, eller times er NULL og processen har skriverettighed på filen.

utimbuf-strukturen er:

    struct utimbuf {
        time_t actime;       /* tilgået */
        time_t modtime;      /* ændret */
    };

Systemkaldet utime() tillader specifikation af tidsstemperl med en opløsning på 1 sekund.

Systemkaldet utimes() svarer til, men argumentet times refererer til en tabel frem for en struktur. Elementerne for denne tabel er timeval- strukturer, der tillader en præcision på 1 mikrosekund for angivelse af tidsstempler. Strukturen timeval er:

    struct timeval {
        long tv_sec;        /* sekunder */
        long tv_usec;       /* mikrosekunder */
    };

times[0] angiver det nye tilgået tidspunkt og times[1] angiver det nye tidspunkt for ændret. Hvis times er NULL, så analogt til utime(), så angives tidspunkterne for tilgået og ændret på filen til det aktuelle tidspunkt.

RETURVÆRDI
Ved succes returneres nul. Ved fejl returneres -1 og errno angives for at indikere fejlen.

FEJL

EACCES
    Søgetilladelse er nægtet for en af mapperne i stipræfikset for sti (se også path_resolution(7)).

EACCES
    times er NULL, kalderens effektive bruger-id matcher ikke filejeren, kalderen har ikke skriveadgang til filen og kalderen er ikke privilegeret Linux: har ingen af kapaciteterne CAP_DAC_OVERRIDE eller CAP_FOWNER).

EFAULT
    sti peger på en ugyldig adresse.

ENOENT
    sti findes ikke.

EPERM
    times er ikke NULL, kalderens effektive UID matcher ikke filejeren, og kalderen er ikke privilegeret (Linux: har ikke kapaciteten CAP_FOWNER).

EROFS
    sti befinder sig på et skrivebeskyttet filsytem.

STANDARDER

utime()
    Ingen.

utimes()
    POSIX.1-2024.

HISTORIK

utime()
    SVr4, POSIX.1-2001. Forældet i POSIX.1-2008. Fjernet i POSIX.1-2024.

utimes()
    4.3BSD, POSIX.1-2001.

NOTER
Linux tillader ikke ændring af tidsstemper på en uforanderlig fil eller angivelse af tidsstempler på noget udover det aktuelle tidspunkt eller en tilføj-kun fil.

SE OGSÅ
chattr(1), touch(1), futimesat(2), stat(2), utimensat(2), futimens(3), futimes(3), inode(7)

OVERSÆTTELSE
Oversættere af denne manual til dansk Joe Hansen <joedalton2@yahoo.dk>

Denne oversættelse er gratis dokumentation; læs GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) eller nyere for ophavsretbetingelser. Der er INGEN ANSVAR.

Hvis du støder på fejl i oversættelsen af ​​denne vejledning, skal du sende en besked til debian-l10n-danish@lists.debian.org.