Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File5.10.31  Fsymlink                                                  TOS

 Name:         »Fsymlink« - Create a symbolic link to a file.

 Opcode:       302

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

 Description:  The function Fsymlink creates a symbolic link newname 
               for the file named oldname. If the call succeeds then 
               the file can later be accessed under both names. 
               Deletion with Fdelete for newname does not affect the 
               file itself, but only the symbolic link. However, if 
               Fdelete is applied to oldname, then the file will be 
               deleted as usual, and accesses to newname are no longer 
               possible.

               The difference to hard links lies in the fact that 
               symbolic links can exist between different physical 
               devices (and with that even different file-system 
               types).

 Return value: The function can return the following results:

                E_OK :    No error has arisen
                EINVFN :  The file-system does not support symbolic 
                          links

 Availability: Available when a 'MiNT' cookie with a version of at 
               least 0.90 exists and in MagiC as of Version 3.0.

 Group:        File functions

 See Also:     Binding   Flink   Freadlink   Frename   XFS-concept