.\"link a file to another
.DT
link
$MUDNAME$ driver help
link

.SH Name
.SI 5
link() - link a file to another
.EI

.SH Synopsis
.SI 5
void link( string original, string reference );
.EI

.SH Description
.SP 5 5
Creates a link `reference' to the file `original'.  This efun causes
valid_link(original, reference) to be called in the master object.  If
valid_link() returns 0, the link() call fails.  If valid_link() returns 1
then the link() suceeds iff rename() would succeed if called with the same
arguments.
.EP

.SH See also
.SI 5
rm(), rmdir(), rename(), mkdir(), cp()
.EI
