original/man1/ln.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH LN "1" "May 2014" "GNU coreutils 8.21" "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 By default, each destination (name of new link) should not already exist.
  25 When creating hard links, each TARGET must exist.  Symbolic links
  26 can hold arbitrary text; if later resolved, a relative link is
  27 interpreted in relation to its parent directory.
  28 .PP
  29 Mandatory arguments to long options are mandatory for short options too.
  30 .TP
  31 \fB\-\-backup\fR[=\fICONTROL\fR]
  32 make a backup of each existing destination file
  33 .TP
  34 \fB\-b\fR
  35 like \fB\-\-backup\fR but does not accept an argument
  36 .TP
  37 \fB\-d\fR, \fB\-F\fR, \fB\-\-directory\fR
  38 allow the superuser to attempt to hard link
  39 directories (note: will probably fail due to
  40 system restrictions, even for the superuser)
  41 .TP
  42 \fB\-f\fR, \fB\-\-force\fR
  43 remove existing destination files
  44 .TP
  45 \fB\-i\fR, \fB\-\-interactive\fR
  46 prompt whether to remove destinations
  47 .TP
  48 \fB\-L\fR, \fB\-\-logical\fR
  49 dereference TARGETs that are symbolic links
  50 .TP
  51 \fB\-n\fR, \fB\-\-no\-dereference\fR
  52 treat LINK_NAME as a normal file if
  53 it is a symbolic link to a directory
  54 .TP
  55 \fB\-P\fR, \fB\-\-physical\fR
  56 make hard links directly to symbolic links
  57 .TP
  58 \fB\-r\fR, \fB\-\-relative\fR
  59 create symbolic links relative to link location
  60 .TP
  61 \fB\-s\fR, \fB\-\-symbolic\fR
  62 make symbolic links instead of hard links
  63 .TP
  64 \fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
  65 override the usual backup suffix
  66 .TP
  67 \fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
  68 specify the DIRECTORY in which to create
  69 the links
  70 .TP
  71 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
  72 treat LINK_NAME as a normal file always
  73 .TP
  74 \fB\-v\fR, \fB\-\-verbose\fR
  75 print name of each linked file
  76 .TP
  77 \fB\-\-help\fR
  78 display this help and exit
  79 .TP
  80 \fB\-\-version\fR
  81 output version information and exit
  82 .PP
  83 The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
  84 The version control method may be selected via the \fB\-\-backup\fR option or through
  85 the VERSION_CONTROL environment variable.  Here are the values:
  86 .TP
  87 none, off
  88 never make backups (even if \fB\-\-backup\fR is given)
  89 .TP
  90 numbered, t
  91 make numbered backups
  92 .TP
  93 existing, nil
  94 numbered if numbered backups exist, simple otherwise
  95 .TP
  96 simple, never
  97 always make simple backups
  98 .PP
  99 Using \fB\-s\fR ignores \fB\-L\fR and \fB\-P\fR.  Otherwise, the last option specified controls
 100 behavior when a TARGET is a symbolic link, defaulting to \fB\-P\fR.
 101 .SH AUTHOR
 102 Written by Mike Parker and David MacKenzie.
 103 .SH "REPORTING BUGS"
 104 Report ln bugs to bug\-coreutils@gnu.org
 105 .br
 106 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
 107 .br
 108 General help using GNU software: <http://www.gnu.org/gethelp/>
 109 .br
 110 Report ln translation bugs to <http://translationproject.org/team/>
 111 .SH COPYRIGHT
 112 Copyright \(co 2013 Free Software Foundation, Inc.
 113 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 114 .br
 115 This is free software: you are free to change and redistribute it.
 116 There is NO WARRANTY, to the extent permitted by law.
 117 .SH "SEE ALSO"
 118 link(2), symlink(2)
 119 .PP
 120 The full documentation for
 121 .B ln
 122 is maintained as a Texinfo manual.  If the
 123 .B info
 124 and
 125 .B ln
 126 programs are properly installed at your site, the command
 127 .IP
 128 .B info coreutils \(aqln invocation\(aq
 129 .PP
 130 should give you access to the complete manual.