Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.9.31  Fsymlink                                                   TOS

 Name:         »Fsymlink« - symbolischen Link auf ein File erzeugen.

 Gemdosnummer: 302

 Deklaration:  int32_t Fsymlink ( int8_t *oldname, int8_t *newname );

 Beschreibung: Die Funktion erzeugt einen symbolischen Link newname 
               für die Datei mit dem Namen oldname. Bei erfolgreichem 
               Aufruf kann die Datei anschließend unter beiden Namen 
               angesprochen werden. Ein Löschen per Fdelete für 
               newname berührt die Datei selbst nicht, sondern nur den 
               symbolischen Link. Wird hingegen Fdelete auf oldname 
               angewendet, so wird die Datei wie gewohnt gelöscht, und 
               Zugriffe auf newname sind nicht mehr möglich.

               Der Unterschied zu Hard-Links besteht darin, daß 
               symbolische Links zwischen verschiedenen physikalischen 
               Geräten (und damit sogar verschiedenen Filesystem- 
               Typen) bestehen können.

 Ergebnis:     Die Funktion kann folgende Rückgabewerte liefern:

                E_OK :    kein Fehler aufgetreten.
                EINVFN :  das Filesystem unterstützt keine 
                          symbolischen Links.

 Verfügbar:    Verfügbar, wenn ein 'MiNT' Cookie mit einer 
               Versionsnummer von mindestens 0.90 existiert und in 
               MagiC ab Version 3.0.

 Gruppe:       Dateifunktionen

 Querverweis:  Binding   Flink   Freadlink   Frename   XFS-Konzept