ab26b5583e
1) Clarify behaviour when the f-flag is given and a target is in its own way. 2) Fix usage()-style. 3) Group local variable declarations. 4) reorder args 5) argc style, other boolean style changes 6) improve error messages 7) set argv[argc - 1] to NULL to allow argv-centric loop later 8) BUGFIX: POSIX specifies that when with the f-flag there's a situation where a file stands in its own way for linking it should be ignored. 9) Add weprintf() where possible, so we don't pussy out when there's a small issue. This is sbase ffs!
66 lines
985 B
Groff
66 lines
985 B
Groff
.Dd March 5, 2015
|
|
.Dt LN 1
|
|
.Os sbase
|
|
.Sh NAME
|
|
.Nm ln
|
|
.Nd link files
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl f
|
|
.Op Fl L | Fl P | Fl s
|
|
.Ar target
|
|
.Op Ar name
|
|
.Nm
|
|
.Op Fl f
|
|
.Op Fl L | Fl P | Fl s
|
|
.Ar target ...
|
|
.Ar directory
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
creates a hard link
|
|
.Ar name
|
|
to
|
|
.Ar target .
|
|
If no
|
|
.Ar name
|
|
is given, a hard link to
|
|
.Ar target
|
|
is created in the current directory.
|
|
If more than one
|
|
.Ar target
|
|
is given,
|
|
.Nm
|
|
hardlinks them in the existing
|
|
.Ar directory .
|
|
.Sh OPTIONS
|
|
.Bl -tag -width Ds
|
|
.It Fl f
|
|
If
|
|
.Ar name
|
|
exists and is not a
|
|
.Ar target ,
|
|
remove it to allow the link.
|
|
.It Fl L | Fl P
|
|
If
|
|
.Ar target
|
|
is a symbolic link, create a hard link to the (referenced file) |
|
|
(symbolic link itself). The former is the default.
|
|
.It Fl s
|
|
Create symbolic links instead of hard links.
|
|
Disables
|
|
.Fl L
|
|
and
|
|
.Fl P ,
|
|
because their purpose does not apply to symbolic links.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr cp 1 ,
|
|
.Xr link 2 ,
|
|
.Xr symlink 2
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm
|
|
utility is compliant with the
|
|
.St -p1003.1-2008
|
|
specification.
|