BEZEICHNUNG

       utime, utimes - letzte Dateizugriffs- und -änderungszeiten ändern

ÜBERSICHT

       #include <sys/types.h>
       #include <utime.h>

       int utime(const char *dateiname, const struct utimbuf *zeiten);

       #include <sys/time.h>

       int utimes(const char *dateiname, const struct timeval zeiten[2]);

BESCHREIBUNG

       Der  Systemaufruf  utime  ändert die Zugriffs- und Änderungszeiten des durch dateiname angegebenen Inodes
       auf die Felder actime beziehungsweise modtime von zeiten.

       Falls zeiten NULL ist, werden die Zugriffs- und Änderungszeiten der Datei auf die aktuelle Zeit gesetzt.

       Das Ändern von Zeitstempeln ist  erlaubt,  wenn  entweder  der  Prozess  entsprechende  Rechte  hat,  die
       effektive  Benutzer-ID  der  Benutzer-ID  der  Datei  entpricht  oder zeiten NULL ist und der Prozess das
       Schreibrecht für die Datei besitzt.

       Die Struktur utimbuf hat folgenden Aufbau:

           struct utimbuf {
                   time_t actime;  /* Zugriffszeit */
                   time_t modtime; /* Änderungszeit */
           };

       Der Systemaufruf utime() erlaubt die Angabe von Zeitstempeln mit einer Genauigkeit von einer Sekunde.

       Der Systemaufruf utimes() ist ähnlich, aber das Argument zeiten bezieht sich auf ein Feld statt auf  eine
       Struktur.  Die Elemente dieses Feldes sind timeval-Strukturen, die eine Genauigkeit von Mikrosekunden für
       die Angabe von Zeitstempeln ermöglichen. Die Struktur timeval hat folgenden Aufbau:

           struct timeval {
                   long    tv_sec;         /* Sekunden */
                   long    tv_usec;        /* Mikrosekunden */
           };

       zeiten[0] gibt die neue Zugriffszeit an und zeiten[1] die neue  Änderungszeit.  Falls  zeiten  NULL  ist,
       werden wie bei utime() die Zugriffs- und Änderungszeiten der Datei auf die aktuelle Zeit gesetzt.

RÜCKGABEWERT

       Bei  Erfolg  wird  Null  zurückgegeben.  Bei  einem  Fehler  wird -1 zurückgegeben und errno entsprechend
       gesetzt.

FEHLER

       EACCES In einem oder mehreren Verzeichnissen im Pfad-Präfix von  pfad  wurde  die  Erlaubnis  zum  Suchen
              verweigert.

       EACCES zeiten  ist  NULL, die effektive Benutzer-ID des Aufrufenden entspricht nicht dem Dateieigentümer,
              der Aufrufende hat kein Schreibrecht für die Datei  und  der  Aufrufende  ist  nicht  privilegiert
              (Linux: ihm fehlt entweder die CAP_DAC_OVERRIDE- oder die CAP_FOWNER-Fähigkeit).

       ENOENT dateiame existiert nicht.

       EPERM  zeiten   ist   nicht  NULL,  die  effektive  Benutzer-ID  des  Aufrufenden  entspricht  nicht  dem
              Dateieigentümer  und   der   Aufrufende   ist   nicht   privilegiert   (Linux:   ihm   fehlt   die
              CAP_FOWNER-Fähigkeit).

       EROFS  pfad liegt auf einem Dateisystem mit reinem Lesezugriff.

KONFORM ZU

       utime(): SVr4, POSIX.1-2001. POSIX.1-2008 kennzeichnet utime() als veraltet.
       utimes(): 4.3BSD, POSIX.1-2001.

ANMERKUNGEN

       Linux  erlaubt  es  nicht,  dass  Zeitstempel einer unveränderlichen Datei geändert werden oder bei einer
       Datei, an die nur etwas angehängt werden darf, die Zeitstempel auf etwas anderes als  die  aktuelle  Zeit
       geändert werden.

       In  Libc4 und Libc5 ist utimes() nur ein Wrapper für utime() und erlaubt daher keine Auflösung auf Zeiten
       kleiner einer Sekunde.

SIEHE AUCH

       chattr(1), futimesat(2), stat(2), utimensat(2), futimens(3), futimes(3)

KOLOPHON

       This page is part of release 3.54 of the Linux man-pages project.  A  description  of  the  project,  and
       information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die  deutsche  Übersetzung  dieser  Handbuchseite  wurde  von  Patrick Rother <krd@gulu.net>, Chris Leick
       <c.leick@vollbio.de> und Mario Blättermann <mario.blaettermann@gmail.com> erstellt.

       Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder  neuer
       bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.

       Wenn  Sie  Fehler  in  der  Übersetzung  dieser  Handbuchseite  finden, schicken Sie bitte eine E-Mail an
       <debian-l10n-german@lists.debian.org>.

Linux                                            6. August 2008                                         UTIME(2)