Debian Codegraph @

upstream/debian-trixie/man1/ln.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH LN "1" "June 2025" "GNU coreutils 9.7" "User Commands"
3 .SH NAME
4 ln \- make links between files
5 .SH SYNOPSIS
6 .B ln
7 [\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,TARGET LINK_NAME\/\fR
8 .br
9 .B ln
10 [\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR
11 .br
12 .B ln
13 [\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR... \fI\,DIRECTORY\/\fR
14 .br
15 .B ln
16 [\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY TARGET\/\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[=\fI\,CONTROL\/\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 (this 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 with \fB\-s\fR, create 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=\fI\,SUFFIX\/\fR
65 override the usual backup suffix
66 .TP
67 \fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\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 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
105 .br
106 Report any translation bugs to <https://translationproject.org/team/>
107 .SH "SEE ALSO"
108 \fBlink\fP(2), \fBsymlink\fP(2)
109 .PP
110 .br
111 Full documentation <https://www.gnu.org/software/coreutils/ln>
112 .br
113 or available locally via: info \(aq(coreutils) ln invocation\(aq
114 .PP
115 .br
116 Packaged by Debian (9.7\-3)
117 .br
118 Copyright \(co 2025 Free Software Foundation, Inc.
119 .br
120 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
121 .br
122 This is free software: you are free to change and redistribute it.
123 .br
124 There is NO WARRANTY, to the extent permitted by law.