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