Debian Codegraph @

upstream/debian-trixie/man1/install.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH INSTALL "1" "June 2025" "GNU coreutils 9.7" "User Commands"
3 .SH NAME
4 install \- copy files and set attributes
5 .SH SYNOPSIS
6 .B install
7 [\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR
8 .br
9 .B install
10 [\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR
11 .br
12 .B install
13 [\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR...
14 .br
15 .B install
16 [\fI\,OPTION\/\fR]... \fI\,-d DIRECTORY\/\fR...
17 .SH DESCRIPTION
18 .\" Add any additional description here
19 .PP
20 This install program copies files (often just compiled) into destination
21 locations you choose. If you want to download and install a ready\-to\-use
22 package on a GNU/Linux system, you should instead be using a package manager
23 like \fByum\fP(1) or \fBapt\-get\fP(1).
24 .PP
25 In the first three forms, copy SOURCE to DEST or multiple SOURCE(s) to
26 the existing DIRECTORY, while setting permission modes and owner/group.
27 In the 4th form, create all components of the given DIRECTORY(ies).
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\-c\fR
38 (ignored)
39 .TP
40 \fB\-C\fR, \fB\-\-compare\fR
41 compare content of source and destination files, and
42 if no change to content, ownership, and permissions,
43 do not modify the destination at all
44 .TP
45 \fB\-d\fR, \fB\-\-directory\fR
46 treat all arguments as directory names; create all
47 components of the specified directories
48 .TP
49 \fB\-D\fR
50 create all leading components of DEST except the last,
51 or all components of \fB\-\-target\-directory\fR,
52 then copy SOURCE to DEST
53 .TP
54 \fB\-\-debug\fR
55 explain how a file is copied. Implies \fB\-v\fR
56 .TP
57 \fB\-g\fR, \fB\-\-group\fR=\fI\,GROUP\/\fR
58 set group ownership, instead of process' current group
59 .TP
60 \fB\-m\fR, \fB\-\-mode\fR=\fI\,MODE\/\fR
61 set permission mode (as in chmod), instead of rwxr\-xr\-x
62 .TP
63 \fB\-o\fR, \fB\-\-owner\fR=\fI\,OWNER\/\fR
64 set ownership (super\-user only)
65 .TP
66 \fB\-p\fR, \fB\-\-preserve\-timestamps\fR
67 apply access/modification times of SOURCE files
68 to corresponding destination files
69 .TP
70 \fB\-s\fR, \fB\-\-strip\fR
71 strip symbol tables
72 .TP
73 \fB\-\-strip\-program\fR=\fI\,PROGRAM\/\fR
74 program used to strip binaries
75 .TP
76 \fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
77 override the usual backup suffix
78 .TP
79 \fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR
80 copy all SOURCE arguments into DIRECTORY
81 .TP
82 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
83 treat DEST as a normal file
84 .TP
85 \fB\-v\fR, \fB\-\-verbose\fR
86 print the name of each created file or directory
87 .TP
88 \fB\-\-preserve\-context\fR
89 preserve SELinux security context
90 .TP
91 \fB\-Z\fR
92 set SELinux security context of destination
93 file and each created directory to default type
94 .TP
95 \fB\-\-context\fR[=\fI\,CTX\/\fR]
96 like \fB\-Z\fR, or if CTX is specified then set the
97 SELinux or SMACK security context to CTX
98 .TP
99 \fB\-\-help\fR
100 display this help and exit
101 .TP
102 \fB\-\-version\fR
103 output version information and exit
104 .PP
105 The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
106 The version control method may be selected via the \fB\-\-backup\fR option or through
107 the VERSION_CONTROL environment variable. Here are the values:
108 .TP
109 none, off
110 never make backups (even if \fB\-\-backup\fR is given)
111 .TP
112 numbered, t
113 make numbered backups
114 .TP
115 existing, nil
116 numbered if numbered backups exist, simple otherwise
117 .TP
118 simple, never
119 always make simple backups
120 .SH AUTHOR
121 Written by David MacKenzie.
122 .SH "REPORTING BUGS"
123 GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
124 .br
125 Report any translation bugs to <https://translationproject.org/team/>
126 .SH "SEE ALSO"
127 \fBcp\fP(1)
128 .PP
129 .br
130 Full documentation <https://www.gnu.org/software/coreutils/install>
131 .br
132 or available locally via: info \(aq(coreutils) install invocation\(aq
133 .PP
134 .br
135 Packaged by Debian (9.7\-3)
136 .br
137 Copyright \(co 2025 Free Software Foundation, Inc.
138 .br
139 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
140 .br
141 This is free software: you are free to change and redistribute it.
142 .br
143 There is NO WARRANTY, to the extent permitted by law.