BEZEICHNUNG¶

ÜBERSICHT¶

#include <stdio.h>

int rename(const char *oldpath, const char *newpath);
#include <fcntl.h>           /* Definition der AT_*-Konstanten */
#include <stdio.h>

int renameat(int olddirfd, const char *oldpath,
             int newdirfd, const char *newpath);

int renameat2(int olddirfd, const char *oldpath,
              int newdirfd, const char *newpath, unsigned int flags);

Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

renameat():

renameat2():

BESCHREIBUNG¶

Verschiedene Einschränkungen bestimmen, ob die Umbenennungsaktion erfolgreich ist oder nicht; siehe FEHLER unten.

Falls newpath schon existiert, wird er in einem atomaren Schritt überschrieben, so dass ein anderer Prozess jederzeit auf newpath zugreifen kann. Allerdings wird es wahrscheinlich ein Fenster geben, in dem sowohl oldpath als auch newpath sich auf die umzubenennende Datei beziehen.

Falls oldpath und newpath bestehende Hard Links zu derselben Datei sind, tut rename() nichts und meldet eine erfolgreiche Ausführung.

Wenn newpath schon existiert, aber das Umbenennen aus irgendeinem Grund fehlschlägt, garantiert rename(), dass newpath an Ort und Stelle erhalten bleibt.

oldpath kann ein Verzeichnis angeben. In diesem Fall darf newpath nicht existieren oder muss ein leeres Verzeichnis angeben.

Falls oldpath auf einen symbolischen Link zeigt, wird der Link umbenannt; falls newpath auf einen symbolischen Link zeigt, wird der Link überschrieben.

RÜCKGABEWERT¶

FEHLER¶

EACCES

Für das Verzeichnis, das oldpath oder newpath enthält, wurden Schreibrechte verweigert oder für eines der Verzeichnisse im Pfad-Präfix von oldpath oder newpath wurde nicht gestattet, dort zu suchen oder oldpath ist ein Verzeichnis und verwehrt die Schreiberlaubnis (benötigt, um den Eintrag .. zu aktualisieren). (Siehe auch path_resolution(7).)

EBUSY

Das Umbenennen scheitert, weil oldpath oder newpath ein Verzeichnis ist, das von einem anderen Prozess (vielleicht als aktuelles Arbeitsverzeichnis oder als Wurzelverzeichnis oder weil es zum Lesen geöffnet ist) oder vom System genutzt wird (zum Beispiel als Einhängepunkt) und das System dies als Fehler betrachtet. (Beachten Sie, dass es keine Verpflichtung gibt, in solchen Fällen EBUSY zurückzugeben – es ist nichts falsch daran, die Umbenennung trotzdem durchzuführen – aber es ist erlaubt, EBUSY zurückzugeben, wenn das System solche Situationen nicht anderweitig verarbeiten kann.)

EDQUOT

Das Plattenkontingent (Quota) des Benutzers an Plattenblöcken auf dem Dateisystem ist erschöpft.

EFAULT

alterpfad oder neuerpfad zeigt aus dem für Sie zugänglichen Adressraum heraus.

EINVAL

Der neue Pfadname enthielt ein Pfad-Präfix des alten, oder allgemeiner, es wurde versucht, ein Verzeichnis als Unterverzeichnis von sich selbst zu erzeugen.

EISDIR

newpath ist ein existierendes Verzeichnis, aber oldpath ist kein Verzeichnis.

ELOOP

Bei der Auflösung von oldpath oder newpath wurden zu viele symbolische Links gefunden.

EMLINK

oldpath hat schon die maximale Anzahl Links, oder es war ein Verzeichnis und das Verzeichnis, welches newpath enthält, hat schon die maximale Anzahl Links.

ENAMETOOLONG

oldpath oder newpath war zu lang.

ENOENT

Der von oldpath angegebene Link existiert nicht oder eine Verzeichniskomponente von newpath existiert nicht oder oldpath oder newpath ist eine leere Zeichenkette.

ENOMEM

Es war nicht genügend Kernelspeicher verfügbar.

ENOSPC

Das Gerät, das die die Datei enthält, hat keinen Platz für einen neuen Verzeichniseintrag.

ENOTDIR

Eine als Verzeichnis benutzte Komponente von oldpath oder newpath ist in der Tat kein Verzeichnis. Oder oldpath ist ein Verzeichnis und newpath existiert, ist aber kein Verzeichnis.

ENOTEMPTY oder EEXIST

newpath ist ein nicht leeres Verzeichnis, d.h. es enthält außer ».« und »..« weitere Einträge.

EPERM oder EACCES

Das Verzeichnis, das oldpath enthält, hat das Sticky-Bit (S_ISVTX) gesetzt und die effektive Benutzerkennung des Prozesses ist weder die Benutzerkennung der zu löschenden Datei noch die des beinhaltenden Verzeichnisses und der Prozess ist nicht privilegiert (Linux: verfügt nicht über die CAP_FOWNER-Capability); oder newpath ist eine vorhandene Datei und ihr übergeordnetes Verzeichnis hat das Sticky-Bit gesetzt und die effektive Benutzerkennung des Prozesses ist weder die Benutzerkennung der zu ersetzenden Datei noch des beherbergenden Verzeichnisses und der Prozess ist nicht privilegiert (Linux: verfügt nicht über die CAP_FOWNER-Capability) oder das pathname beherbergende Dateisystem unterstützt nicht die Umbenennung des angeforderten Typs.

EROFS

Die Datei befindet sich auf einem nur lesbaren Dateisystem.

EXDEV

oldpath und newpath befinden sich nicht auf demselben eingehängten Dateisystem. (Linux erlaubt es Dateisystemen, an mehreren Stellen eingehängt zu sein, aber rename() funktioniert nicht über verschiedene Einhängepunkte hinweg, selbst falls dasselbe Dateisystem an beiden Stellen eingehängt ist.)

Die folgenden zusätzlichen Fehler können bei renameat() und renameat2() auftreten:

EBADF

olddirfd oder newdirfd ist kein zulässiger Dateideskriptor.

ENOTDIR

oldpath ist relativ und olddirfd ist ein Dateideskriptor, der sich auf eine Datei bezieht, die kein Verzeichnis ist; gilt analog für newpath and newdirfd.

Die folgenden zusätzlichen Fehler können bei renameat2() auftreten:

EEXIST

flags enthält RENAME_NOREPLACE und newpath existiert bereits.

EINVAL

In flags wurde ein ungültiger Schalter angegeben.

EINVAL

Sowohl RENAME_NOREPLACE als auch RENAME_EXCHANGE wurden in flags angegeben.

EINVAL

Sowohl RENAME_WHITEOUT als auch RENAME_EXCHANGE wurden in flags angegeben.

EINVAL

Das Dateisystem unterstützt einen der Schalter in flags nicht.

ENOENT

flags enthält RENAME_EXCHANGE und newpath existiert nicht.

EPERM

RENAME_WHITEOUT wurde in flags angegeben, aber der Aufrufende verfügte nicht über die Capability CAP_MKNOD.

VERSIONEN¶

renameat2() wurde zu Linux in Kernel 3.15 hinzugefügt; Bibliotheksunterstützung wurde zu Glibc 2.28 hinzugefügt.

KONFORM ZU¶

renameat(): POSIX.1-2008.

renameat2() ist Linux-spezifisch.

ANMERKUNGEN¶

FEHLER¶

SIEHE AUCH¶

KOLOPHON¶

ÜBERSETZUNG¶

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 die Mailingliste der Übersetzer.