xref: /csrg-svn/usr.bin/xinstall/install.1 (revision 44955)
143697Scael.\" Copyright (c) 1987, 1990 The Regents of the University of California.
232700Sbostic.\" All rights reserved.
319722Smckusick.\"
443697Scael.\" %sccs.include.redist.man%
519722Smckusick.\"
6*44955Scael.\"     @(#)install.1	6.9 (Berkeley) 07/24/90
732700Sbostic.\"
843697Scael.Dd
943697Scael.Dt INSTALL 1
1043697Scael.Os BSD 4.2
1143697Scael.Sh NAME
1243697Scael.Nm install
1343697Scael.Nd install binaries
1443697Scael.Sh SYNOPSIS
1543697Scael.Nm install
1643697Scael.Op Fl cs
1743697Scael.Op.Fl m Ar mode
1843697Scael.Op Fl o Ar owner
1943697Scael.Op Fl g Ar group
20*44955Scael.Ar file1 file2
21*44955Scael.Nm install
22*44955Scael.Op Fl cs
23*44955Scael.Op.Fl m Ar mode
24*44955Scael.Op Fl o Ar owner
25*44955Scael.Op Fl g Ar group
2643697Scael.Ar file1
2743697Scael\&...
2843697Scael.Ar fileN directory
2943697Scael.Sh DESCRIPTION
3039696SbosticThe file(s) are moved (or copied if the
3143697Scael.Fl c
3239696Sbosticoption is specified) to the target file or directory.
3339696SbosticIf the destination is a directory, then the
3443697Scael.Ar file
3539696Sbosticis moved into
3643697Scael.Ar directory
3739696Sbosticwith its original filename.
3839696SbosticIf the target file already exists, it is overwritten if permissions
3939696Sbosticallow.
4043697Scael.Pp
4143697Scael.Tw Ds
4243697Scael.Tp Fl m
4339696Sbosticoption may be used to specify an alternate mode.
4443697ScaelThe default mode is set to 755.
4539827SbosticThe specified mode may be either an octal or symbolic value; see
4643697Scael.Xr chmod  1
4739827Sbosticfor a description of possible mode values.
4843697Scael.Tp Fl o
4943697ScaelSpecify an owner.
5043697Scael.Tp Fl g
5143697ScaelSpecify a group.
5243697Scael.Tp Fl s
5343697Scael.Nm Install
5439696Sbosticexec's the command
5543697Scael.Xr strip  1
5639696Sbosticto strip binaries so that install can be portable over a large
5739696Sbosticnumber of systems and binary types.
5843697Scael.Tp
5943697Scael.Pp
6043697Scael.Nm Install
6139696Sbosticrefuses to move a file onto itself.
6243697Scael.Pp
6343697ScaelInstalling
64*44955Scael.Pa /dev/null
6543697Scaelcreates an empty file.
6643697Scael.Pp
6739696SbosticUpon successful completion a value of 0 is returned.
6839696SbosticOtherwise, a value of 1 is returned.
6943697Scael.Sh SEE ALSO
7043697Scael.Xr chgrp 1 ,
7143697Scael.Xr chmod 1 ,
7243697Scael.Xr cp 1 ,
7343697Scael.Xr mv 1 ,
7443697Scael.Xr strip 1 ,
7543697Scael.Xr a.out 5 ,
7643697Scael.Xr chown 8
7743697Scael.Sh HISTORY
7843697Scael.Nm Install
7943697Scaelappeared in 4.2 BSD.
80