Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileFrename()
Fsymlink()
Flink()                                                              GEMDOS

Syntax

LONG Flink( oldname, newname )
char *oldname, *newname;

Function      Flink() creates a new name for the specified file. After the
              call the file may be referred to by either name. An
              Fdelete() call on one filename will not affect the other.

Opcode        301 (0x12D)

Availability  Available when a 'MiNT' cookie with a version of at least
              0.90 exists.

Parameters    oldname points to the GEMDOS path specification of the
              currently existing file and newname specifies the name of
              the alias to create.

Binding       pea      newname
              pea      oldname
              move.w   #$12D,-(sp)
              trap     #1
              lea      10(sp),sp

Return Value  Flink() returns a 0 if successful or a negative GEMDOS error
              code otherwise.

Caveats       Not all file systems support 'hard links'.

Comments      The filenames given must reside on the same physical device.

See Also      Frename(), Fsymlink()