xref: /original-bsd/usr.bin/xinstall/install.1 (revision 7bad34b3)
1.\" Copyright (c) 1987, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)install.1	6.10 (Berkeley) 03/14/91
7.\"
8.Vx
9.Vx
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
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
28.Ar file1
29\&...
30.Ar fileN directory
31.Sh DESCRIPTION
32The file(s) are moved (or copied if the
33.Fl c
34option is specified) to the target file or directory.
35If the destination is a directory, then the
36.Ar file
37is moved into
38.Ar directory
39with its original filename.
40If the target file already exists, it is overwritten if permissions
41allow.
42.Pp
43.Tw Ds
44.Tp Fl m
45option may be used to specify an alternate mode.
46The default mode is set to 755.
47The specified mode may be either an octal or symbolic value; see
48.Xr chmod  1
49for a description of possible mode values.
50.Tp Fl o
51Specify an owner.
52.Tp Fl g
53Specify a group.
54.Tp Fl s
55.Nm Install
56exec's the command
57.Xr strip  1
58to strip binaries so that install can be portable over a large
59number of systems and binary types.
60.Tp
61.Pp
62.Nm Install
63refuses to move a file onto itself.
64.Pp
65Installing
66.Pa /dev/null
67creates an empty file.
68.Pp
69Upon successful completion a value of 0 is returned.
70Otherwise, a value of 1 is returned.
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
81appeared in 4.2 BSD.
82