Provided by: manpages-de-dev_0.10-1_all bug

BEZEICHNUNG
       utime, utimes - letzte Dateizugriffs- und -anderungszeiten andern


"UBERSICHT
       #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  andert  die Zugriffs- und Anderungszeiten des
       durch   dateiname   angegebenen   Inodes   auf   die   Felder    actime
       beziehungsweise modtime von zeiten.

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

       Das Andern 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
       fur die Datei besitzt.

       Die Struktur utimbuf hat folgenden Aufbau:

           struct utimbuf {
                   time_t actime;  /* Zugriffszeit */
                   time_t modtime; /* Anderungszeit */
           };

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

       Der Systemaufruf utimes() ist ahnlich, 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 fur die
       Angabe von Zeitstempeln ermoglichen. 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
       Anderungszeit.  Falls  zeiten  NULL  ist,  werden  wie  bei utime() die
       Zugriffs- und Anderungszeiten der Datei auf die aktuelle Zeit gesetzt.


R"UCKGABEWERT
       Bei  Erfolg  wird  Null  zuruckgegeben.  Bei  einem  Fehler   wird   -1
       zuruckgegeben und errno entsprechend gesetzt.


FEHLER
       EACCES In  einem  oder  mehreren Verzeichnissen im Pfad-Prafix von pfad
              wurde die Erlaubnis zum Suchen verweigert.

       EACCES zeiten ist  NULL,  die  effektive  Benutzer-ID  des  Aufrufenden
              entspricht  nicht  dem  Dateieigentumer, der Aufrufende hat kein
              Schreibrecht  fur  die  Datei  und  der  Aufrufende  ist   nicht
              privilegiert  (Linux:  ihm  fehlt entweder die CAP_DAC_OVERRIDE-
              oder die CAP_FOWNER-Fahigkeit).

       ENOENT dateiame existiert nicht.

       EPERM  zeiten ist nicht NULL, die effektive Benutzer-ID des Aufrufenden
              entspricht  nicht  dem  Dateieigentumer  und  der Aufrufende ist
              nicht privilegiert (Linux: ihm fehlt die CAP_FOWNER-Fahigkeit).

       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 unveranderlichen Datei
       geandert werden oder bei einer Datei, an die nur etwas angehangt werden
       darf,  die Zeitstempel auf etwas anderes als die aktuelle Zeit geandert
       werden.

       In Libc4 und Libc5 ist utimes() nur ein Wrapper fur utime() und erlaubt
       daher keine Auflosung auf Zeiten kleiner einer Sekunde.


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


KOLOPHON
       Diese   Seite   ist   Teil   der  Veroffentlichung  3.32  des  Projekts
       Linux-man-pages. Eine Beschreibung des Projekts und Informationen,  wie
       Fehler     gemeldet     werden     konnen,     finden     sich    unter
       http://www.kernel.org/doc/man-pages/.


"UBERSETZUNG
       Die deutsche Ubersetzung dieser Handbuchseite wurde von Patrick  Rother
       <krd@gulu.net> und Chris Leick <c.leick@vollbio.de> erstellt.

       Diese  Ubersetzung  ist  Freie Dokumentation; lesen Sie die GNU General
       Public  License  Version  3  oder  neuer   bezuglich   der   Copyright-
       Bedingungen. Es wird KEINE HAFTUNG ubernommen.

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