~ubuntu-branches/ubuntu/utopic/coreutils/utopic-proposed

« back to all changes in this revision

Viewing changes to man/install.1

  • Committer: Colin Watson
  • Date: 2013-10-30 15:48:33 UTC
  • mfrom: (8.3.5 sid)
  • Revision ID: cjwatson@canonical.com-20131030154833-xdt6e1yfffqom1c4
merge from Debian 8.21-1

Show diffs side-by-side

added added

removed removed

Lines of Context:
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"
3
 
.SH NAME
4
 
install \- copy files and set attributes
5
 
.SH SYNOPSIS
6
 
.B install
7
 
[\fIOPTION\fR]... [\fI-T\fR] \fISOURCE DEST\fR
8
 
.br
9
 
.B install
10
 
[\fIOPTION\fR]... \fISOURCE\fR... \fIDIRECTORY\fR
11
 
.br
12
 
.B install
13
 
[\fIOPTION\fR]... \fI-t DIRECTORY SOURCE\fR...
14
 
.br
15
 
.B install
16
 
[\fIOPTION\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 yum(1) or apt\-get(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[=\fICONTROL\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 each pair of source and destination files, and
42
 
in some cases, do not modify the destination at all
43
 
.TP
44
 
\fB\-d\fR, \fB\-\-directory\fR
45
 
treat all arguments as directory names; create all
46
 
components of the specified directories
47
 
.TP
48
 
\fB\-D\fR
49
 
create all leading components of DEST except the last,
50
 
then copy SOURCE to DEST
51
 
.TP
52
 
\fB\-g\fR, \fB\-\-group\fR=\fIGROUP\fR
53
 
set group ownership, instead of process' current group
54
 
.TP
55
 
\fB\-m\fR, \fB\-\-mode\fR=\fIMODE\fR
56
 
set permission mode (as in chmod), instead of rwxr\-xr\-x
57
 
.TP
58
 
\fB\-o\fR, \fB\-\-owner\fR=\fIOWNER\fR
59
 
set ownership (super\-user only)
60
 
.TP
61
 
\fB\-p\fR, \fB\-\-preserve\-timestamps\fR
62
 
apply access/modification times of SOURCE files
63
 
to corresponding destination files
64
 
.TP
65
 
\fB\-s\fR, \fB\-\-strip\fR
66
 
strip symbol tables
67
 
.TP
68
 
\fB\-\-strip\-program\fR=\fIPROGRAM\fR
69
 
program used to strip binaries
70
 
.TP
71
 
\fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
72
 
override the usual backup suffix
73
 
.TP
74
 
\fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
75
 
copy all SOURCE arguments into DIRECTORY
76
 
.TP
77
 
\fB\-T\fR, \fB\-\-no\-target\-directory\fR
78
 
treat DEST as a normal file
79
 
.TP
80
 
\fB\-v\fR, \fB\-\-verbose\fR
81
 
print the name of each directory as it is created
82
 
.TP
83
 
\fB\-\-preserve\-context\fR
84
 
preserve SELinux security context
85
 
.TP
86
 
\fB\-Z\fR, \fB\-\-context\fR=\fICONTEXT\fR
87
 
set SELinux security context of files and directories
88
 
.TP
89
 
\fB\-\-help\fR
90
 
display this help and exit
91
 
.TP
92
 
\fB\-\-version\fR
93
 
output version information and exit
94
 
.PP
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:
98
 
.TP
99
 
none, off
100
 
never make backups (even if \fB\-\-backup\fR is given)
101
 
.TP
102
 
numbered, t
103
 
make numbered backups
104
 
.TP
105
 
existing, nil
106
 
numbered if numbered backups exist, simple otherwise
107
 
.TP
108
 
simple, never
109
 
always make simple backups
110
 
.SH AUTHOR
111
 
Written by David MacKenzie.
112
 
.SH "REPORTING BUGS"
113
 
Report install bugs to bug\-coreutils@gnu.org
114
 
.br
115
 
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
116
 
.br
117
 
General help using GNU software: <http://www.gnu.org/gethelp/>
118
 
.br
119
 
Report install translation bugs to <http://translationproject.org/team/>
120
 
.SH COPYRIGHT
121
 
Copyright \(co 2012 Free Software Foundation, Inc.
122
 
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
123
 
.br
124
 
This is free software: you are free to change and redistribute it.
125
 
There is NO WARRANTY, to the extent permitted by law.
126
 
.SH "SEE ALSO"
127
 
The full documentation for
128
 
.B install
129
 
is maintained as a Texinfo manual.  If the
130
 
.B info
131
 
and
132
 
.B install
133
 
programs are properly installed at your site, the command
134
 
.IP
135
 
.B info coreutils \(aqinstall invocation\(aq
136
 
.PP
137
 
should give you access to the complete manual.