27 Input/output library [input.output]

27.10 File systems [filesystems]

27.10.15 Filesystem operation functions [fs.op.funcs]

27.10.15.9 Create hard link [fs.op.create_hard_lk]

void create_hard_link(const path& to, const path& new_hard_link); void create_hard_link(const path& to, const path& new_hard_link, error_code& ec) noexcept;

1

Effects: Establishes the postcondition, as if by POSIX link().

2

Postconditions:

  • (2.1)

    exists(to) && exists(new_hard_link) && equivalent(to, new_hard_link)

  • (2.2)

    The contents of the file or directory to resolves to are unchanged.

3

Throws: As specified in [fs.err.report].

4

[ Note: Some operating systems do not support hard links at all or support them only for regular files. Some file systems (such as the FAT file system) do not support hard links regardless of the operating system. Some file systems limit the number of links per file.  — end note ]