134 lines
4.2 KiB
Groff
134 lines
4.2 KiB
Groff
.\" Copyright (c) 1980, 1990 The Regents of the University of California.
|
|
.\" All rights reserved.
|
|
.\"
|
|
.\" This code is derived from software contributed to Berkeley by
|
|
.\" the Institute of Electrical and Electronics Engineers, Inc.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" from: @(#)ln.1 6.8 (Berkeley) 7/27/91
|
|
.\" $Id: ln.1,v 1.6 1993/08/19 17:34:14 jtc Exp $
|
|
.\"
|
|
.Dd July 27, 1991
|
|
.Dt LN 1
|
|
.Os BSD 4
|
|
.Sh NAME
|
|
.Nm ln
|
|
.Nd make links
|
|
.Sh SYNOPSIS
|
|
.Nm ln
|
|
.Op Fl fs
|
|
.Ar source_file
|
|
.Op target_file
|
|
.Nm ln
|
|
.Op Fl fs
|
|
.Ar source_file ...
|
|
.Op target_dir
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm ln
|
|
utility creates a new
|
|
directory entry (linked file)
|
|
which inherits the same modes as the orginal
|
|
file.
|
|
It is useful for maintaining multiple copies of a file in
|
|
many places at once - without the `copies'; instead,
|
|
a link `points' to the original copy.
|
|
There are two types of links; hard links and symbolic links.
|
|
How a link `points' to a file is one of the differences
|
|
between a hard or symbolic link.
|
|
.Pp
|
|
Options available:
|
|
.Bl -tag -width flag
|
|
.It Fl f
|
|
Remove existing destination files.
|
|
.It Fl s
|
|
Create a symbolic link.
|
|
.El
|
|
.Pp
|
|
By default
|
|
.Nm ln
|
|
makes
|
|
.Em hard
|
|
links.
|
|
A hard link to a file is indistinguishable from the
|
|
original directory entry; any changes to a
|
|
file are effective independent of the name used
|
|
to reference the file. Hard links may not refer to directories
|
|
(unless the proper incantations are supplied) and may not span
|
|
file systems.
|
|
.Pp
|
|
A symbolic link contains the name of the file to
|
|
which it is linked. The referenced file is used when an
|
|
.Xr open 2
|
|
operation is performed on the link.
|
|
A
|
|
.Xr stat 2
|
|
on a symbolic link will return the linked-to file; an
|
|
.Xr lstat 2
|
|
must be done to obtain information about the link.
|
|
The
|
|
.Xr readlink 2
|
|
call may be used to read the contents of a symbolic link.
|
|
Symbolic links may span file systems and may refer to directories.
|
|
.Pp
|
|
Given one or two arguments,
|
|
.Nm ln
|
|
creates a link to an existing file
|
|
.Ar source_file .
|
|
If
|
|
.Ar target_file
|
|
is given, the link has that name;
|
|
.Ar target_file
|
|
may also be a directory in which to place the link;
|
|
otherwise it is placed in the current directory.
|
|
If only the directory is specified, the link will be made
|
|
to the last component of
|
|
.Ar source_file .
|
|
.Pp
|
|
Given more than two arguments,
|
|
.Nm ln
|
|
makes links in
|
|
.Ar target_dir
|
|
to all the named source files.
|
|
The links made will have the same name as the files being linked to.
|
|
.Sh SEE ALSO
|
|
.Xr rm 1 ,
|
|
.Xr cp 1 ,
|
|
.Xr mv 1 ,
|
|
.Xr link 2 ,
|
|
.Xr readlink 2 ,
|
|
.Xr stat 2 ,
|
|
.Xr symlink 2
|
|
.Sh STANDARDS
|
|
The
|
|
.Nm ln
|
|
utility conforms to
|
|
.St -p1003.2-92 .
|