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.16  Flink                                                     TOS

 Name:         »Flink« - Create a new (hard-)link to a file.

 Opcode:       301

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

 Description:  The function Flink creates a new name (newname) for the 
               file named oldname. The file can later be addressed 
               under both names, and the deletion (with Fdelete) of 
               one name has no effect on the other.

               One should note that oldname and newname have to lie on 
               the same physical drive, and also that not all 
               file-systems offer the option of setting links.

 Return value: The function can return the following results:

                E_OK :    No error has arisen
                EINVFN :  The file-system does not support hard links
                EFILNF :  The file oldname does not exist
                EXDEV :   (As below)
                ENSAME :  The files oldname/newname do not lie on the 
                          same physical drive

 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   Frename   Fsymlink   XFS-concept in MagiC