Commit | Line | Data |
---|---|---|
d9d7a9f0 | 1 | .\" Copyright (c) 1987, 1990 The Regents of the University of California. |
033e16ea | 2 | .\" All rights reserved. |
db222088 | 3 | .\" |
06593651 | 4 | .\" %sccs.include.redist.roff% |
033e16ea | 5 | .\" |
06593651 | 6 | .\" @(#)install.1 6.11 (Berkeley) %G% |
db222088 | 7 | .\" |
d9d7a9f0 CL |
8 | .Dd |
9 | .Dt INSTALL 1 | |
10 | .Os BSD 4.2 | |
11 | .Sh NAME | |
12 | .Nm install | |
13 | .Nd install binaries | |
14 | .Sh SYNOPSIS | |
15 | .Nm install | |
16 | .Op Fl cs | |
06593651 | 17 | .Op Fl m Ar mode |
d9d7a9f0 CL |
18 | .Op Fl o Ar owner |
19 | .Op Fl g Ar group | |
5325ced3 CL |
20 | .Ar file1 file2 |
21 | .Nm install | |
22 | .Op Fl cs | |
06593651 | 23 | .Op Fl m Ar mode |
5325ced3 CL |
24 | .Op Fl o Ar owner |
25 | .Op Fl g Ar group | |
d9d7a9f0 CL |
26 | .Ar file1 |
27 | \&... | |
28 | .Ar fileN directory | |
29 | .Sh DESCRIPTION | |
fe1faba3 | 30 | The file(s) are moved (or copied if the |
d9d7a9f0 | 31 | .Fl c |
fe1faba3 KB |
32 | option is specified) to the target file or directory. |
33 | If the destination is a directory, then the | |
d9d7a9f0 | 34 | .Ar file |
fe1faba3 | 35 | is moved into |
d9d7a9f0 | 36 | .Ar directory |
fe1faba3 KB |
37 | with its original filename. |
38 | If the target file already exists, it is overwritten if permissions | |
39 | allow. | |
d9d7a9f0 | 40 | .Pp |
06593651 CL |
41 | .Bl -tag -width Ds |
42 | .It Fl m | |
43 | Specify an alternate mode. | |
d9d7a9f0 | 44 | The default mode is set to 755. |
915c21b8 | 45 | The specified mode may be either an octal or symbolic value; see |
d9d7a9f0 | 46 | .Xr chmod 1 |
915c21b8 | 47 | for a description of possible mode values. |
06593651 | 48 | .It Fl o |
d9d7a9f0 | 49 | Specify an owner. |
06593651 | 50 | .It Fl g |
d9d7a9f0 | 51 | Specify a group. |
06593651 | 52 | .It Fl s |
d9d7a9f0 | 53 | .Nm Install |
fe1faba3 | 54 | exec's the command |
d9d7a9f0 | 55 | .Xr strip 1 |
fe1faba3 KB |
56 | to strip binaries so that install can be portable over a large |
57 | number of systems and binary types. | |
06593651 | 58 | .El |
d9d7a9f0 CL |
59 | .Pp |
60 | .Nm Install | |
fe1faba3 | 61 | refuses to move a file onto itself. |
d9d7a9f0 CL |
62 | .Pp |
63 | Installing | |
5325ced3 | 64 | .Pa /dev/null |
d9d7a9f0 CL |
65 | creates an empty file. |
66 | .Pp | |
fe1faba3 KB |
67 | Upon successful completion a value of 0 is returned. |
68 | Otherwise, a value of 1 is returned. | |
d9d7a9f0 CL |
69 | .Sh SEE ALSO |
70 | .Xr chgrp 1 , | |
71 | .Xr chmod 1 , | |
72 | .Xr cp 1 , | |
73 | .Xr mv 1 , | |
74 | .Xr strip 1 , | |
75 | .Xr a.out 5 , | |
76 | .Xr chown 8 | |
77 | .Sh HISTORY | |
06593651 CL |
78 | The |
79 | .Nm install | |
80 | utility appeared in | |
81 | .Bx 4.2 . |