Provided by: manpages-de-dev_0.5-4.1ubuntu1_all bug

BEZEICHNUNG

       symlink - erzeugt einen symbolischen Namen für eine Datei

ÜBERSICHT

       #include <unistd.h>

       int symlink(const char *oldpath, const char *newpath);

BESCHREIBUNG

       Symlink  erzeugt  für  die  Datei  oldpath  einen  symbolischen Verweis
       newpath.

       Symbolische Links werden zur Laufzeit interpretiert, als wenn der  neue
       Dateiname  durch  den alten ersetzt worden wäre.  Dies gilt für Dateien
       und Verzeichnisse.

       Symbolische Links können ..  im Pfad beinhalten.   Dies  wird  als  das
       nächsthöhere Verzeichnis des Links interpretiert.

       Ein   symbolischen   Link  (auch  Soft  Link  genannt)  kann  auf  eine
       existierende oder eine nicht existierende Datei zeigen.  Dies wird  als
       toter Link bezeichnet.

       Die  Rechte  eines  symbolischen Links sind irrelevant.  Der Eigentümer
       wird beim Auflösen des Links ignoriert, jedoch überprüft, wenn der Link
       umbenannt  oder  gelöscht werden soll.  Aber nur wenn der Link in einem
       Verzeichnis ist, das das Sticky-Bit gesetzt hat.

       Wenn newpath existiert, wird es nicht überschrieben.

RÜCKGABEWERT

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

ERRORS

       EPERM  Das  Dateisystem  welches pathname beinhaltet, erlaubt nicht das
              Erzeugen von symbolischen Links.

       EFAULT oldpath oder newpath zeigt außerhalb des Benutzer-Adressraums.

       EACCES Die effektive uid des Prozesses hat  kein  Schreibrecht  in  dem
              Verzeichnis  in  dem  newpath  angelegt  werden  soll,  oder das
              Verzeichnis newpath verbietet  das  Suchen  (execute  permission
              fehlt).

       ENAMETOOLONG
              oldpath oder newpath war zu lang.

       ENOENT Eine  Komponente des Verzeichnisses newpath existiert nicht oder
              ist ein toter symbolischer Link, oder  oldpath  ist  ein  leerer
              String.

       ENOTDIR
              Eine Komponente des Verzeichnisses newpath ist kein Directory.

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

       EROFS  Die Datei ist in einem schreibgeschützten Dateisystem.

       EEXIST newpath ist schon vorhanden.

       ELOOP  newpath   beinhalten   einen   Verweis   auf   einen  zirkulären
              symbolischen Link, also auf einen symbolischen Link der auf sich
              selbst verweist.

       ENOSPC Die  Gerätedatei,  die  die  Datei enthält, hat keinen Platz für
              einen neuen Verzeichniseintrag.

BEMERKUNGEN

       Es wird keine Prüfung auf oldpath durchgeführt.

       Das Löschen der Datei auf die ein symbolischer Link zeigt, löscht diese
       Datei  (wenn  sie  keine  anderen  Hardlinks  hat).   Wenn  dies  nicht
       gewünscht ist, sollte link.  benutzt werden.

KONFORM ZU

       SVID, AT&T, POSIX, BSD 4.3

FEHLER

       Siehe open(2) bezüglich mehreren Dateien mit gleichem Namen und NFS.

SIEHE AUCH

       link(2), unlink(2), rename(2), open(2), lstat(2), ln(1), link(8).