MakeLink

Creates a file system link (V36)

Create a file system link from 'name' to dest. For "soft-links", dest is a pointer to a null-terminated path string. For "hard- links", dest is a Lock (BPTR). 'soft' is FALSE for hard-links, non-zero otherwise.

Soft-links are resolved at access time by a combination of the file system (by returning ERROR_IS_SOFT_LINK to dos.library), and by dos.library (using ReadLink() to resolve any links that are hit).

Hard-links are resolved by the file system in question. A series of hard-links to a file are all equivalent to the file itself. If one of the links (or the original entry for the file) is deleted, the data remains until there are no links left.

name

Name of the link to create

dest

APTR to path string (i.e. 'STRPTR' or 'char *'), or BPTR to FileLock

is_soft

FALSE for hard-links, non-zero for soft-links

Success

boolean

The file system may not validate the 'dest' parameter value you provided. If you supply the wrong 'is_soft' value for the type of 'dest' parameter, you may crash the file system.

In V36, soft-links did not work in the ROM file systems. This was not fixed for V37 in spite of prior claims to the contrary. The use of soft links never worked consistently or reliably in the ROM file systems such as the FFS and RAM: until AmigaOS 3.1.4 (V46).

ReadLink(), Open(), Lock()