link(1) — Commands
NAME
link, unlink − Creates an additional directory entry for an existing file
SYNOPSIS
link file1 file2
unlink file
DESCRIPTION
The link command performs the link() system call to create an additional directory entry for an existing file, file1. In effect, the underlying file then has two names, file1 and file2 (either of these arguments can be a pathname). The old and new entries share equal access rights to the underlying file.
The unlink command performs the unlink() system call to remove a link to file created by link. The unlink command removes the directory entry specified by the file parameter and, if the entry is a hard link, decrements the link count of the file referenced by the link.
You should be familiar with the link() and unlink() system calls before you use these commands.
The link and unlink commands do not issue error messages when the associated system call is unsuccessful.
NOTES
The link and unlink commands cannot be used to link and unlink directories.
RETURN VALUES
The link command returns 0 if the link() system call succeeds, 1 if you specify too few or too many arguments, and 2 if the system call fails.
The unlink command always returns 0.