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

    --help display this help and exit

    --version
    output version information and exit

    The backup suffix is `~', unless set with  --suffix  or  SIM-
    PLE_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 (C) 2002 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 install

    should give you access to the complete manual.