original/man1/install.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH INSTALL "1" "March 2012" "GNU coreutils 8.16" "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 This install program copies files (often just compiled) into destination
  21 locations you choose.  If you want to download and install a ready\-to\-use
  22 package on a GNU/Linux system, you should instead be using a package manager
  23 like yum(1) or apt\-get(1).
  24 .PP
  25 In the first three forms, copy SOURCE to DEST or multiple SOURCE(s) to
  26 the existing DIRECTORY, while setting permission modes and owner/group.
  27 In the 4th form, create all components of the given DIRECTORY(ies).
  28 .PP
  29 Mandatory arguments to long options are mandatory for short options too.
  30 .TP
  31 \fB\-\-backup\fR[=\fICONTROL\fR]
  32 make a backup of each existing destination file
  33 .TP
  34 \fB\-b\fR
  35 like \fB\-\-backup\fR but does not accept an argument
  36 .TP
  37 \fB\-c\fR
  38 (ignored)
  39 .TP
  40 \fB\-C\fR, \fB\-\-compare\fR
  41 compare each pair of source and destination files, and
  42 in some cases, do not modify the destination at all
  43 .TP
  44 \fB\-d\fR, \fB\-\-directory\fR
  45 treat all arguments as directory names; create all
  46 components of the specified directories
  47 .TP
  48 \fB\-D\fR
  49 create all leading components of DEST except the last,
  50 then copy SOURCE to DEST
  51 .TP
  52 \fB\-g\fR, \fB\-\-group\fR=\fIGROUP\fR
  53 set group ownership, instead of process' current group
  54 .TP
  55 \fB\-m\fR, \fB\-\-mode\fR=\fIMODE\fR
  56 set permission mode (as in chmod), instead of rwxr\-xr\-x
  57 .TP
  58 \fB\-o\fR, \fB\-\-owner\fR=\fIOWNER\fR
  59 set ownership (super\-user only)
  60 .TP
  61 \fB\-p\fR, \fB\-\-preserve\-timestamps\fR
  62 apply access/modification times of SOURCE files
  63 to corresponding destination files
  64 .TP
  65 \fB\-s\fR, \fB\-\-strip\fR
  66 strip symbol tables
  67 .TP
  68 \fB\-\-strip\-program\fR=\fIPROGRAM\fR
  69 program used to strip binaries
  70 .TP
  71 \fB\-S\fR, \fB\-\-suffix\fR=\fISUFFIX\fR
  72 override the usual backup suffix
  73 .TP
  74 \fB\-t\fR, \fB\-\-target\-directory\fR=\fIDIRECTORY\fR
  75 copy all SOURCE arguments into DIRECTORY
  76 .TP
  77 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
  78 treat DEST as a normal file
  79 .TP
  80 \fB\-v\fR, \fB\-\-verbose\fR
  81 print the name of each directory as it is created
  82 .TP
  83 \fB\-\-preserve\-context\fR
  84 preserve SELinux security context
  85 .TP
  86 \fB\-Z\fR, \fB\-\-context\fR=\fICONTEXT\fR
  87 set SELinux security context of files and directories
  88 .TP
  89 \fB\-\-help\fR
  90 display this help and exit
  91 .TP
  92 \fB\-\-version\fR
  93 output version information and exit
  94 .PP
  95 The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
  96 The version control method may be selected via the \fB\-\-backup\fR option or through
  97 the VERSION_CONTROL environment variable.  Here are the values:
  98 .TP
  99 none, off
 100 never make backups (even if \fB\-\-backup\fR is given)
 101 .TP
 102 numbered, t
 103 make numbered backups
 104 .TP
 105 existing, nil
 106 numbered if numbered backups exist, simple otherwise
 107 .TP
 108 simple, never
 109 always make simple backups
 110 .SH AUTHOR
 111 Written by David MacKenzie.
 112 .SH "REPORTING BUGS"
 113 Report install bugs to bug\-coreutils@gnu.org
 114 .br
 115 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
 116 .br
 117 General help using GNU software: <http://www.gnu.org/gethelp/>
 118 .br
 119 Report install translation bugs to <http://translationproject.org/team/>
 120 .SH COPYRIGHT
 121 Copyright \(co 2012 Free Software Foundation, Inc.
 122 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 123 .br
 124 This is free software: you are free to change and redistribute it.
 125 There is NO WARRANTY, to the extent permitted by law.
 126 .SH "SEE ALSO"
 127 The full documentation for
 128 .B install
 129 is maintained as a Texinfo manual.  If the
 130 .B info
 131 and
 132 .B install
 133 programs are properly installed at your site, the command
 134 .IP
 135 .B info coreutils \(aqinstall invocation\(aq
 136 .PP
 137 should give you access to the complete manual.