.\" Copyright 1996-1997 Devin Reade . .\" .\" $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 . .SH "SEE ALSO" .BR cp (1) .BR chmod (2).