xref: /csrg-svn/usr.bin/xinstall/install.1 (revision 43697)
1*43697Scael.\" Copyright (c) 1987, 1990 The Regents of the University of California.
232700Sbostic.\" All rights reserved.
319722Smckusick.\"
4*43697Scael.\" %sccs.include.redist.man%
519722Smckusick.\"
6*43697Scael.\"     @(#)install.1	6.8 (Berkeley) 06/24/90
732700Sbostic.\"
8*43697Scael.Dd
9*43697Scael.Dt INSTALL 1
10*43697Scael.Os BSD 4.2
11*43697Scael.Sh NAME
12*43697Scael.Nm install
13*43697Scael.Nd install binaries
14*43697Scael.Sh SYNOPSIS
15*43697Scael.Nm install
16*43697Scael.Op Fl cs
17*43697Scael.Op.Fl m Ar mode
18*43697Scael.Op Fl o Ar owner
19*43697Scael.Op Fl g Ar group
20*43697Scael.Ar file1 file2 ;
21*43697Scaelor
22*43697Scael.if n .br
23*43697Scael.Ar file1
24*43697Scael\&...
25*43697Scael.Ar fileN directory
26*43697Scael.Sh DESCRIPTION
2739696SbosticThe file(s) are moved (or copied if the
28*43697Scael.Fl c
2939696Sbosticoption is specified) to the target file or directory.
3039696SbosticIf the destination is a directory, then the
31*43697Scael.Ar file
3239696Sbosticis moved into
33*43697Scael.Ar directory
3439696Sbosticwith its original filename.
3539696SbosticIf the target file already exists, it is overwritten if permissions
3639696Sbosticallow.
37*43697Scael.Pp
38*43697Scael.Tw Ds
39*43697Scael.Tp Fl m
4039696Sbosticoption may be used to specify an alternate mode.
41*43697ScaelThe default mode is set to 755.
4239827SbosticThe specified mode may be either an octal or symbolic value; see
43*43697Scael.Xr chmod  1
4439827Sbosticfor a description of possible mode values.
45*43697Scael.Tp Fl o
46*43697ScaelSpecify an owner.
47*43697Scael.Tp Fl g
48*43697ScaelSpecify a group.
49*43697Scael.Tp Fl s
50*43697Scael.Nm Install
5139696Sbosticexec's the command
52*43697Scael.Xr strip  1
5339696Sbosticto strip binaries so that install can be portable over a large
5439696Sbosticnumber of systems and binary types.
55*43697Scael.Tp
56*43697Scael.Pp
57*43697Scael.Nm Install
5839696Sbosticrefuses to move a file onto itself.
59*43697Scael.Pp
60*43697ScaelInstalling
61*43697Scael.Pa dev/null
62*43697Scaelcreates an empty file.
63*43697Scael.Pp
6439696SbosticUpon successful completion a value of 0 is returned.
6539696SbosticOtherwise, a value of 1 is returned.
66*43697Scael.Sh SEE ALSO
67*43697Scael.Xr chgrp 1 ,
68*43697Scael.Xr chmod 1 ,
69*43697Scael.Xr cp 1 ,
70*43697Scael.Xr mv 1 ,
71*43697Scael.Xr strip 1 ,
72*43697Scael.Xr a.out 5 ,
73*43697Scael.Xr chown 8
74*43697Scael.Sh HISTORY
75*43697Scael.Nm Install
76*43697Scaelappeared in 4.2 BSD.
77