NAME

ln — create hard links and symbolic links

SYNOPSIS

`ln`	[`-fnv`] [`-L`\|`-P`] `-T` `source` `target`

`ln`	[`-fnv`] [`-L`\|`-P`] `source...` [`target`]

`ln`	[`-fnv`] `-Ts` `reference` `target`

`ln`	[`-fnv`] `-s` `reference...` [`target`]

DESCRIPTION

ln create links at target for each given source or reference.

Unless -T is passed, when target is an existing directory or multiple source or reference are given, ln will create links into target. If target is unspecified, then it is set to the current directory, as if "." would have been passed.

Should be noted that unlike commands like cp(1), reference is kept as is and therefore is always relative to target rather than the current directory.

OPTIONS

-f: Forcefully create links by removing existing entries.
-L: If source is a symbolic link, dereference it.
-n: Prevent descending into target as a directory if it is a symbolic link.
-P: If source is a symbolic link, hard link it. This is the default.
-s: Create symbolic links instead of hard links.
-T: Always treat target as a normal file.
-v: Print successfully created links.

EXIT STATUS

The ln utility exits 0 on success, and >0 if an error occurs.

STANDARDS

ln should be compliant with the IEEE Std 1003.1-2024 (“POSIX.1”) specification. The -n, -T, and -v options are extensions. Support for unspecified target is an extension.

AUTHORS

Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>