xref: /csrg-svn/usr.bin/xinstall/install.1 (revision 62461)
1*62461Sbostic.\" Copyright (c) 1987, 1990, 1993
2*62461Sbostic.\"	The Regents of the University of California.  All rights reserved.
319722Smckusick.\"
449955Scael.\" %sccs.include.redist.roff%
519722Smckusick.\"
6*62461Sbostic.\"     @(#)install.1	8.1 (Berkeley) 06/06/93
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
1758431Sbostic.Op Fl f Ar flags
1858431Sbostic.Op Fl g Ar group
1949955Scael.Op Fl m Ar mode
2043697Scael.Op Fl o Ar owner
2144955Scael.Ar file1 file2
2244955Scael.Nm install
2344955Scael.Op Fl cs
2458431Sbostic.Op Fl f Ar flags
2558431Sbostic.Op Fl g Ar group
2649955Scael.Op Fl m Ar mode
2744955Scael.Op Fl o Ar owner
2843697Scael.Ar file1
2943697Scael\&...
3043697Scael.Ar fileN directory
3143697Scael.Sh DESCRIPTION
3239696SbosticThe file(s) are moved (or copied if the
3343697Scael.Fl c
3439696Sbosticoption is specified) to the target file or directory.
3539696SbosticIf the destination is a directory, then the
3643697Scael.Ar file
3739696Sbosticis moved into
3843697Scael.Ar directory
3939696Sbosticwith its original filename.
4039696SbosticIf the target file already exists, it is overwritten if permissions
4139696Sbosticallow.
4243697Scael.Pp
4349955Scael.Bl -tag -width Ds
4458431Sbostic.It Fl c
4558431SbosticCopy the file.
4658431SbosticThis flag turns off the default behavior of
4758431Sbostic.Nm install
4858431Sbosticwhere it deletes the original file after creating the target.
4958431Sbostic.It Fl f
5058431SbosticSpecify the target's file flags.
5158431Sbostic(See
5258431Sbostic.Xr chflags 1
5358431Sbosticfor a list of possible flags and their meanings.)
5458431Sbostic.It Fl g
5558431SbosticSpecify a group.
5649955Scael.It Fl m
5749955ScaelSpecify an alternate mode.
5858431SbosticThe default mode is set to rwxr-xr-x (0755).
5939827SbosticThe specified mode may be either an octal or symbolic value; see
6043697Scael.Xr chmod  1
6139827Sbosticfor a description of possible mode values.
6249955Scael.It Fl o
6343697ScaelSpecify an owner.
6449955Scael.It Fl s
6543697Scael.Nm Install
6639696Sbosticexec's the command
6743697Scael.Xr strip  1
6839696Sbosticto strip binaries so that install can be portable over a large
6939696Sbosticnumber of systems and binary types.
7049955Scael.El
7143697Scael.Pp
7258431SbosticBy default,
7354538Sbostic.Nm install
7458431Sbosticpreserves all file flags, with the exception of the ``nodump'' flag.
7543697Scael.Pp
7654538SbosticThe
7754538Sbostic.Nm install
7858431Sbosticutility attempts to prevent moving a file onto itself.
7954538Sbostic.Pp
8043697ScaelInstalling
8144955Scael.Pa /dev/null
8243697Scaelcreates an empty file.
8343697Scael.Pp
8439696SbosticUpon successful completion a value of 0 is returned.
8539696SbosticOtherwise, a value of 1 is returned.
8643697Scael.Sh SEE ALSO
8754538Sbostic.Xr chflags 1 ,
8843697Scael.Xr chgrp 1 ,
8943697Scael.Xr chmod 1 ,
9043697Scael.Xr cp 1 ,
9143697Scael.Xr mv 1 ,
9243697Scael.Xr strip 1 ,
9343697Scael.Xr chown 8
9443697Scael.Sh HISTORY
9549955ScaelThe
9649955Scael.Nm install
9749955Scaelutility appeared in
9849955Scael.Bx 4.2 .
99