raw/man1/ln.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.022.
   2 .TH LN "1" "October 2003" "ln (coreutils) 5.0" FSF
   3 .SH NAME
   4 ln \- make links between files
   5 .SH SYNOPSIS
   6 .B ln
   7 [\fIOPTION\fR]... \fITARGET \fR[\fILINK_NAME\fR]
   8 .br
   9 .B ln
  10 [\fIOPTION\fR]... \fITARGET\fR... \fIDIRECTORY\fR
  11 .br
  12 .B ln
  13 [\fIOPTION\fR]... \fI--target-directory=DIRECTORY TARGET\fR...
  14 .SH DESCRIPTION
  15 .\" Add any additional description here
  16 .PP
  17 Create a link to the specified TARGET with optional LINK_NAME.
  18 If LINK_NAME is omitted, a link with the same basename as the TARGET is
  19 created in the current directory.  When using the second form with more
  20 than one TARGET, the last argument must be a directory;  create links
  21 in DIRECTORY to each TARGET.  Create hard links by default, symbolic
  22 links with \fB\-\-symbolic\fR.  When creating hard links, each TARGET must exist.
  23 .PP
  24 Mandatory arguments to long options are mandatory for short options too.
  25 .TP
  26 \fB\-\-backup\fR[=\fICONTROL\fR]
  27 make a backup of each existing destination file
  28 .TP
  29 \fB\-b\fR
  30 like \fB\-\-backup\fR but does not accept an argument
  31 .TP
  32 \fB\-d\fR, \fB\-F\fR, \fB\-\-directory\fR
  33 hard link directories (super-user only)
  34 .TP
  35 \fB\-f\fR, \fB\-\-force\fR
  36 remove existing destination files
  37 .TP
  38 \fB\-n\fR, \fB\-\-no\-dereference\fR
  39 treat destination that is a symlink to a
  40 directory as if it were a normal file
  41 .TP
  42 \fB\-i\fR, \fB\-\-interactive\fR
  43 prompt whether to remove destinations
  44 .TP
  45 \fB\-s\fR, \fB\-\-symbolic\fR
  46 make symbolic links instead of hard links
  47 .TP
  48 \fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
  49 override the usual backup suffix
  50 .TP
  51 \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
  52 specify the DIRECTORY in which to create
  53 the links
  54 .TP
  55 \fB\-v\fR, \fB\-\-verbose\fR
  56 print name of each file before linking
  57 .TP
  58 \fB\-\-help\fR
  59 display this help and exit
  60 .TP
  61 \fB\-\-version\fR
  62 output version information and exit
  63 .PP
  64 The backup suffix is `~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
  65 The version control method may be selected via the \fB\-\-backup\fR option or through
  66 the VERSION_CONTROL environment variable.  Here are the values:
  67 .TP
  68 none, off
  69 never make backups (even if \fB\-\-backup\fR is given)
  70 .TP
  71 numbered, t
  72 make numbered backups
  73 .TP
  74 existing, nil
  75 numbered if numbered backups exist, simple otherwise
  76 .TP
  77 simple, never
  78 always make simple backups
  79 .SH AUTHOR
  80 Written by Mike Parker and David MacKenzie.
  81 .SH "REPORTING BUGS"
  82 Report bugs to <bug-coreutils@gnu.org>.
  83 .SH COPYRIGHT
  84 Copyright \(co 2003 Free Software Foundation, Inc.
  85 .br
  86 This is free software; see the source for copying conditions.  There is NO
  87 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  88 .SH "SEE ALSO"
  89 The full documentation for
  90 .B ln
  91 is maintained as a Texinfo manual.  If the
  92 .B info
  93 and
  94 .B ln
  95 programs are properly installed at your site, the command
  96 .IP
  97 .B info ln
  98 .PP
  99 should give you access to the complete manual.