| 1 | .TH INSTALL 1
|
|---|
| 2 | .SH NAME
|
|---|
| 3 | install \- install files
|
|---|
| 4 | .SH SYNOPSIS
|
|---|
| 5 | .in +5
|
|---|
| 6 | .ti -5
|
|---|
| 7 | .B install
|
|---|
| 8 | .RB [ \-lcsz\fIN\fP "] [" \-o
|
|---|
| 9 | .IR owner ]
|
|---|
| 10 | .RB [ \-g
|
|---|
| 11 | .IR group ]
|
|---|
| 12 | .RB [ \-m
|
|---|
| 13 | .IR mode ]
|
|---|
| 14 | .RB [ \-S
|
|---|
| 15 | .IR stack ]
|
|---|
| 16 | .RI [ file1 ]
|
|---|
| 17 | .I file2
|
|---|
| 18 | .br
|
|---|
| 19 | .ti -5
|
|---|
| 20 | .B install
|
|---|
| 21 | .RB [ \-lcsz\fIN\fP "] [" \-o
|
|---|
| 22 | .IR owner ]
|
|---|
| 23 | .RB [ \-g
|
|---|
| 24 | .IR group ]
|
|---|
| 25 | .RB [ \-m
|
|---|
| 26 | .IR mode ]
|
|---|
| 27 | .RB [ \-S
|
|---|
| 28 | .IR stack ]
|
|---|
| 29 | .IR file " ... " dir
|
|---|
| 30 | .br
|
|---|
| 31 | .ti -5
|
|---|
| 32 | .B install \-d
|
|---|
| 33 | .RB [ \-o
|
|---|
| 34 | .IR owner ]
|
|---|
| 35 | .RB [ \-g
|
|---|
| 36 | .IR group ]
|
|---|
| 37 | .RB [ \-m
|
|---|
| 38 | .IR mode ]
|
|---|
| 39 | .I directory
|
|---|
| 40 | .in -5
|
|---|
| 41 | .SH DESCRIPTION
|
|---|
| 42 | .de SP
|
|---|
| 43 | .if t .sp 0.4
|
|---|
| 44 | .if n .sp
|
|---|
| 45 | ..
|
|---|
| 46 | .B Install
|
|---|
| 47 | puts executables, manual pages, and library files in their proper place
|
|---|
| 48 | in the bin, man, and lib directories. The first two forms of the
|
|---|
| 49 | command are like
|
|---|
| 50 | .BR cp (1)
|
|---|
| 51 | copying either one file to another or copying several files to a
|
|---|
| 52 | directory. The "\fB\-d\fP" form is like
|
|---|
| 53 | .BR mkdir (1)
|
|---|
| 54 | with the
|
|---|
| 55 | .B \-p
|
|---|
| 56 | flag.
|
|---|
| 57 | .I File1
|
|---|
| 58 | may be omitted if neither
|
|---|
| 59 | .B \-l
|
|---|
| 60 | nor
|
|---|
| 61 | .B \-c
|
|---|
| 62 | is given to change the attributes of
|
|---|
| 63 | .IR file2 .
|
|---|
| 64 | .PP
|
|---|
| 65 | Attributes are always copied from the source file, use the options to change.
|
|---|
| 66 | Note that the source file's attributes are changed with the destination file
|
|---|
| 67 | if they are linked. So copy the file if you change it in a way that makes
|
|---|
| 68 | it read-only. You would otherwise not be able to compile a command again.
|
|---|
| 69 | .SH OPTIONS
|
|---|
| 70 | .TP
|
|---|
| 71 | .B \-l
|
|---|
| 72 | Link the destination to the source file instead of copying it. This is done
|
|---|
| 73 | to either save space on a file system with both the source and the bin
|
|---|
| 74 | directories on it, or to install synonyms to a command.
|
|---|
| 75 | .TP
|
|---|
| 76 | .B \-c
|
|---|
| 77 | Copy the source file to its proper place. This option is the default if
|
|---|
| 78 | .B \-l
|
|---|
| 79 | is not given. With
|
|---|
| 80 | .BR \-l ,
|
|---|
| 81 | the file is copied if the link fails.
|
|---|
| 82 | .TP
|
|---|
| 83 | .B \-s
|
|---|
| 84 | Strip the destination file of its symbol table,
|
|---|
| 85 | .I if
|
|---|
| 86 | it is an executable, and
|
|---|
| 87 | .I if
|
|---|
| 88 | it is actually copied. It has no effect on a link or a non-executable.
|
|---|
| 89 | .TP
|
|---|
| 90 | .B \-z
|
|---|
| 91 | Compress the executable using
|
|---|
| 92 | .BR compress (1)
|
|---|
| 93 | and prepend a header line that calls
|
|---|
| 94 | .BR zexec (1)
|
|---|
| 95 | to decompress and execute the binary. This will on average save 40% disk
|
|---|
| 96 | space at the expense of a slower startup time. Like
|
|---|
| 97 | .B \-s
|
|---|
| 98 | the file must be actually copied for the flag to have effect.
|
|---|
| 99 | .TP
|
|---|
| 100 | .BI \- N
|
|---|
| 101 | Use
|
|---|
| 102 | .BI "gzip \-" N
|
|---|
| 103 | to compress the binary. You may see up to 60% space savings, but it will
|
|---|
| 104 | take much longer.
|
|---|
| 105 | .I N
|
|---|
| 106 | is a digit from 1 to 9 telling the compression effort, see
|
|---|
| 107 | .BR gzip (1).
|
|---|
| 108 | .TP
|
|---|
| 109 | .B \-d
|
|---|
| 110 | Make a directory, usually to install files in a separate directory in a
|
|---|
| 111 | library. Intermediate directories in the path are created with the same
|
|---|
| 112 | attributes as the final directory. Only the attributes of the final
|
|---|
| 113 | directory are set if the directory exists.
|
|---|
| 114 | .TP
|
|---|
| 115 | .BI \-o " owner"
|
|---|
| 116 | Set the owner of the target. This only works if the invoker is the
|
|---|
| 117 | super-user, or if
|
|---|
| 118 | .B install
|
|---|
| 119 | is run setuid root and the invoker is a member of group zero. If
|
|---|
| 120 | .B \-o
|
|---|
| 121 | is omitted then the ownership is copied from the source file, or set to
|
|---|
| 122 | the id of the invoker if a directory is made.
|
|---|
| 123 | .TP
|
|---|
| 124 | .BI \-g " group"
|
|---|
| 125 | Like
|
|---|
| 126 | .BR \-o ,
|
|---|
| 127 | but for the group ownership of the target.
|
|---|
| 128 | .TP
|
|---|
| 129 | .BI \-m " mode"
|
|---|
| 130 | .I Mode
|
|---|
| 131 | is an octal number that specifies the mode the target should get. The
|
|---|
| 132 | default is the source file's mode with a
|
|---|
| 133 | .B chmod a+rX
|
|---|
| 134 | applied to it, or 755 for a new directory. Implies
|
|---|
| 135 | .BR "\-o 0" ,
|
|---|
| 136 | or
|
|---|
| 137 | .BR "\-g 0"
|
|---|
| 138 | if a file is to be set-uid or set-gid and the invoker has permission to
|
|---|
| 139 | change ownership. This trick allows a group 0 member to install third party
|
|---|
| 140 | software, even though it expects to be installed by root.
|
|---|
| 141 | .TP
|
|---|
| 142 | .BI \-S " stack"
|
|---|
| 143 | Sets the maximum amount of heap + stack that an executable may have when
|
|---|
| 144 | running. The argument is a C-style decimal, octal or hexadecimal
|
|---|
| 145 | number, optionally followed by the multipliers
|
|---|
| 146 | .BR m ,
|
|---|
| 147 | .BR k ,
|
|---|
| 148 | .BR w ,
|
|---|
| 149 | and
|
|---|
| 150 | .B b
|
|---|
| 151 | for mega (1024*1024), kilo (1024), "word" (2 or 4), and byte (1). Uppercase
|
|---|
| 152 | .B M
|
|---|
| 153 | is also accepted for those who know what S.I. means. The compilers use
|
|---|
| 154 | .B \-S 32kw
|
|---|
| 155 | by default, that translates to 64kb for an 8086, and 128kb for other
|
|---|
| 156 | architectures. This option is ignored on a non-executable.
|
|---|
| 157 | .SH "SEE ALSO"
|
|---|
| 158 | .BR ln (1),
|
|---|
| 159 | .BR cp (1),
|
|---|
| 160 | .BR strip (1),
|
|---|
| 161 | .BR compress (1),
|
|---|
| 162 | .BR gzip (1),
|
|---|
| 163 | .BR zexec (1),
|
|---|
| 164 | .BR chown (8),
|
|---|
| 165 | .BR chgrp (1),
|
|---|
| 166 | .BR chmod (1),
|
|---|
| 167 | .BR chmem (1),
|
|---|
| 168 | .BR mkdir (1).
|
|---|
| 169 | .SH BUGS
|
|---|
| 170 | Uppercase
|
|---|
| 171 | .BR K ,
|
|---|
| 172 | .BR W ,
|
|---|
| 173 | and
|
|---|
| 174 | .B B
|
|---|
| 175 | are also accepted for those who don't know what S.I. means.
|
|---|
| 176 | .SH AUTHOR
|
|---|
| 177 | Kees J. Bot (kjb@cs.vu.nl)
|
|---|
