# link

## Synopsis

```perl
link $oldfile, $newfile or die "Cannot link: $!";
link '/data/original', '/data/hardlink';
```

## Description

Creates a hard link to an existing file.

Creates a new directory entry NEWFILE that refers to the same inode
as OLDFILE. Both paths must be on the same filesystem. The link count
of the file is incremented. Uses `std::fs::hard_link`. Returns 1 on
success, 0 on failure (and sets `$!`).

## See also

symlink, unlink, rename