(C) 1998 AROS - The Amiga Research OS


NAME
#include <exec/types.h>
#include <proto/dos.h>

LONG MakeLink (name , dest , soft)

LOCATION
In DOSBase at offset 74

SYNOPSIS
STRPTR name
APTR dest
LONG soft

FUNCTION
MakeLink() will create a link between two files or directories. A link is a filesystem object that refers to another file.

A soft link refers to another file by name, and is resolved by the filesystem and the caller. Soft links are not restricted to the same volume. The |dest| argument is a NUL terminated pathname to the pre-existing object. Soft links can be used on directories.

A hard link refers to another file by the location on a disk, and is resolved by the filesystem. Hard links are restricted to files on the same volume. The |dest| argument is a lock on another file.

INPUTS
name
The name of the link to create
dest
If 'soft' is TRUE this must be a filename, if it is FALSE a BPTR
hard
linked must be provided
soft
TRUE, if a soft-link is to be created, FALSE for an hard-link

RESULT
boolean - DOSTRUE or DOSFALSE. On error, IoErr() will contain more information.

EXAMPLE

SEE ALSO
ReadLink()

NOTES

BUGS
Soft links were not working in the ROM filesystem before version 37.

INTERNALS
This function calls either FSA_CREATE_HARDLINK or FSA_CREATE_SOFTLINK on the filesystem of `name`.

HISTORY
20.10.1998 hkiel
Amiga Research OS
08.01.1998 srittau
Recommitted old revision of MakeLink() (r1.4) with some slight changes
07.01.1998 digulla
Fixed typo
01.01.1998 iaint
Some more simple DOS functions. These just call the f/s
25.12.1997 srittau
New function: MakeLink() (not tested)

Function prepared: Rename()

21.12.1997 srittau
Minor changes
27.01.1997 ldp
Polish
09.12.1996 aros
Added empty templates for all missing functions

Moved #include's into first column