man-pages/man1/install.1.html
2021-03-31 01:06:50 +01:00

165 lines
5.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of INSTALL</TITLE>
</HEAD><BODY>
<H1>INSTALL</H1>
Section: User Commands (1)<BR>Updated: September 2019<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
install - copy files and set attributes
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>install</B>
[<I>,OPTION/</I>]... [<I>,-T/</I>] <I>,SOURCE DEST/</I>
<BR>
<B>install</B>
[<I>,OPTION/</I>]... <I>,SOURCE/</I>... <I>,DIRECTORY/</I>
<BR>
<B>install</B>
[<I>,OPTION/</I>]... <I>,-t DIRECTORY SOURCE/</I>...
<BR>
<B>install</B>
[<I>,OPTION/</I>]... <I>,-d DIRECTORY/</I>...
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<P>
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 <A HREF="/cgi-bin/man/man2html?1+yum">yum</A>(1) or <A HREF="/cgi-bin/man/man2html?1+apt-get">apt-get</A>(1).
<P>
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).
<P>
Mandatory arguments to long options are mandatory for short options too.
<DL COMPACT>
<DT id="1"><B>--backup</B>[=<I>,CONTROL/</I>]<DD>
make a backup of each existing destination file
<DT id="2"><B>-b</B><DD>
like <B>--backup</B> but does not accept an argument
<DT id="3"><B>-c</B><DD>
(ignored)
<DT id="4"><B>-C</B>, <B>--compare</B><DD>
compare each pair of source and destination files, and
in some cases, do not modify the destination at all
<DT id="5"><B>-d</B>, <B>--directory</B><DD>
treat all arguments as directory names; create all
components of the specified directories
<DT id="6"><B>-D</B><DD>
create all leading components of DEST except the last,
or all components of <B>--target-directory</B>,
then copy SOURCE to DEST
<DT id="7"><B>-g</B>, <B>--group</B>=<I>,GROUP/</I><DD>
set group ownership, instead of process' current group
<DT id="8"><B>-m</B>, <B>--mode</B>=<I>,MODE/</I><DD>
set permission mode (as in chmod), instead of rwxr-xr-x
<DT id="9"><B>-o</B>, <B>--owner</B>=<I>,OWNER/</I><DD>
set ownership (super-user only)
<DT id="10"><B>-p</B>, <B>--preserve-timestamps</B><DD>
apply access/modification times of SOURCE files
to corresponding destination files
<DT id="11"><B>-s</B>, <B>--strip</B><DD>
strip symbol tables
<DT id="12"><B>--strip-program</B>=<I>,PROGRAM/</I><DD>
program used to strip binaries
<DT id="13"><B>-S</B>, <B>--suffix</B>=<I>,SUFFIX/</I><DD>
override the usual backup suffix
<DT id="14"><B>-t</B>, <B>--target-directory</B>=<I>,DIRECTORY/</I><DD>
copy all SOURCE arguments into DIRECTORY
<DT id="15"><B>-T</B>, <B>--no-target-directory</B><DD>
treat DEST as a normal file
<DT id="16"><B>-v</B>, <B>--verbose</B><DD>
print the name of each directory as it is created
<DT id="17"><B>--preserve-context</B><DD>
preserve SELinux security context
<DT id="18"><B>-Z</B><DD>
set SELinux security context of destination
file and each created directory to default type
<DT id="19"><B>--context</B>[=<I>,CTX/</I>]<DD>
like <B>-Z</B>, or if CTX is specified then set the
SELinux or SMACK security context to CTX
<DT id="20"><B>--help</B><DD>
display this help and exit
<DT id="21"><B>--version</B><DD>
output version information and exit
</DL>
<P>
The backup suffix is '~', unless set with <B>--suffix</B> or SIMPLE_BACKUP_SUFFIX.
The version control method may be selected via the <B>--backup</B> option or through
the VERSION_CONTROL environment variable. Here are the values:
<DL COMPACT>
<DT id="22">none, off<DD>
never make backups (even if <B>--backup</B> is given)
<DT id="23">numbered, t<DD>
make numbered backups
<DT id="24">existing, nil<DD>
numbered if numbered backups exist, simple otherwise
<DT id="25">simple, never<DD>
always make simple backups
</DL>
<A NAME="lbAE">&nbsp;</A>
<H2>AUTHOR</H2>
Written by David MacKenzie.
<A NAME="lbAF">&nbsp;</A>
<H2>REPORTING BUGS</H2>
GNU coreutils online help: &lt;<A HREF="https://www.gnu.org/software/coreutils/">https://www.gnu.org/software/coreutils/</A>&gt;
<BR>
Report install translation bugs to &lt;<A HREF="https://translationproject.org/team/">https://translationproject.org/team/</A>&gt;
<A NAME="lbAG">&nbsp;</A>
<H2>COPYRIGHT</H2>
Copyright &#169; 2018 Free Software Foundation, Inc.
License GPLv3+: GNU GPL version 3 or later &lt;<A HREF="https://gnu.org/licenses/gpl.html">https://gnu.org/licenses/gpl.html</A>&gt;.
<BR>
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
Full documentation at: &lt;<A HREF="https://www.gnu.org/software/coreutils/install">https://www.gnu.org/software/coreutils/install</A>&gt;
<BR>
or available locally via: info '(coreutils) install invocation'
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="26"><A HREF="#lbAB">NAME</A><DD>
<DT id="27"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="28"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="29"><A HREF="#lbAE">AUTHOR</A><DD>
<DT id="30"><A HREF="#lbAF">REPORTING BUGS</A><DD>
<DT id="31"><A HREF="#lbAG">COPYRIGHT</A><DD>
<DT id="32"><A HREF="#lbAH">SEE ALSO</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:17 GMT, March 31, 2021
</BODY>
</HTML>