Debian Codegraph @

upstream/debian-unstable/man1/install.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH INSTALL "1" "February 2026" "GNU coreutils 9.10" "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 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--backup'\fB\-\-backup[=CONTROL]\fP\X'tty: link'
32 make a backup of each existing destination file
33 .TP
34 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-b'\fB\-b\fP\X'tty: link'
35 like \fB\-\-backup\fR but does not accept an argument
36 .TP
37 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-c'\fB\-c\fP\X'tty: link'
38 (ignored)
39 .TP
40 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-C'\fB\-C, \-\-compare\fP\X'tty: link'
41 compare content of source and destination files,
42 and if no change to content, ownership, and permissions,
43 do not modify the destination at all
44 .TP
45 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-d'\fB\-d, \-\-directory\fP\X'tty: link'
46 treat all arguments as directory names;
47 create all components of the specified directories
48 .TP
49 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-D'\fB\-D\fP\X'tty: link'
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 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--debug'\fB\-\-debug\fP\X'tty: link'
55 explain how a file is copied. Implies \fB\-v\fR
56 .TP
57 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-g'\fB\-g, \-\-group=\,GROUP\fP\X'tty: link'\/\fR
58 set group ownership, instead of process' current group
59 .TP
60 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-m'\fB\-m, \-\-mode=\,MODE\fP\X'tty: link'\/\fR
61 set permission mode (as in chmod), instead of rwxr\-xr\-x
62 .TP
63 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-o'\fB\-o, \-\-owner=\,OWNER\fP\X'tty: link'\/\fR
64 set ownership (super\-user only)
65 .TP
66 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-p'\fB\-p, \-\-preserve\-timestamps\fP\X'tty: link'
67 apply access/modification times of SOURCE files
68 to corresponding destination files
69 .TP
70 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-s'\fB\-s, \-\-strip\fP\X'tty: link'
71 strip symbol tables
72 .TP
73 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--strip-program'\fB\-\-strip\-program=PROGRAM\fP\X'tty: link'
74 program used to strip binaries
75 .TP
76 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-S'\fB\-S, \-\-suffix=\,SUFFIX\fP\X'tty: link'\/\fR
77 override the usual backup suffix
78 .TP
79 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-t'\fB\-t, \-\-target\-directory=\,DIRECTORY\fP\X'tty: link'\/\fR
80 copy all SOURCE arguments into DIRECTORY
81 .TP
82 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-T'\fB\-T, \-\-no\-target\-directory\fP\X'tty: link'
83 treat DEST as a normal file
84 .TP
85 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-v'\fB\-v, \-\-verbose\fP\X'tty: link'
86 print the name of each created file or directory
87 .TP
88 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--preserve-context'\fB\-\-preserve\-context\fP\X'tty: link'
89 preserve SELinux security context
90 .TP
91 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install-Z'\fB\-Z\fP\X'tty: link'
92 set SELinux security context of destination file
93 and each created directory, to default type
94 .TP
95 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#install--context'\fB\-\-context[=CTX]\fP\X'tty: link'
96 like \fB\-Z\fR, or if CTX is specified then set the
97 SELinux or SMACK security context to CTX
98 .TP
99 \X'tty: link https://www.gnu.org/software/coreutils/install#install--help'\fB\-\-help\fP\X'tty: link'
100 display this help and exit
101 .TP
102 \X'tty: link https://www.gnu.org/software/coreutils/install#install--version'\fB\-\-version\fP\X'tty: link'
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 Report bugs to: bug\[email protected]
124 .br
125 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
126 .br
127 General help using GNU software: <https://www.gnu.org/gethelp/>
128 .br
129 Report any translation bugs to <https://translationproject.org/team/>
130 .SH "SEE ALSO"
131 \fBcp\fP(1)
132 .PP
133 .br
134 Full documentation <https://www.gnu.org/software/coreutils/install>
135 .br
136 or available locally via: info \(aq(coreutils) install invocation\(aq
137 .PP
138 .br
139 Packaged by Debian (9.10\-1)
140 .br
141 Copyright \(co 2026 Free Software Foundation, Inc.
142 .br
143 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
144 .br
145 This is free software: you are free to change and redistribute it.
146 .br
147 There is NO WARRANTY, to the extent permitted by law.