Commit | Line | Data |
---|---|---|
033e16ea KB |
1 | .\" Copyright (c) 1987 Regents of the University of California. |
2 | .\" All rights reserved. | |
db222088 | 3 | .\" |
033e16ea | 4 | .\" Redistribution and use in source and binary forms are permitted |
57a981eb KB |
5 | .\" provided that the above copyright notice and this paragraph are |
6 | .\" duplicated in all such forms and that any documentation, | |
7 | .\" advertising materials, and other materials related to such | |
8 | .\" distribution and use acknowledge that the software was developed | |
9 | .\" by the University of California, Berkeley. The name of the | |
10 | .\" University may not be used to endorse or promote products derived | |
11 | .\" from this software without specific prior written permission. | |
12 | .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR | |
13 | .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED | |
fe1faba3 | 14 | .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. |
033e16ea | 15 | .\" |
915c21b8 | 16 | .\" @(#)install.1 6.7 (Berkeley) %G% |
db222088 | 17 | .\" |
ef8cedab | 18 | .TH INSTALL 1 "" |
db222088 KM |
19 | .UC 5 |
20 | .SH NAME | |
21 | install \- install binaries | |
22 | .SH SYNOPSIS | |
23 | .B install | |
24 | [ | |
fe1faba3 | 25 | .B \-cs |
db222088 KM |
26 | ] [ |
27 | .B \-m | |
28 | mode ] [ | |
29 | .B \-o | |
30 | owner ] [ | |
31 | .B \-g | |
fe1faba3 | 32 | group ] file1 file2; or file1 ... fileN directory |
db222088 | 33 | .SH DESCRIPTION |
fe1faba3 KB |
34 | The file(s) are moved (or copied if the |
35 | .I -c | |
36 | option is specified) to the target file or directory. | |
37 | If the destination is a directory, then the | |
38 | .I file | |
39 | is moved into | |
40 | .I directory | |
41 | with its original filename. | |
42 | If the target file already exists, it is overwritten if permissions | |
43 | allow. | |
db222088 | 44 | .PP |
fe1faba3 KB |
45 | The mode is set to 755; the |
46 | .I -m | |
47 | option may be used to specify an alternate mode. | |
915c21b8 KB |
48 | The specified mode may be either an octal or symbolic value; see |
49 | .IR chmod (1) | |
50 | for a description of possible mode values. | |
db222088 | 51 | .PP |
fe1faba3 KB |
52 | The |
53 | .I -o | |
54 | and | |
55 | .I -g | |
56 | options may be used to specify an owner and/or group, respectively. | |
db222088 | 57 | .PP |
fe1faba3 KB |
58 | The |
59 | .I -s | |
60 | option causes the file to be stripped. | |
61 | .I Install | |
62 | exec's the command | |
63 | .IR strip (1) | |
64 | to strip binaries so that install can be portable over a large | |
65 | number of systems and binary types. | |
db222088 | 66 | .PP |
fe1faba3 KB |
67 | .I Install |
68 | refuses to move a file onto itself. | |
033e16ea KB |
69 | .PP |
70 | Installing ``/dev/null'' creates an empty file. | |
8d09ec9f | 71 | .SH "RETURN VALUE" |
fe1faba3 KB |
72 | Upon successful completion a value of 0 is returned. |
73 | Otherwise, a value of 1 is returned. | |
db222088 | 74 | .SH "SEE ALSO" |
8d09ec9f | 75 | chgrp(1), chmod(1), cp(1), mv(1), strip(1), a.out(5), chown(8) |