Linux repositories inspector
Linux
15. September 2017
Aliases: unlinkat(2), unlinkat(2), unlinkat(2), unlinkat(2), unlinkat(2), unlinkat(2), unlinkat(2), unlinkat(2), unlinkat(2), unlinkat(2)

manpages-de-dev

German development manpages

man-pages-de

German Linux man pages

manpages-dev

Manual pages about using GNU/Linux for development

man-pages

Linux kernel and C library user-space interface documentation

BEZEICHNUNG

unlink, unlinkat - löscht einen Namen und unter Umständen die Datei, auf die dieser verweist

ÜBERSICHT

#include <unistd.h>

int unlink(const char *Pfadname);
#include <fcntl.h> /* Definition der AT_*-Konstanten */ #include <unistd.h>
int unlinkat(int dirfd, const char *Pfadname, int Schalter);
Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):
unlinkat():
Seit Glibc 2.10:
_POSIX_C_SOURCE >= 200809L
Vor Glibc 2.10:
_ATFILE_SOURCE

BESCHREIBUNG

unlink() löscht einen Namen aus dem Dateisystem. Falls dieser Name der letzte Link auf eine Datei war und kein Prozess die Datei geöffnet hält, wird sie gelöscht und der von ihr belegte Speicherplatz wird für die erneute Verwendung verfügbar gemacht.
Falls dieser Name der letzte Link auf die Datei war, aber diverse Prozesse die Datei noch geöffnet haben, bleibt die Datei bestehen, bis der letzte auf sie weisende Dateideskriptor gelöscht wird.
Falls der Name auf einen symbolischen Link verwies, so wird dieser Link entfernt.
Falls der Name auf einen Socket, FIFO oder Gerät verwies, so wird der Name dafür entfernt, aber Prozesse, die das Objekt geöffnet haben, können es weiterhin benutzen.

unlinkat()

Der Systemaufruf unlinkat() funktioniert genau wie entweder unlink() oder rmdir(2) (abhängig davon, ob Schalter den Schalter AT_REMOVEDIR enthält), außer den hier beschriebenen Unterschieden.
Falls der in Pfadname übergebene Pfadname relativ ist wird er relativ zu dem im Dateideskriptor dirfd referenzierten Verzeichnis interpretiert (statt relativ zum aktuellen Arbeitsverzeichnis des aufrufenden Prozesses, wie es bei unlink() und rmdir(2) für einen relativen Pfadnamen der Fall ist).
Falls der in Pfadname übergebene Pfadname relativ ist und dirfd den besonderen Wert AT_FDCWD enthält wird Pfadname relativ zum aktuellen Arbeitsverzeichnis des aufrufenden Prozesses interpretiert (wie bei unlink() und rmdir(2)).
Falls der in Pfadname übergebene Pfadname absolut ist, wird dirfd ignoriert.
Schalter ist eine Bitmaske, die entweder als 0 angegeben werden kann, oder mit durch logisches ODER verknüpften Werten der Schalter, die die Wirkung von unlinkat() steuern. Gegenwärtig wird nur ein einziger Schalter unterstützt:
AT_REMOVEDIR
Standardmäßig führt unlinkat() das Äquivalent von unlink() auf Pfadname aus. Falls der Schalter AT_REMOVEDIR angegeben ist, führt es das Äquivalent von rmdir(2) auf Pfadname aus.
Lesen Sie openat(2) für eine Beschreibung der Notwendigkeit von unlinkat().

RÜCKGABEWERT

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

FEHLER

Unzulänglichkeiten in dem NFS unterliegenden Protokoll können das unerwartete Verschwinden von Dateien, welche noch benötigt werden, verursachen.

VERSIONEN

unlinkat() wurde zu Linux in Kernel 2.6.16 hinzugefügt; Bibliotheksunterstützung wurde in Glibc in Version 2.4 hinzugefügt.

KONFORM ZU

unlink(): SVr4, 4.3BSD, POSIX.1-2001, POSIX.1-2008.
unlinkat(): POSIX.1-2008.

ANMERKUNGEN

Anmerkungen zur Glibc

Wenn in älteren Kerneln unlinkat() nicht verfügbar ist, weicht die Glibc-Wrapper-Funktion auf unlink() oder rmdir(2) aus. Wenn der Pfadname relativ ist, konstruiert die Glibc einen Pfadnamen, der auf dem symbolischen Link in /proc/self/fd basiert, der dem newdirfd-Argument entspricht.

KOLOPHON

Diese Seite ist Teil der Veröffentlichung 5.03 des Projekts Linux-man-pages. Eine Beschreibung des Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden sich unter https://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

Die deutsche Übersetzung dieser Handbuchseite wurde von Joern Vehoff <>, Martin Schulze <>, Martin Eberhard Schauer <>, Helge Kreutzmann <>, Mario Blättermann <> und Dr. Tobias Quathamer <> 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 <>.
⇧ Top