1INSTALL(1) User Commands INSTALL(1)
2
3
4
6 install - copy files and set attributes
7
9 install [OPTION]... [-T] SOURCE DEST
10 install [OPTION]... SOURCE... DIRECTORY
11 install [OPTION]... -t DIRECTORY SOURCE...
12 install [OPTION]... -d DIRECTORY...
13
15 This install program copies files (often just compiled) into destina‐
16 tion locations you choose. If you want to download and install a
17 ready-to-use package on a GNU/Linux system, you should instead be using
18 a package manager like yum(1) or apt-get(1).
19
20 In the first three forms, copy SOURCE to DEST or multiple SOURCE(s) to
21 the existing DIRECTORY, while setting permission modes and owner/group.
22 In the 4th form, create all components of the given DIRECTORY(ies).
23
24 Mandatory arguments to long options are mandatory for short options
25 too.
26
27 --backup[=CONTROL]
28 make a backup of each existing destination file
29
30 -b like --backup but does not accept an argument
31
32 -c (ignored)
33
34 -C, --compare
35 compare each pair of source and destination files, and in some
36 cases, do not modify the destination at all
37
38 -d, --directory
39 treat all arguments as directory names; create all components of
40 the specified directories
41
42 -D create all leading components of DEST except the last, then copy
43 SOURCE to DEST
44
45 -g, --group=GROUP
46 set group ownership, instead of process' current group
47
48 -m, --mode=MODE
49 set permission mode (as in chmod), instead of rwxr-xr-x
50
51 -o, --owner=OWNER
52 set ownership (super-user only)
53
54 -p, --preserve-timestamps
55 apply access/modification times of SOURCE files to corresponding
56 destination files
57
58 -s, --strip
59 strip symbol tables
60
61 --strip-program=PROGRAM
62 program used to strip binaries
63
64 -S, --suffix=SUFFIX
65 override the usual backup suffix
66
67 -t, --target-directory=DIRECTORY
68 copy all SOURCE arguments into DIRECTORY
69
70 -T, --no-target-directory
71 treat DEST as a normal file
72
73 -v, --verbose
74 print the name of each directory as it is created
75
76 -P, --preserve-context (SELinux) preserve security context
77
78 -Z, --context=CONTEXT
79 (SELinux) set security context of files and directories
80
81 --help display this help and exit
82
83 --version
84 output version information and exit
85
86 The backup suffix is `~', unless set with --suffix or SIM‐
87 PLE_BACKUP_SUFFIX. The version control method may be selected via the
88 --backup option or through the VERSION_CONTROL environment variable.
89 Here are the values:
90
91 none, off
92 never make backups (even if --backup is given)
93
94 numbered, t
95 make numbered backups
96
97 existing, nil
98 numbered if numbered backups exist, simple otherwise
99
100 simple, never
101 always make simple backups
102
104 Written by David MacKenzie.
105
107 Report install bugs to bug-coreutils@gnu.org
108 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
109 General help using GNU software: <http://www.gnu.org/gethelp/>
110 Report install translation bugs to <http://translationpro‐
111 ject.org/team/>
112
114 Copyright © 2010 Free Software Foundation, Inc. License GPLv3+: GNU
115 GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
116 This is free software: you are free to change and redistribute it.
117 There is NO WARRANTY, to the extent permitted by law.
118
120 The full documentation for install is maintained as a Texinfo manual.
121 If the info and install programs are properly installed at your site,
122 the command
123
124 info coreutils 'install invocation'
125
126 should give you access to the complete manual.
127
128
129
130GNU coreutils 8.5 November 2010 INSTALL(1)