fbt/sbase
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
4fcb31c6e0
sbase/xinstall.1

87 lines
1.5 KiB
Groff
Raw Normal View History

Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 22:37:31 +00:00
.Dd 2016-12-03
New command with corresponding man page. Includes the flags: -s strip binary -d create directory -D create missing directories -t DIR target directory -m MODE permission bits -o USER set owner -g GROUP set group Installed files are copied, and default mode is 755. Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-02-12 13:33:09 +00:00
.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 ...
|
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-03 11:51:14 +00:00
.Op Fl D
New command with corresponding man page. Includes the flags: -s strip binary -d create directory -D create missing directories -t DIR target directory -m MODE permission bits -o USER set owner -g GROUP set group Installed files are copied, and default mode is 755. Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-02-12 13:33:09 +00:00
.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
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 22:37:31 +00:00
is treated as a directory.
Otherwise
install: treat target as file by default instead of dir When using 'install foo bar', bar should be treated as a file copy of foo, not a directory to be created and into which install foo.
2016-02-18 10:35:22 +00:00
.Ar dest
is treated as a filename.
New command with corresponding man page. Includes the flags: -s strip binary -d create directory -D create missing directories -t DIR target directory -m MODE permission bits -o USER set owner -g GROUP set group Installed files are copied, and default mode is 755. Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-02-12 13:33:09 +00:00
.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
install: treat target as file by default instead of dir When using 'install foo bar', bar should be treated as a file copy of foo, not a directory to be created and into which install foo.
2016-02-18 10:35:22 +00:00
is to be treated as a directory, it is created too if missing.
New command with corresponding man page. Includes the flags: -s strip binary -d create directory -D create missing directories -t DIR target directory -m MODE permission bits -o USER set owner -g GROUP set group Installed files are copied, and default mode is 755. Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-02-12 13:33:09 +00:00
.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
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 22:37:31 +00:00
Change the file modes.
Both numerical and symbolic values are supported.
See
New command with corresponding man page. Includes the flags: -s strip binary -d create directory -D create missing directories -t DIR target directory -m MODE permission bits -o USER set owner -g GROUP set group Installed files are copied, and default mode is 755. Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-02-12 13:33:09 +00:00
.Xr chmod 1
for the syntex.
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 22:37:31 +00:00
Default mode 0755.
If a file has the mode 0644 and is copied with
New command with corresponding man page. Includes the flags: -s strip binary -d create directory -D create missing directories -t DIR target directory -m MODE permission bits -o USER set owner -g GROUP set group Installed files are copied, and default mode is 755. Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-02-12 13:33:09 +00:00
.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
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 22:37:31 +00:00
is used to select another mode.
When the symbolic notation is used, the base mode is 0000.
Add missing .El to xinstall.1
2016-02-18 10:54:17 +00:00
.El
New command with corresponding man page. Includes the flags: -s strip binary -d create directory -D create missing directories -t DIR target directory -m MODE permission bits -o USER set owner -g GROUP set group Installed files are copied, and default mode is 755. Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-02-12 13:33:09 +00:00
.Sh SEE ALSO
.Xr chmod 1 ,
.Xr chown 1 ,
.Xr cp 1 ,
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-03 11:51:14 +00:00
.Xr mkdir 1
New command with corresponding man page. Includes the flags: -s strip binary -d create directory -D create missing directories -t DIR target directory -m MODE permission bits -o USER set owner -g GROUP set group Installed files are copied, and default mode is 755. Signed-off-by: Mattias Andrée <maandree@kth.se>
2016-02-12 13:33:09 +00:00
.Sh STANDARDS
The
.Nm
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command.
2020-03-01 22:37:31 +00:00
utility is not standardized.
This implementation is a subset of the GNU implementation and a subset
with extensions to the FreeBSD implementation.
Reference in New Issue Copy Permalink