1
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35.
2
.TH INSTALL "1" "October 2012" "GNU coreutils 8.20" "User Commands"
4
install \- copy files and set attributes
7
[\fIOPTION\fR]... [\fI-T\fR] \fISOURCE DEST\fR
10
[\fIOPTION\fR]... \fISOURCE\fR... \fIDIRECTORY\fR
13
[\fIOPTION\fR]... \fI-t DIRECTORY SOURCE\fR...
16
[\fIOPTION\fR]... \fI-d DIRECTORY\fR...
18
.\" Add any additional description here
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 yum(1) or apt\-get(1).
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).
29
Mandatory arguments to long options are mandatory for short options too.
31
\fB\-\-backup\fR[=\fICONTROL\fR]
32
make a backup of each existing destination file
35
like \fB\-\-backup\fR but does not accept an argument
40
\fB\-C\fR, \fB\-\-compare\fR
41
compare each pair of source and destination files, and
42
in some cases, do not modify the destination at all
44
\fB\-d\fR, \fB\-\-directory\fR
45
treat all arguments as directory names; create all
46
components of the specified directories
49
create all leading components of DEST except the last,
50
then copy SOURCE to DEST
52
\fB\-g\fR, \fB\-\-group\fR=\fIGROUP\fR
53
set group ownership, instead of process' current group
55
\fB\-m\fR, \fB\-\-mode\fR=\fIMODE\fR
56
set permission mode (as in chmod), instead of rwxr\-xr\-x
58
\fB\-o\fR, \fB\-\-owner\fR=\fIOWNER\fR
59
set ownership (super\-user only)
61
\fB\-p\fR, \fB\-\-preserve\-timestamps\fR
62
apply access/modification times of SOURCE files
63
to corresponding destination files
65
\fB\-s\fR, \fB\-\-strip\fR
68
\fB\-\-strip\-program\fR=\fIPROGRAM\fR
69
program used to strip binaries
71
\fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
72
override the usual backup suffix
74
\fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
75
copy all SOURCE arguments into DIRECTORY
77
\fB\-T\fR, \fB\-\-no\-target\-directory\fR
78
treat DEST as a normal file
80
\fB\-v\fR, \fB\-\-verbose\fR
81
print the name of each directory as it is created
83
\fB\-\-preserve\-context\fR
84
preserve SELinux security context
86
\fB\-Z\fR, \fB\-\-context\fR=\fICONTEXT\fR
87
set SELinux security context of files and directories
90
display this help and exit
93
output version information and exit
95
The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
96
The version control method may be selected via the \fB\-\-backup\fR option or through
97
the VERSION_CONTROL environment variable. Here are the values:
100
never make backups (even if \fB\-\-backup\fR is given)
103
make numbered backups
106
numbered if numbered backups exist, simple otherwise
109
always make simple backups
111
Written by David MacKenzie.
113
Report install bugs to bug\-coreutils@gnu.org
115
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
117
General help using GNU software: <http://www.gnu.org/gethelp/>
119
Report install translation bugs to <http://translationproject.org/team/>
121
Copyright \(co 2012 Free Software Foundation, Inc.
122
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
124
This is free software: you are free to change and redistribute it.
125
There is NO WARRANTY, to the extent permitted by law.
127
The full documentation for
129
is maintained as a Texinfo manual. If the
133
programs are properly installed at your site, the command
135
.B info coreutils \(aqinstall invocation\(aq
137
should give you access to the complete manual.