LINK(2)

BEZEICHNUNG
link, linkat - make a new name for a file

ÜBERSICHT
#include <unistd.h>

int link(const char *alterpfad, const char *neuerpfad);

#include <fcntl.h>           /* Definition der AT_*-Konstanten */
#include <unistd.h>

int linkat(int olddirfd, const char *alterpfad,
           int newdirfd, const char *neuerpfad, int Schalter);

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

linkat():
    Seit Glibc 2.10:
        _XOPEN_SOURCE >= 700 || _POSIX_C_SOURCE >= 200809L
    Bis Glibc 2.10:
        _ATFILE_SOURCE

BESCHREIBUNG
link erzeugt einen neuen Verweis (auch bekannt als harter Verweis) auf eine bestehende Datei. Wenn newpath existiert, wird es nicht überschrieben. Dieser neue Name kann genauso wie der alte Name für alle Aktionen benutzt werden. Beide Namen zeigen auf die gleiche Datei (haben somit die gleichen Rechte und Eigentümer) und es ist unmöglich festzustellen, welcher Name das »Original« ist.

  linkat()
Der Systemaufruf linkat() funktioniert genau wie link() außer den hier beschriebenen Unterschieden. Falls der an alterpfad übergebene Pfadname relativ ist wird er relativ zu dem von dem Dateideskriptor olddirfd referenzierten Verzeichnis interpretiert (statt relativ zu dem aktuellen Arbeitsverzeichnis des aufrufenden Prozesses, wie es bei link() für einen relativen Pfadnamen erfolgt). Falls alterpfad relativ ist und olddirfd den besonderen Wert AT_FDCWD annimmt wird alterpfad als relativ zu dem aktuellen Arbeitsverzeichnis des aufrufenden Prozesses interpretiert (wie link()). Falls alterpfad absolut ist wird olddirfd ignoriert. Die Interpretation von neuerpfad ist wie bei alterpfad, außer dass ein relativer Pfadname als relativ zu dem durch den Dateideskriptor newdirfd referenzierten Verzeichnis interpretiert wird. The following values can be bitwise ORed in flags:

AT_EMPTY_PATH (seit Linux 2.6.39)
    If oldpath is an empty string, create a link to the file referenced by olddirfd (which may have been obtained using the open(2) O_PATH flag). In this case, olddirfd can refer to any type of file, not just a directory. This will generally not work if the file has a link count of zero (files created with O_TMPFILE and without O_EXCL are an exception). The caller must have the CAP_DAC_READ_SEARCH capability in order to use this flag. This flag is Linux-specific; define _GNU_SOURCE to obtain its definition.

AT_SYMLINK_FOLLOW (seit Linux 2.6.18)
    By default, linkat(), does not dereference oldpath if it is a symbolic link (like link()). The flag AT_SYMLINK_FOLLOW can be specified in flags to cause oldpath to be dereferenced if it is a symbolic link. If procfs is mounted, this can be used as an alternative to AT_EMPTY_PATH, like this:
    linkat(AT_FDCWD, "/proc/self/fd/<fd>", newdirfd,
           newname, AT_SYMLINK_FOLLOW);

Vor Kernel 2.6.18 wurde das Argument Schalter nicht verwandt und musste als 0 angegeben werden.

Lesen Sie openat(2) für die Erklärung der Notwendigkeit für linkat().

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

FEHLER

EACCES
    Es besteht kein Schreibzugriff auf das Verzeichnis, das neuerpfad enthält oder es besteht kein Suchzugriff für eines der Verzeichnisse im Pfad-Präfix von neuerpfad oder alterpfad. (Siehe auch path_resolution(7).)

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

EEXIST
    newpath ist schon vorhanden.

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

EIO Es ist ein E/A-Fehler (engl. I/O) aufgetreten.

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

EMLINK
    Die Datei, auf die alterpfad zeigt, hat schon die maximale Anzahl Verweise.

ENAMETOOLONG
    oldpath oder newpath war zu lang.

ENOENT
    Eine Verzeichniskomponente in alterpfad oder neuerpfad existiert nicht oder ist ein toter symbolischer Verweis.

ENOMEM
    Es war nicht genügend Kernel-Speicher verfügbar.

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

ENOTDIR
    Eine Komponente, die in alterpfad oder neuerpfad als Verzeichnis benutzt wird, ist tatsächlich gar kein Verzeichnis.

EPERM
    alterpfad ist ein Verzeichnis.

EPERM
    Das Dateisystem, welches alterpfad und neuerpfad beinhaltet, unterstützt nicht das Erzeugen von harten Verweisen.

EPERM (seit Linux 3.6)
    Der Aufrufende hat nicht das Recht, einen harten Verweis auf diese Datei zu erstellen. (Lesen Sie die Beschreibung von /proc/sys/fs/protected_hardlinks in proc(5).)

EROFS
    Die Datei befindet sich auf einem nur lesbaren Dateisystem.

EXDEV
    alterpfad und neuerpfad befinden sich nicht auf dem gleichen eingehängten Dateisystem. (Linux erlaubt es, ein Dateisystem an mehreren Punkten einzuhängen, aber link() funktioniert nicht über mehrere unterschiedliche Einhängepunkte hinweg, selbst wenn das gleiche Dateisystem an beiden eingehängt ist.)

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

EBADF
    olddirfd oder newdirfd ist kein zulässiger Dateideskriptor.

EINVAL
    In Schalter wurde ein ungültiger Schalterwert angegeben.

ENOENT
    AT_EMPTY_PATH wurde in Schalter angegeben, aber der Aufrufende hatte nicht die Capability CAP_DAC_READ_SEARCH.

ENOENT
    An attempt was made to link to the /proc/self/fd/NN file corresponding to a file descriptor created with
        open(path, O_TMPFILE | O_EXCL, mode); Siehe open(2).

ENOENT
    oldpath is a relative pathname and olddirfd refers to a directory that has been deleted, or newpath is a relative pathname and newdirfd refers to a directory that has been deleted.

ENOTDIR
    oldpath is relative and olddirfd is a file descriptor referring to a file other than a directory; or similar for newpath and newdirfd

EPERM
    AT_EMPTY_PATH wurde in flags angegeben, oldpath ist eine leere Zeichenkette und olddirfd bezieht sich auf ein Verzeichnis.

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

KONFORM ZU
link(): SVr4, 4.3BSD, POSIX.1-2001 (lesen Sie aber auch die ANMERKUNGEN), POSIX.1-2008. linkat(): POSIX.1-2008.

ANMERKUNGEN
Harte Verweise, wie sie mit link() erstellt werden, können sich nicht über mehrere Dateisysteme erstrecken. Benutzen Sie symlink(2), falls nötig. POSIX.1-2001 legt fest, dass link() alterpfad zurückverfolgen sollte, wenn es ein symbolischer Verweis ist. Seit Kernel 2.0 tut Linux dies jedoch nicht: Wenn alterpfad ein symbolischer Verweis ist, dann wird neuerpfad als (harter) Verweis auf die gleiche symbolische Verweisdatei erstellt (d.h. neuerpfad bekommt einen symbolischen Verweis auf die gleiche Datei, auf die sich alterpfad bezieht). Einige andere Implementierungen verhalten sich ebenso wie Linux. POSIX.1-2008 ändert die Spezifikation von link(), indem es sie von der Implementierung abhängig macht, egal ob alterpfad zurückverfolgt wird, wenn es ein symbolischer Verweis ist, oder nicht. Für präzise Steuerung der Behandlung symbolischer Verweise bei ihrer Erstellung verwenden Sie linkat(2).

FEHLER
Auf NFS-Dateisystemen kann der Rückgabewert falsch sein, wenn der NFS-Server beim Erzeugen des Verweises abbricht. Prüfen Sie mit stat(2), ob der Verweis angelegt wurde.

SIEHE AUCH
ln(1), open(2), rename(2), stat(2), symlink(2), unlink(2), path_resolution(7), symlink(7)

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

ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Elmar Jansen <ej@pumuckel.gun.de>, Martin Schulze <joey@infodrom.org>, Chris Leick <c.leick@vollbio.de>, Mario Blättermann <mario.blaettermann@gmail.com> und Helge Kreutzmann <debian@helgefjell.de> 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>.