138 lines
4.1 KiB
Groff
138 lines
4.1 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
|
|
.TH INSTALL "1" "April 2025" "GNU coreutils 9.7" "User Commands"
|
|
.SH NAME
|
|
install \- copy files and set attributes
|
|
.SH SYNOPSIS
|
|
.B install
|
|
[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR
|
|
.br
|
|
.B install
|
|
[\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR
|
|
.br
|
|
.B install
|
|
[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR...
|
|
.br
|
|
.B install
|
|
[\fI\,OPTION\/\fR]... \fI\,-d DIRECTORY\/\fR...
|
|
.SH DESCRIPTION
|
|
.\" Add any additional description here
|
|
.PP
|
|
This install program copies files (often just compiled) into destination
|
|
locations you choose. If you want to download and install a ready\-to\-use
|
|
package on a GNU/Linux system, you should instead be using a package manager
|
|
like \fByum\fP(1) or \fBapt\-get\fP(1).
|
|
.PP
|
|
In the first three forms, copy SOURCE to DEST or multiple SOURCE(s) to
|
|
the existing DIRECTORY, while setting permission modes and owner/group.
|
|
In the 4th form, create all components of the given DIRECTORY(ies).
|
|
.PP
|
|
Mandatory arguments to long options are mandatory for short options too.
|
|
.TP
|
|
\fB\-\-backup\fR[=\fI\,CONTROL\/\fR]
|
|
make a backup of each existing destination file
|
|
.TP
|
|
\fB\-b\fR
|
|
like \fB\-\-backup\fR but does not accept an argument
|
|
.TP
|
|
\fB\-c\fR
|
|
(ignored)
|
|
.TP
|
|
\fB\-C\fR, \fB\-\-compare\fR
|
|
compare content of source and destination files, and
|
|
if no change to content, ownership, and permissions,
|
|
do not modify the destination at all
|
|
.TP
|
|
\fB\-d\fR, \fB\-\-directory\fR
|
|
treat all arguments as directory names; create all
|
|
components of the specified directories
|
|
.TP
|
|
\fB\-D\fR
|
|
create all leading components of DEST except the last,
|
|
or all components of \fB\-\-target\-directory\fR,
|
|
then copy SOURCE to DEST
|
|
.TP
|
|
\fB\-\-debug\fR
|
|
explain how a file is copied. Implies \fB\-v\fR
|
|
.TP
|
|
\fB\-g\fR, \fB\-\-group\fR=\fI\,GROUP\/\fR
|
|
set group ownership, instead of process' current group
|
|
.TP
|
|
\fB\-m\fR, \fB\-\-mode\fR=\fI\,MODE\/\fR
|
|
set permission mode (as in chmod), instead of rwxr\-xr\-x
|
|
.TP
|
|
\fB\-o\fR, \fB\-\-owner\fR=\fI\,OWNER\/\fR
|
|
set ownership (super\-user only)
|
|
.TP
|
|
\fB\-p\fR, \fB\-\-preserve\-timestamps\fR
|
|
apply access/modification times of SOURCE files
|
|
to corresponding destination files
|
|
.TP
|
|
\fB\-s\fR, \fB\-\-strip\fR
|
|
strip symbol tables
|
|
.TP
|
|
\fB\-\-strip\-program\fR=\fI\,PROGRAM\/\fR
|
|
program used to strip binaries
|
|
.TP
|
|
\fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
|
|
override the usual backup suffix
|
|
.TP
|
|
\fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR
|
|
copy all SOURCE arguments into DIRECTORY
|
|
.TP
|
|
\fB\-T\fR, \fB\-\-no\-target\-directory\fR
|
|
treat DEST as a normal file
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
print the name of each created file or directory
|
|
.TP
|
|
\fB\-\-preserve\-context\fR
|
|
preserve SELinux security context
|
|
.TP
|
|
\fB\-Z\fR
|
|
set SELinux security context of destination
|
|
file and each created directory to default type
|
|
.TP
|
|
\fB\-\-context\fR[=\fI\,CTX\/\fR]
|
|
like \fB\-Z\fR, or if CTX is specified then set the
|
|
SELinux or SMACK security context to CTX
|
|
.TP
|
|
\fB\-\-help\fR
|
|
display this help and exit
|
|
.TP
|
|
\fB\-\-version\fR
|
|
output version information and exit
|
|
.PP
|
|
The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
|
|
The version control method may be selected via the \fB\-\-backup\fR option or through
|
|
the VERSION_CONTROL environment variable. Here are the values:
|
|
.TP
|
|
none, off
|
|
never make backups (even if \fB\-\-backup\fR is given)
|
|
.TP
|
|
numbered, t
|
|
make numbered backups
|
|
.TP
|
|
existing, nil
|
|
numbered if numbered backups exist, simple otherwise
|
|
.TP
|
|
simple, never
|
|
always make simple backups
|
|
.SH AUTHOR
|
|
Written by David MacKenzie.
|
|
.SH "REPORTING BUGS"
|
|
GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
|
|
.br
|
|
Report any translation bugs to <https://translationproject.org/team/>
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2025 Free Software Foundation, Inc.
|
|
License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
|
|
.br
|
|
This is free software: you are free to change and redistribute it.
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
.SH "SEE ALSO"
|
|
\fBcp\fP(1)
|
|
.PP
|
|
.br
|
|
Full documentation <https://www.gnu.org/software/coreutils/install>
|
|
.br
|
|
or available locally via: info \(aq(coreutils) install invocation\(aq
|