[[!meta copyright="Copyright © 1994, 1995, 1996, 1997, 1998, 1999, 2002, 2009
Free Software Foundation, Inc."]]

[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
id="license" text="Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no Invariant
Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
is included in the section entitled [[GNU Free Documentation
License|/fdl]]."]]"""]]

[[!meta title="dir_link"]]

    routine dir_link (
    	dir: file_t;
    	RPT
    	file: file_t;
    	name: string_t;
    	excl: int);

Create a hard link.

If `dir` and `file` are not implemented by the same filesystem, `EXDEV` should
be returned.  If the two filesystems, however can inter-operate and guarantee
the appropriate POSIX semantics, they can communicate by a private protocol and
allow hard links between them.  If `excl` is set, then fail if `name` already
exists in `dir`.