|
|
1.1 root 1: .\" Copyright (c) 1987, 1990 The Regents of the University of California.
2: .\" All rights reserved.
3: .\"
4: .\" Redistribution and use in source and binary forms are permitted provided
5: .\" that: (1) source distributions retain this entire copyright notice and
6: .\" comment, and (2) distributions including binaries display the following
7: .\" acknowledgement: ``This product includes software developed by the
8: .\" University of California, Berkeley and its contributors'' in the
9: .\" documentation or other materials provided with the distribution and in
10: .\" all advertising materials mentioning features or use of this software.
11: .\" Neither the name of the University nor the names of its contributors may
12: .\" be used to endorse or promote products derived from this software without
13: .\" specific prior written permission.
14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
17: .\"
18: .\" @(#)install.1 6.9 (Berkeley) 7/24/90
19: .\"
20: .Dd July 24, 1990
21: .Dt INSTALL 1
22: .Os BSD 4.2
23: .Sh NAME
24: .Nm install
25: .Nd install binaries
26: .Sh SYNOPSIS
27: .Nm install
28: .Op Fl cs
29: .Op.Fl m Ar mode
30: .Op Fl o Ar owner
31: .Op Fl g Ar group
32: .Ar file1 file2
33: .Nm install
34: .Op Fl cs
35: .Op.Fl m Ar mode
36: .Op Fl o Ar owner
37: .Op Fl g Ar group
38: .Ar file1
39: \&...
40: .Ar fileN directory
41: .Sh DESCRIPTION
42: The file(s) are moved (or copied if the
43: .Fl c
44: option is specified) to the target file or directory.
45: If the destination is a directory, then the
46: .Ar file
47: is moved into
48: .Ar directory
49: with its original filename.
50: If the target file already exists, it is overwritten if permissions
51: allow.
52: .Pp
53: .Tw Ds
54: .Tp Fl m
55: option may be used to specify an alternate mode.
56: The default mode is set to 755.
57: The specified mode may be either an octal or symbolic value; see
58: .Xr chmod 1
59: for a description of possible mode values.
60: .Tp Fl o
61: Specify an owner.
62: .Tp Fl g
63: Specify a group.
64: .Tp Fl s
65: .Nm Install
66: exec's the command
67: .Xr strip 1
68: to strip binaries so that install can be portable over a large
69: number of systems and binary types.
70: .Tp
71: .Pp
72: .Nm Install
73: refuses to move a file onto itself.
74: .Pp
75: Installing
76: .Pa /dev/null
77: creates an empty file.
78: .Pp
79: Upon successful completion a value of 0 is returned.
80: Otherwise, a value of 1 is returned.
81: .Sh SEE ALSO
82: .Xr chgrp 1 ,
83: .Xr chmod 1 ,
84: .Xr cp 1 ,
85: .Xr mv 1 ,
86: .Xr strip 1 ,
87: .Xr a.out 5 ,
88: .Xr chown 8
89: .Sh HISTORY
90: .Nm Install
91: appeared in 4.2 BSD.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.