.\"link a file to another

.DT
link
Discworld driver help
link

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

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

.EI
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
See also
.SI 5
rm(3), rmdir(3), ls(3), cat(3), rename(3).
.EI
