198 lines
4.5 KiB
Groff
198 lines
4.5 KiB
Groff
.TH INSTALL 1
|
|
.SH NAME
|
|
install \- install files
|
|
.SH SYNOPSIS
|
|
.in +5
|
|
.ti -5
|
|
.B install
|
|
.RB [ \-cpsz\fIN\fP "] [" \-l
|
|
.IR linktype ]
|
|
.RB [ \-o
|
|
.IR owner ]
|
|
.RB [ \-g
|
|
.IR group ]
|
|
.RB [ \-m
|
|
.IR mode ]
|
|
.RB [ \-S
|
|
.IR stack ]
|
|
.RI [ file1 ]
|
|
.I file2
|
|
.br
|
|
.ti -5
|
|
.B install
|
|
.RB [ \-cpsz\fIN\fP "] [" \-l
|
|
.IR linktype ]
|
|
.RB [ \-o
|
|
.IR owner ]
|
|
.RB [ \-g
|
|
.IR group ]
|
|
.RB [ \-m
|
|
.IR mode ]
|
|
.RB [ \-S
|
|
.IR stack ]
|
|
.IR file " ... " dir
|
|
.br
|
|
.ti -5
|
|
.B install
|
|
.RB [ \-c ]
|
|
.B \-d
|
|
.RB [ \-o
|
|
.IR owner ]
|
|
.RB [ \-g
|
|
.IR group ]
|
|
.RB [ \-m
|
|
.IR mode ]
|
|
.I directory
|
|
.in -5
|
|
.SH DESCRIPTION
|
|
.de SP
|
|
.if t .sp 0.4
|
|
.if n .sp
|
|
..
|
|
.B Install
|
|
puts executables, manual pages, and library files in their proper place
|
|
in the bin, man, and lib directories. The first two forms of the
|
|
command are like
|
|
.BR cp (1)
|
|
copying either one file to another or copying several files to a
|
|
directory. The "\fB\-d\fP" form is like
|
|
.BR mkdir (1)
|
|
with the
|
|
.B \-p
|
|
flag.
|
|
.I File1
|
|
may be omitted if neither
|
|
.B \-l
|
|
nor
|
|
.B \-c
|
|
is given to change the attributes of
|
|
.IR file2 .
|
|
.PP
|
|
Attributes are always copied from the source file, use the options to change.
|
|
Note that the source file's attributes are changed with the destination file
|
|
if they are linked. So copy the file if you change it in a way that makes
|
|
it read-only. You would otherwise not be able to compile a command again.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI \-l " linktype"
|
|
Link the destination to the source file instead of copying it. This is done
|
|
to either save space on a file system with both the source and the bin
|
|
directories on it, or to install synonyms to a command. The
|
|
.I linktype
|
|
argument can either be
|
|
.I h
|
|
(hard)
|
|
or
|
|
.I s
|
|
(symbolic).
|
|
.TP
|
|
.B \-c
|
|
Copy the source file to its proper place. This option is the default if
|
|
.B \-l
|
|
is not given. With
|
|
.BR \-l ,
|
|
the file is copied if the link fails. This option is also allowed with
|
|
.BR \-d .
|
|
In this case the
|
|
.BR \-c
|
|
is ignored.
|
|
.TP
|
|
.B \-p
|
|
Preserve timestamp on source file or directory.
|
|
.TP
|
|
.B \-s
|
|
Strip the destination file of its symbol table,
|
|
.I if
|
|
it is an executable, and
|
|
.I if
|
|
it is actually copied. It has no effect on a link or a non-executable.
|
|
.TP
|
|
.B \-z
|
|
Compress the executable using
|
|
.BR compress (1)
|
|
and prepend a header line that calls
|
|
.BR zexec (1)
|
|
to decompress and execute the binary. This will on average save 40% disk
|
|
space at the expense of a slower startup time. Like
|
|
.B \-s
|
|
the file must be actually copied for the flag to have effect.
|
|
.TP
|
|
.BI \- N
|
|
Use
|
|
.BI "gzip \-" N
|
|
to compress the binary. You may see up to 60% space savings, but it will
|
|
take much longer.
|
|
.I N
|
|
is a digit from 1 to 9 telling the compression effort, see
|
|
.BR gzip (1).
|
|
.TP
|
|
.B \-d
|
|
Make a directory, usually to install files in a separate directory in a
|
|
library. Intermediate directories in the path are created with the same
|
|
attributes as the final directory. Only the attributes of the final
|
|
directory are set if the directory exists.
|
|
.TP
|
|
.BI \-o " owner"
|
|
Set the owner of the target. This only works if the invoker is the
|
|
super-user, or if
|
|
.B install
|
|
is run setuid root and the invoker is a member of group zero. If
|
|
.B \-o
|
|
is omitted then the ownership is copied from the source file, or set to
|
|
the id of the invoker if a directory is made.
|
|
.TP
|
|
.BI \-g " group"
|
|
Like
|
|
.BR \-o ,
|
|
but for the group ownership of the target.
|
|
.TP
|
|
.BI \-m " mode"
|
|
.I Mode
|
|
is an octal number that specifies the mode the target should get. The
|
|
default is the source file's mode with a
|
|
.B chmod a+rX
|
|
applied to it, or 755 for a new directory. Implies
|
|
.BR "\-o 0" ,
|
|
or
|
|
.BR "\-g 0"
|
|
if a file is to be set-uid or set-gid and the invoker has permission to
|
|
change ownership. This trick allows a group 0 member to install third party
|
|
software, even though it expects to be installed by root.
|
|
.TP
|
|
.BI \-S " stack"
|
|
Sets the maximum amount of heap + stack that an executable may have when
|
|
running. The argument is a C-style decimal, octal or hexadecimal
|
|
number, optionally followed by the multipliers
|
|
.BR m ,
|
|
.BR k ,
|
|
.BR w ,
|
|
and
|
|
.B b
|
|
for mega (1024*1024), kilo (1024), "word" (2 or 4), and byte (1). Uppercase
|
|
.B M
|
|
is also accepted for those who know what S.I. means. The compilers use
|
|
.B \-S 32kw
|
|
by default, that translates to 64kb for an 8086, and 128kb for other
|
|
architectures. This option is ignored on a non-executable.
|
|
.SH "SEE ALSO"
|
|
.BR ln (1),
|
|
.BR cp (1),
|
|
.BR strip (1),
|
|
.BR compress (1),
|
|
.BR gzip (1),
|
|
.BR zexec (1),
|
|
.BR chown (8),
|
|
.BR chgrp (1),
|
|
.BR chmod (1),
|
|
.BR chmem (1),
|
|
.BR mkdir (1).
|
|
.SH BUGS
|
|
Uppercase
|
|
.BR K ,
|
|
.BR W ,
|
|
and
|
|
.B B
|
|
are also accepted for those who don't know what S.I. means.
|
|
.SH AUTHOR
|
|
Kees J. Bot (kjb@cs.vu.nl)
|