utime(2) System Calls Manual utime(2) BEZEICHNUNG utime, utimes - letzte Dateizugriffs- und -anderungszeiten andern BIBLIOTHEK Standard-C-Bibliothek (libc, -lc) UBERSICHT #include int utime(const char *dateiname, const struct utimbuf *_Nullable zeiten); #include int utimes(const char *dateiname, const struct timeval zeiten[_Nullable 2]); BESCHREIBUNG Hinweis: Moderne Anwendungen konnten es bevorzugen, die in utimensat(2) beschriebenen Schnittstellen zu benutzen. Der Systemaufruf utime andert die Zugriffs- und Anderungszeiten des durch dateiname angegebenen Inodes auf die Felder actime beziehungsweise modtime von zeiten. Die Statusanderungszeit (ctime) wird auf die aktuelle Zeit gesetzt, selbst wenn die anderen Zeitstempel nicht geandert werden. 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 Benutzerkennung der Benutzerkennung 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. RUCKGABEWERT Bei Erfolg wird Null zuruckgegeben. Bei einem Fehler wird -1 zuruckgegeben und errno gesetzt, um den Fehler anzuzeigen. FEHLER EACCES In einem oder mehreren Verzeichnissen im Pfad-Prafix von pfad wurde die Erlaubnis zum Suchen verweigert. EACCES zeiten ist NULL, die effektive Benutzerkennung 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-Capability). ENOENT dateiame existiert nicht. EPERM zeiten ist nicht NULL, die effektive UID des Aufrufenden entspricht nicht dem Dateieigentumer und der Aufrufende ist nicht privilegiert (Linux: ihm fehlt die CAP_FOWNER-Capability). EROFS pfad liegt auf einem Dateisystem mit reinem Lesezugriff. STANDARDS POSIX.1-2008. GESCHICHTE utime() SVr4, POSIX.1-2001. POSIX.1-2008 kennzeichnet es 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. SIEHE AUCH chattr(1), touch(1), futimesat(2), stat(2), utimensat(2), futimens(3), futimes(3), inode(7) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Patrick Rother , Chris Leick und Mario Blattermann 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 die Mailingliste der Ubersetzer . Linux man-pages 6.9.1 2. Mai 2024 utime(2)