.\"link a file to another
.TH link 3

.SH NAME
link() - link a file to another

.SH SYNOPSIS
void link(string original, string reference);

.SH DESCRIPTION
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.

.SH SEE ALSO
rm(3), rmdir(3), ls(3), cat(3), rename(3).