raw/man1/install.1

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