mirror of https://github.com/GnoConsortium/gno.git
126 lines
3.3 KiB
Groff
126 lines
3.3 KiB
Groff
.\" Copyright 1996-1997 Devin Reade <gdr@trenco.gno.org>.
|
|
.\"
|
|
.\" $Id: inst.1,v 1.4 1999/01/16 19:30:56 gdr-ftp Exp $
|
|
.\"
|
|
.TH INSTALL 1 "16 January 1999" GNO "Commands and Applications"
|
|
.SH NAME
|
|
install \- copy files and set their attributes
|
|
.SH SYNOPSIS
|
|
.BR install
|
|
[
|
|
.I options
|
|
] [
|
|
.BR -s
|
|
]
|
|
.I source
|
|
.I dest
|
|
.br
|
|
.BR install
|
|
[
|
|
.I options
|
|
] [
|
|
.BR -s
|
|
]
|
|
.I source
|
|
[ ... ]
|
|
.I directory
|
|
.br
|
|
.BR install
|
|
[
|
|
.I options
|
|
]
|
|
[
|
|
.BR -d
|
|
]
|
|
.I directory
|
|
[ ... ]
|
|
.SH DESCRIPTION
|
|
.BR install
|
|
copies files and sets their permission modes and, if possible, their
|
|
owner and group. It is used similarily to
|
|
.BR cp (1);
|
|
typically used in Makefiles to copy programs into their destination
|
|
directories. It can also be used to create the destination directories
|
|
and any leading directories, and to set the directories modes.
|
|
.LP
|
|
Some of the options listed below are not implemented or are implemented
|
|
in a restricted sense. Such options are recognised to maximize
|
|
.BR install 's
|
|
compatibility with other UNIX versions, in order to minimize problems
|
|
with ported shell scripts and makefiles. Where options are not fully
|
|
implemented, it is usually due to differences between UNIX and GS/OS.
|
|
.SH OPTIONS
|
|
.IP \fB-c\fR
|
|
Ignored. This option is included for backwards compatibility
|
|
with old UNIX versions of
|
|
.BR install .
|
|
.IP \fB-d\fR
|
|
Create each given directory and its leading directories, if they
|
|
do not already exist.
|
|
.IP "\fB-g\fR \fIgroup\fR"
|
|
Set the group ownership of the installed file or directory to the group
|
|
ID of
|
|
.I group
|
|
(default is the processes' current group).
|
|
.I group
|
|
may also be a numeric group ID.
|
|
.sp
|
|
\fBThis is currently ignored under GNO.\fR
|
|
.IP \fB-h\fR
|
|
Show usage information and exit.
|
|
.IP "\fB-m\fR \fImode\fR"
|
|
Set the permission mode for the installed file or directory to
|
|
.IR mode ,
|
|
which can be either an octal number, or a symbolic mode as in the
|
|
UNIX chmod command,
|
|
with 0 as the point of departure. The default mode is 0755.
|
|
.sp
|
|
Note that currently under GNO, the
|
|
.I mode
|
|
is interpreted in the traditional UNIX sense in that it only affects
|
|
read, write, and (to a limited extent) execute permissions.
|
|
Furthermore, the only bits interpreted are those for the
|
|
user permissions; the
|
|
.I mode
|
|
is effectively bitwise `anded' with the constant 0700.
|
|
.sp
|
|
An execute modification is only permitted when the original file
|
|
is of type TXT or SRC, in which case the file becomes a shell script
|
|
(type SRC, auxtype 0x0006). See also
|
|
.BR chmod (2).
|
|
.IP "\fB-o\fR \fIowner\fR"
|
|
If run as root, set the ownership of the installed file to the user ID of
|
|
.IR owner .
|
|
.I owner
|
|
may also be numeric user ID.
|
|
.sp
|
|
\fBThis is currently ignored under GNO.\fR
|
|
.IP \fB-s\fR
|
|
Strip the symbol tables from the installed programs.
|
|
.sp
|
|
\fBThis is currently ignored under GNO.\fR
|
|
.IP \fB-V\fR
|
|
Verbose output;
|
|
.BR install
|
|
will print out the name of each file or directory as it is created.
|
|
.IP \fB-v\fR
|
|
Show version number.
|
|
.SH BUGS
|
|
When installing multiple files into a directory and the
|
|
.BR -V
|
|
flag is given, the respective file names are printed
|
|
.I after
|
|
the file has been copied, rather than before. This was done since the
|
|
final file name is known only after the copying subroutine has returned.
|
|
While the name could be determined prior to the copy, this extra work
|
|
was left out for efficiency reasons.
|
|
.SH VERSION
|
|
This manual page documents
|
|
.BR install
|
|
version 1.3.
|
|
.SH AUTHOR
|
|
Devin Reade <gdr@trenco.gno.org>.
|
|
.SH "SEE ALSO"
|
|
.BR cp (1)
|
|
.BR chmod (2).
|