man/ln.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH LN "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 ln \- make links between files
   5 .SH SYNOPSIS
   6 .B ln
   7 [\fIOPTION\fR]... [\fI-T\fR] \fITARGET LINK_NAME   (1st form)\fR
   8 .br
   9 .B ln
  10 [\fIOPTION\fR]... \fITARGET                  (2nd form)\fR
  11 .br
  12 .B ln
  13 [\fIOPTION\fR]... \fITARGET\fR... \fIDIRECTORY     (3rd form)\fR
  14 .br
  15 .B ln
  16 [\fIOPTION\fR]... \fI-t DIRECTORY TARGET\fR...  \fI(4th form)\fR
  17 .SH DESCRIPTION
  18 .\" Add any additional description here
  19 .PP
  20 In the 1st form, create a link to TARGET with the name LINK_NAME.
  21 In the 2nd form, create a link to TARGET in the current directory.
  22 In the 3rd and 4th forms, create links to each TARGET in DIRECTORY.
  23 Create hard links by default, symbolic links with \fB\-\-symbolic\fR.
  24 When creating hard links, each TARGET must exist.
  25 .PP
  26 Mandatory arguments to long options are mandatory for short options too.
  27 .TP
  28 \fB\-\-backup\fR[=\fICONTROL\fR]
  29 make a backup of each existing destination file
  30 .TP
  31 \fB\-b\fR
  32 like \fB\-\-backup\fR but does not accept an argument
  33 .TP
  34 \fB\-d\fR, \fB\-F\fR, \fB\-\-directory\fR
  35 allow the superuser to attempt to hard link
  36 directories (note: will probably fail due to
  37 system restrictions, even for the superuser)
  38 .TP
  39 \fB\-f\fR, \fB\-\-force\fR
  40 remove existing destination files
  41 .TP
  42 \fB\-n\fR, \fB\-\-no\-dereference\fR
  43 treat destination that is a symlink to a
  44 directory as if it were a normal file
  45 .TP
  46 \fB\-i\fR, \fB\-\-interactive\fR
  47 prompt whether to remove destinations
  48 .TP
  49 \fB\-s\fR, \fB\-\-symbolic\fR
  50 make symbolic links instead of hard links
  51 .TP
  52 \fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
  53 override the usual backup suffix
  54 .TP
  55 \fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
  56 specify the DIRECTORY in which to create
  57 the links
  58 .TP
  59 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
  60 treat LINK_NAME as a normal file
  61 .TP
  62 \fB\-v\fR, \fB\-\-verbose\fR
  63 print name of each linked file
  64 .TP
  65 \fB\-\-help\fR
  66 display this help and exit
  67 .TP
  68 \fB\-\-version\fR
  69 output version information and exit
  70 .PP
  71 The backup suffix is `~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
  72 The version control method may be selected via the \fB\-\-backup\fR option or through
  73 the VERSION_CONTROL environment variable.  Here are the values:
  74 .TP
  75 none, off
  76 never make backups (even if \fB\-\-backup\fR is given)
  77 .TP
  78 numbered, t
  79 make numbered backups
  80 .TP
  81 existing, nil
  82 numbered if numbered backups exist, simple otherwise
  83 .TP
  84 simple, never
  85 always make simple backups
  86 .SH AUTHOR
  87 Written by Mike Parker and David MacKenzie.
  88 .SH "REPORTING BUGS"
  89 Report bugs to <bug\-coreutils@gnu.org>.
  90 .SH COPYRIGHT
  91 Copyright \(co 2007 Free Software Foundation, Inc.
  92 .br
  93 This is free software.  You may redistribute copies of it under the terms of
  94 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
  95 There is NO WARRANTY, to the extent permitted by law.
  96 .SH "SEE ALSO"
  97 link(2), symlink(2)
  98 .PP
  99 The full documentation for
 100 .B ln
 101 is maintained as a Texinfo manual.  If the
 102 .B info
 103 and
 104 .B ln
 105 programs are properly installed at your site, the command
 106 .IP
 107 .B info ln
 108 .PP
 109 should give you access to the complete manual.