| .Dd 2016-02-12 |
| .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 sD |
| .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 s |
| Remove unnecessary symbols using |
| .Xr strip 1 . |
| Failure to strip a file does not imply failure to install the file. |
| .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 , |
| .Xr strip 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. |