xref: /csrg-svn/usr.bin/xinstall/install.1 (revision 43697)
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.8 (Berkeley) 06/24/90
7.\"
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
17.Op.Fl m Ar mode
18.Op Fl o Ar owner
19.Op Fl g Ar group
20.Ar file1 file2 ;
21or
22.if n .br
23.Ar file1
24\&...
25.Ar fileN directory
26.Sh DESCRIPTION
27The file(s) are moved (or copied if the
28.Fl c
29option is specified) to the target file or directory.
30If the destination is a directory, then the
31.Ar file
32is moved into
33.Ar directory
34with its original filename.
35If the target file already exists, it is overwritten if permissions
36allow.
37.Pp
38.Tw Ds
39.Tp Fl m
40option may be used to specify an alternate mode.
41The default mode is set to 755.
42The specified mode may be either an octal or symbolic value; see
43.Xr chmod  1
44for a description of possible mode values.
45.Tp Fl o
46Specify an owner.
47.Tp Fl g
48Specify a group.
49.Tp Fl s
50.Nm Install
51exec's the command
52.Xr strip  1
53to strip binaries so that install can be portable over a large
54number of systems and binary types.
55.Tp
56.Pp
57.Nm Install
58refuses to move a file onto itself.
59.Pp
60Installing
61.Pa dev/null
62creates an empty file.
63.Pp
64Upon successful completion a value of 0 is returned.
65Otherwise, a value of 1 is returned.
66.Sh SEE ALSO
67.Xr chgrp 1 ,
68.Xr chmod 1 ,
69.Xr cp 1 ,
70.Xr mv 1 ,
71.Xr strip 1 ,
72.Xr a.out 5 ,
73.Xr chown 8
74.Sh HISTORY
75.Nm Install
76appeared in 4.2 BSD.
77