mirror of
https://github.com/GnoConsortium/gno.git
synced 2024-12-21 23:29:16 +00:00
108 lines
2.9 KiB
Groff
108 lines
2.9 KiB
Groff
.\" Copyright 1996 Devin Reade <gdr@myrias.com>
|
|
.\"
|
|
.\" $Id: inst.1,v 1.1 1996/03/31 23:38:32 gdr Exp $
|
|
.\"
|
|
.TH INSTALL 1 "Commands and Applications" "31 Mar 96" "Version 1.0"
|
|
.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. If the `execute bit' is enabled, then
|
|
the file type will be changed to SRC and the auxilliary type to EXEC.
|
|
This is equivalent to making the file an executable shell script.
|
|
If the `execute bit' is disabled, then the file type will be changed
|
|
to TXT and the auxilliary type to 0x0000.
|
|
.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
|
|
Show version number.
|
|
.SH AUTHOR
|
|
Devin Reade <gdr@eddore.myrias.com>
|