.Dd 2016-12-03
.Dt INSTALL 1
.Os sbase
.Sh NAME
.Nm install
.Nd copy files and set attributes
.Sh SYNOPSIS
.Nm
.Op Fl g Ar group
.Op Fl o Ar owner
.Op Fl m Ar mode
.Po
.Fl d Ar dir ...
|
.Op Fl D
.Po
.Fl t Ar dest
.Ar source ...
|
.Ar source ...
.Ar dest
.Pc
.Pc
.Sh DESCRIPTION
.Nm
copies
.Ar source
to
.Ar dest .
If more than one
.Ar source
is given
.Ar dest
is treated as a directory.
Otherwise
.Ar dest
is treated as a filename.
.Nm
can also change the attributes of the copies.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl d
Create the directories
.Ar dir .
.It Fl D
Create missing parent directories to
.Ar dest .
If
.Ar dest
is to be treated as a directory, it is created too if missing.
.It Fl g Ar group
Change the installed files' group to
.Ar group .
This may be a group name or a group identifier.
.It Fl m Ar mode
Change the file modes.
Both numerical and symbolic values are supported.
See
.Xr chmod 1
for the syntex.
Default mode 0755.
If a file has the mode 0644 and is copied with
.It Fl o Ar owner
Change the installed files' owner to
.Ar owner .
This may be a user name or a user identifier.
.It Fl t Ar dest
Copy files into the directory
.Ar dest .
.Nm install ,
the copy's mode will be 0755 unless
.Fl m
is used to select another mode.
When the symbolic notation is used, the base mode is 0000.
.El
.Sh SEE ALSO
.Xr chmod 1 ,
.Xr chown 1 ,
.Xr cp 1 ,
.Xr mkdir 1
.Sh STANDARDS
The
.Nm
utility is not standardized.
This implementation is a subset of the GNU implementation and a subset
with extensions to the FreeBSD implementation.