INSTALL(1)

NAME
ginstall - copy files and set attributes

SYNOPSIS
install [OPTION]... SOURCE DEST (1st format)
install [OPTION]... SOURCE... DIRECTORY (2nd format)
install -d [OPTION]... DIRECTORY... (3rd format)

DESCRIPTION

In the first two formats, copy SOURCE to DEST or multiple SOURCE(s) to the existing DIRECTORY, while setting permission modes and owner/group. In the third format, create all components of the given DIRECTORY(ies).

Mandatory arguments to long options are mandatory for short options too.

--backup[=CONTROL] make a backup of each existing destination file

-b  like --backup but does not accept an argument

-c  (ignored)

-C  Install file, unless target already exists and is the same as the new file, in which case the modification time won't be changed.

-d, --directory
    treat all arguments as directory names; create all components of the specified directories

-D  create all leading components of DEST except the last, then copy SOURCE to DEST; useful in the 1st format

-g, --group=GROUP
    set group ownership, instead of process' current group

-m, --mode=MODE
    set permission mode (as in chmod), instead of rwxr-xr-x

-o, --owner=OWNER
    set ownership (super-user only)

-p, --preserve-timestamps
    apply access/modification times of SOURCE files to corresponding destination files

-s, --strip
    strip symbol tables, only for 1st and 2nd formats

-S, --suffix=SUFFIX override the usual backup suffix

-v, --verbose
    print the name of each directory as it is created

-P, --preserve_context (SELinux) Preserve security context

-Z, --context=CONTEXT
    (SELinux) Set security context of files and directories

--help
    display this help and exit

--version
    output version information and exit

The backup suffix is `~', unless set with --suffix or SIMPLE_BACKUP_SUFFIX. The version control method may be selected via the --backup option or through the VERSION_CONTROL environment variable. Here are the values:

none, off
    never make backups (even if --backup is given)

numbered, t
    make numbered backups

existing, nil
    numbered if numbered backups exist, simple otherwise

simple, never
    always make simple backups

AUTHOR
Written by David MacKenzie.

REPORTING BUGS
Report bugs to <bug-coreutils@gnu.org>.

COPYRIGHT
Copyright © 2004 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO
The full documentation for install is maintained as a Texinfo manual. If the info and install programs are properly installed at your site, the command

    info coreutils install

should give you access to the complete manual.