man/install.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH INSTALL "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 install \- copy files and set attributes
   5 .SH SYNOPSIS
   6 .B install
   7 [\fIOPTION\fR]... [\fI-T\fR] \fISOURCE DEST\fR
   8 .br
   9 .B install
  10 [\fIOPTION\fR]... \fISOURCE\fR... \fIDIRECTORY\fR
  11 .br
  12 .B install
  13 [\fIOPTION\fR]... \fI-t DIRECTORY SOURCE\fR...
  14 .br
  15 .B install
  16 [\fIOPTION\fR]... \fI-d DIRECTORY\fR...
  17 .SH DESCRIPTION
  18 .\" Add any additional description here
  19 .PP
  20 In the first three forms, copy SOURCE to DEST or multiple SOURCE(s) to
  21 the existing DIRECTORY, while setting permission modes and owner/group.
  22 In the 4th form, create all components of the given DIRECTORY(ies).
  23 .PP
  24 Mandatory arguments to long options are mandatory for short options too.
  25 .TP
  26 \fB\-\-backup\fR[=\fICONTROL\fR]
  27 make a backup of each existing destination file
  28 .TP
  29 \fB\-b\fR
  30 like \fB\-\-backup\fR but does not accept an argument
  31 .TP
  32 \fB\-c\fR
  33 (ignored)
  34 .TP
  35 \fB\-d\fR, \fB\-\-directory\fR
  36 treat all arguments as directory names; create all
  37 components of the specified directories
  38 .TP
  39 \fB\-D\fR
  40 create all leading components of DEST except the last,
  41 then copy SOURCE to DEST
  42 .TP
  43 \fB\-g\fR, \fB\-\-group\fR=\fIGROUP\fR
  44 set group ownership, instead of process' current group
  45 .TP
  46 \fB\-m\fR, \fB\-\-mode\fR=\fIMODE\fR
  47 set permission mode (as in chmod), instead of rwxr\-xr\-x
  48 .TP
  49 \fB\-o\fR, \fB\-\-owner\fR=\fIOWNER\fR
  50 set ownership (super\-user only)
  51 .TP
  52 \fB\-p\fR, \fB\-\-preserve\-timestamps\fR
  53 apply access/modification times of SOURCE files
  54 to corresponding destination files
  55 .TP
  56 \fB\-s\fR, \fB\-\-strip\fR
  57 strip symbol tables
  58 .TP
  59 \fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
  60 override the usual backup suffix
  61 .TP
  62 \fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
  63 copy all SOURCE arguments into DIRECTORY
  64 .TP
  65 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
  66 treat DEST as a normal file
  67 .TP
  68 \fB\-v\fR, \fB\-\-verbose\fR
  69 print the name of each directory as it is created
  70 .TP
  71 \fB\-\-help\fR
  72 display this help and exit
  73 .TP
  74 \fB\-\-version\fR
  75 output version information and exit
  76 .PP
  77 The backup suffix is `~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
  78 The version control method may be selected via the \fB\-\-backup\fR option or through
  79 the VERSION_CONTROL environment variable.  Here are the values:
  80 .TP
  81 none, off
  82 never make backups (even if \fB\-\-backup\fR is given)
  83 .TP
  84 numbered, t
  85 make numbered backups
  86 .TP
  87 existing, nil
  88 numbered if numbered backups exist, simple otherwise
  89 .TP
  90 simple, never
  91 always make simple backups
  92 .SH AUTHOR
  93 Written by David MacKenzie.
  94 .SH "REPORTING BUGS"
  95 Report bugs to <bug\-coreutils@gnu.org>.
  96 .SH COPYRIGHT
  97 Copyright \(co 2007 Free Software Foundation, Inc.
  98 .br
  99 This is free software.  You may redistribute copies of it under the terms of
 100 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
 101 There is NO WARRANTY, to the extent permitted by law.
 102 .SH "SEE ALSO"
 103 The full documentation for
 104 .B install
 105 is maintained as a Texinfo manual.  If the
 106 .B info
 107 and
 108 .B install
 109 programs are properly installed at your site, the command
 110 .IP
 111 .B info install
 112 .PP
 113 should give you access to the complete manual.