1.\" Copyright (c) 1987, 1990 The Regents of the University of California. 2.\" All rights reserved. 3.\" 4.\" %sccs.include.redist.roff% 5.\" 6.\" @(#)install.1 6.11 (Berkeley) 05/31/91 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 21.Nm install 22.Op Fl cs 23.Op Fl m Ar mode 24.Op Fl o Ar owner 25.Op Fl g Ar group 26.Ar file1 27\&... 28.Ar fileN directory 29.Sh DESCRIPTION 30The file(s) are moved (or copied if the 31.Fl c 32option is specified) to the target file or directory. 33If the destination is a directory, then the 34.Ar file 35is moved into 36.Ar directory 37with its original filename. 38If the target file already exists, it is overwritten if permissions 39allow. 40.Pp 41.Bl -tag -width Ds 42.It Fl m 43Specify an alternate mode. 44The default mode is set to 755. 45The specified mode may be either an octal or symbolic value; see 46.Xr chmod 1 47for a description of possible mode values. 48.It Fl o 49Specify an owner. 50.It Fl g 51Specify a group. 52.It Fl s 53.Nm Install 54exec's the command 55.Xr strip 1 56to strip binaries so that install can be portable over a large 57number of systems and binary types. 58.El 59.Pp 60.Nm Install 61refuses to move a file onto itself. 62.Pp 63Installing 64.Pa /dev/null 65creates an empty file. 66.Pp 67Upon successful completion a value of 0 is returned. 68Otherwise, a value of 1 is returned. 69.Sh SEE ALSO 70.Xr chgrp 1 , 71.Xr chmod 1 , 72.Xr cp 1 , 73.Xr mv 1 , 74.Xr strip 1 , 75.Xr a.out 5 , 76.Xr chown 8 77.Sh HISTORY 78The 79.Nm install 80utility appeared in 81.Bx 4.2 . 82