git.infodrom.org Git - infodrom/manpages-de/blob - man2/link.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" This manpage is Copyright (C) 1992 Drew Eckhardt;
   4 .\"                               1993 Michael Haardt, Ian Jackson.
   5 .\"
   6 .\" Permission is granted to make and distribute verbatim copies of this
   7 .\" manual provided the copyright notice and this permission notice are
   8 .\" preserved on all copies.
   9 .\"
  10 .\" Permission is granted to copy and distribute modified versions of this
  11 .\" manual under the conditions for verbatim copying, provided that the
  12 .\" entire resulting derived work is distributed under the terms of a
  13 .\" permission notice identical to this one
  14 .\"
  15 .\" Since the Linux kernel and libraries are constantly changing, this
  16 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  17 .\" responsibility for errors or omissions, or for damages resulting from
  18 .\" the use of the information contained herein.  The author(s) may not
  19 .\" have taken the same level of care in the production of this manual,
  20 .\" which is licensed free of charge, as they might when working
  21 .\" professionally.
  22 .\"
  23 .\" Formatted or processed versions of this manual, if unaccompanied by
  24 .\" the source, must acknowledge the copyright and authors of this work.
  25 .\"
  26 .\" Modified Fri Jul 23 22:01:51 1993 Rik Faith (faith@cs.unc.edu)
  27 .\" Modified Sun Aug 21 18:18:14 1994: Michael Haardt's NFS diffs were
  28 .\"          applied by hand (faith@cs.unc.edu)
  29 .\" Modified Sat Jan 20 20:21:00 1996 Elmar Jansen (ej@pumuckel.gun.de)
  30 .\" Modified Mon Jun 10 12:29:45 1996 by Martin Schulze (joey@linux.de)
  31 .\"
  32 .TH LINK 2 "20. Januar 1996" "Linux" "Systemaufrufe"
  33 .SH BEZEICHNUNG
  34 link \- erzeuge einen neuen Verweis auf eine Datei
  35 .SH ÜBERSICHT
  36 .B #include <unistd.h>
  37 .sp
  38 .BI "int link(const char *" oldpath ", const char *" newpath );
  39 .SH BESCHREIBUNG
  40 .B link
  41 erzeugt einen neuen Verweis (auch bekannt als Hardlink) auf eine
  42 bestehenden Datei
  43
  44 Wenn
  45 .I newpath
  46 existiert wird er
  47 .I nicht
  48 überschrieben.
  49
  50 Der neue Name kann genauso wie der alte Name für alle Aktionen benutzt
  51 werden.  Beide Namen zeigen auf die gleiche Datei (haben somit die gleichen
  52 Rechte und Eigentümer) und es ist unmöglich festzustellen welcher Name der
  53 Originalname ist.
  54 .SH "RÜCKGABEWERT"
  55 Bei Erfolg wird Null zurückgegeben.  Bei einem Fehler wird \-1 zurückgegeben
  56 und
  57 .I errno
  58 entsprechend gesetzt.
  59 .SH ERRORS
  60 .TP 0.8i
  61 .B EXDEV
  62 .IR oldpath " und " newpath
  63 sind nicht im gleichen Dateisystem.
  64 .TP
  65 .B EPERM
  66 Das Dateisystem welches
  67 .IR oldpath " und " newpath
  68 beinhaltet, erlaubt nicht das Erzeugen von Hardlinks.
  69 .TP
  70 .B EFAULT
  71 .IR oldpath " oder " newpath " zeigt außerhalb des Benutzer-Adressraums."
  72 .TP
  73 .B EACCES
  74 Die effektive uid des Prozesses hat kein Schreibrecht in dem
  75 Verzeichnis, in dem
  76 .I newpath
  77 angelegt werden soll, oder eines der Verzeichnisses
  78 .IR oldpath " oder " newpath
  79 verbietet das Suchen (execute permission fehlt).
  80 .TP
  81 .B ENAMETOOLONG
  82 .IR oldpath " oder " newpath " war zu lang."
  83 .TP
  84 .B ENOENT
  85 Eine Komponente des Verzeichnisses
  86 .I oldpath " oder " newpath
  87 existiert nicht oder ist ein unsicherer symbolischer Link.
  88 .TP
  89 .B ENOTDIR
  90 Eine Komponente des Verzeichnisses
  91 .IR oldpath " oder " newpath
  92 ist kein Directory.
  93 .TP
  94 .B ENOMEM
  95 Es war nicht genügend Kernel-Memory verfügbar.
  96 .TP
  97 .B EROFS
  98 Die Datei ist in einem nur lesbaren Dateisystem.
  99 .TP
 100 .B EEXIST
 101 .I newpath
 102 ist schon vorhanden.
 103 .TP
 104 .B EMLINK
 105 Die Datei auf die
 106 .I oldpath
 107 zeigt hat schon die maximale Anzahl links.
 108 .TP
 109 .B ELOOP
 110 .IR oldpath " oder " newpath
 111 beinhalten einen Verweis auf einen kreisenden symbolischen Link,
 112 beziehungsweise auf einen symbolischen Link der auf sich selbst
 113 verweist.
 114 .TP
 115 .B ENOSPC
 116 Die Gerätedatei die die Datei enthält hat keinen Platz für einen
 117 neuen Verzeichniseintrag.
 118 .TP
 119 .B EPERM
 120 .I oldpath
 121 ist der
 122 .B . " oder " ..
 123 Eintrag eines Directory's.
 124 .SH BEMERKUNGEN
 125 Hard links, die mit
 126 .BR link ,
 127 kreiert werden können nicht auf verschiedenen Dateisystemen liegen.  Benutze
 128 dafür
 129 .B symlink
 130 .SH "KONFORM ZU"
 131 SVID, AT&T, POSIX, BSD 4.3
 132 .SH FEHLER
 133 In NFS Dateisystemen kann der Rückgabewert falsch sein, wenn der NFS-Server
 134 beim Erzeugen des Links stirbt.  Benutze
 135 .IR stat(2)
 136 um zu prüfen ob der Link angelegt wurde.
 137 .SH "SIEHE AUCH"
 138 .BR symlink (2),
 139 .BR unlink (2),
 140 .BR rename (2),
 141 .BR open (2),
 142 .BR stat (2),
 143 .BR ln (1),
 144 .BR link (8)