original/man1/install.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
   2 .TH INSTALL "1" "January 2016" "GNU coreutils 8.25" "User Commands"
   3 .SH NAME
   4 install \- copy files and set attributes
   5 .SH SYNOPSIS
   6 .B install
   7 [\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR
   8 .br
   9 .B install
  10 [\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR
  11 .br
  12 .B install
  13 [\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR...
  14 .br
  15 .B install
  16 [\fI\,OPTION\/\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[=\fI\,CONTROL\/\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 or all components of \fB\-\-target\-directory\fR,
  51 then copy SOURCE to DEST
  52 .TP
  53 \fB\-g\fR, \fB\-\-group\fR=\fI\,GROUP\/\fR
  54 set group ownership, instead of process' current group
  55 .TP
  56 \fB\-m\fR, \fB\-\-mode\fR=\fI\,MODE\/\fR
  57 set permission mode (as in chmod), instead of rwxr\-xr\-x
  58 .TP
  59 \fB\-o\fR, \fB\-\-owner\fR=\fI\,OWNER\/\fR
  60 set ownership (super\-user only)
  61 .TP
  62 \fB\-p\fR, \fB\-\-preserve\-timestamps\fR
  63 apply access/modification times of SOURCE files
  64 to corresponding destination files
  65 .TP
  66 \fB\-s\fR, \fB\-\-strip\fR
  67 strip symbol tables
  68 .TP
  69 \fB\-\-strip\-program\fR=\fI\,PROGRAM\/\fR
  70 program used to strip binaries
  71 .TP
  72 \fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR
  73 override the usual backup suffix
  74 .TP
  75 \fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR
  76 copy all SOURCE arguments into DIRECTORY
  77 .TP
  78 \fB\-T\fR, \fB\-\-no\-target\-directory\fR
  79 treat DEST as a normal file
  80 .TP
  81 \fB\-v\fR, \fB\-\-verbose\fR
  82 print the name of each directory as it is created
  83 .TP
  84 \fB\-\-preserve\-context\fR
  85 preserve SELinux security context
  86 .TP
  87 \fB\-Z\fR
  88 set SELinux security context of destination
  89 file to default type
  90 .TP
  91 \fB\-\-context\fR[=\fI\,CTX\/\fR]
  92 like \fB\-Z\fR, or if CTX is specified then set the
  93 SELinux or SMACK security context to CTX
  94 .TP
  95 \fB\-\-help\fR
  96 display this help and exit
  97 .TP
  98 \fB\-\-version\fR
  99 output version information and exit
 100 .PP
 101 The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX.
 102 The version control method may be selected via the \fB\-\-backup\fR option or through
 103 the VERSION_CONTROL environment variable.  Here are the values:
 104 .TP
 105 none, off
 106 never make backups (even if \fB\-\-backup\fR is given)
 107 .TP
 108 numbered, t
 109 make numbered backups
 110 .TP
 111 existing, nil
 112 numbered if numbered backups exist, simple otherwise
 113 .TP
 114 simple, never
 115 always make simple backups
 116 .SH AUTHOR
 117 Written by David MacKenzie.
 118 .SH "REPORTING BUGS"
 119 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
 120 .br
 121 Report install translation bugs to <http://translationproject.org/team/>
 122 .SH COPYRIGHT
 123 Copyright \(co 2016 Free Software Foundation, Inc.
 124 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 125 .br
 126 This is free software: you are free to change and redistribute it.
 127 There is NO WARRANTY, to the extent permitted by law.
 128 .SH "SEE ALSO"
 129 Full documentation at: <http://www.gnu.org/software/coreutils/install>
 130 .br
 131 or available locally via: info \(aq(coreutils) install invocation\(aq