coreutils: link invocation

1 
1 12.1 ‘link’: Make a hard link via the link syscall
1 ==================================================
1 
1 ‘link’ creates a single hard link at a time.  It is a minimalist
11 interface to the system-provided ‘link’ function.  ⇒(libc)Hard
 Links.  It avoids the bells and whistles of the more commonly-used
1 ‘ln’ command (⇒ln invocation).  Synopsis:
1 
1      link FILENAME LINKNAME
1 
1    FILENAME must specify an existing file, and LINKNAME must specify a
1 nonexistent entry in an existing directory.  ‘link’ simply calls ‘link
1 (FILENAME, LINKNAME)’ to create the link.
1 
1    On a GNU system, this command acts like ‘ln --directory
1 --no-target-directory FILENAME LINKNAME’.  However, the ‘--directory’
1 and ‘--no-target-directory’ options are not specified by POSIX, and the
1 ‘link’ command is more portable in practice.
1 
1    If FILENAME is a symbolic link, it is unspecified whether LINKNAME
1 will be a hard link to the symbolic link or to the target of the
1 symbolic link.  Use ‘ln -P’ or ‘ln -L’ to specify which behavior is
1 desired.
1 
1    An exit status of zero indicates success, and a nonzero value
1 indicates failure.
1