sbase/xinstall.1
Mattias Andrée 609169d600 install: ignore -s
The -s flag previously called strip(1) on the installed file.
This patch changes install(1)'s behaviour to ignore -s.

Many makefiles use the -s flag, so it has to be recognised for
compatibility, however it does not have to do anything because
symbols do not negatively affect the functionallity of binaries.

Ignoring -s have the added benefit that the user do not need
to edit makefiles if they want the symbols that are useful for
debugging. If the user wants to strip away symbols, it can be
done manually or automatically by the package manager.

Laslo: Update the man-date and remove -s from usage()

Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-12-27 13:56:27 +01:00

85 lines
1.5 KiB
Groff

.Dd 2016-24-27
.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.