install(1B) SunOS/BSD Compatibility Package Commands install(1B)NAME
install - install files
SYNOPSIS
/usr/ucb/install [-cs] [-g group] [-m mode] [-o owner] filename1 filename2
/usr/ucb/install [-cs] [-g group] [-m mode] [-o owner] filename... directory
/usr/ucb/install -d [-g group] [-m mode] [-o owner] directory
DESCRIPTION
install is used within makefiles to copy new versions of files into a destination directory and to create the destination directory itself.
The first two forms are similar to the cp(1) command with the addition that executable files can be stripped during the copy and the owner,
group, and mode of the installed file(s) can be given.
The third form can be used to create a destination directory with the required owner, group and permissions.
Note: install uses no special privileges to copy files from one place to another. The implications of this are:
o You must have permission to read the files to be installed.
o You must have permission to copy into the destination file or directory.
o You must have permission to change the modes on the final copy of the file if you want to use the -m option to change modes.
o You must be superuser if you want to specify the ownership of the installed file with -o. If you are not the super-user, or if -o is
not in effect, the installed file will be owned by you, regardless of who owns the original.
OPTIONS -c Copy files. In fact install always copies files, but the -c option is retained for backwards compatibility with old shell
scripts that might otherwise break.
-d Create a directory. Missing parent directories are created as required as in mkdir -p. If the directory already exists, the
owner, group and mode will be set to the values given on the command line.
-s Strip executable files as they are copied.
-g group Set the group ownership of the installed file or directory. (staff by default.)
-m mode Set the mode for the installed file or directory. (0755 by default.)
-o owner If run as root, set the ownership of the installed file to the user-ID of owner.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Availability |SUNWscpu |
+-----------------------------+-----------------------------+
SEE ALSO chgrp(1), chmod(1), chown(1), cp(1), mkdir(1), strip(1), install(1M), attributes(5)SunOS 5.10 14 Sep 1992 install(1B)
Check Out this Related Man Page
INSTALL(1) General Commands Manual INSTALL(1)NAME
install - install files
SYNOPSIS
install [-lcszN] [-o owner] [-g group] [-m mode] [-S stack] [file1] file2
install [-lcszN] [-o owner] [-g group] [-m mode] [-S stack] file ... dir
install -d [-o owner] [-g group] [-m mode] directory
DESCRIPTION
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 cp(1) copying either one file to another or copying several files to a directory. The "-d" form is like mkdir(1)
with the -p flag. File1 may be omitted if neither -l nor -c is given to change the attributes of file2.
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.
OPTIONS -l 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.
-c Copy the source file to its proper place. This option is the default if -l is not given. With -l, the file is copied if the link
fails.
-s Strip the destination file of its symbol table, if it is an executable, and if it is actually copied. It has no effect on a link or
a non-executable.
-z Compress the executable using compress(1) and prepend a header line that calls 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 -s the file must be actually copied for the flag
to have effect.
-N Use gzip -N to compress the binary. You may see up to 60% space savings, but it will take much longer. N is a digit from 1 to 9
telling the compression effort, see gzip(1).
-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.
-o owner
Set the owner of the target. This only works if the invoker is the super-user, or if install is run setuid root and the invoker is
a member of group zero. If -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.
-g group
Like -o, but for the group ownership of the target.
-m mode
Mode is an octal number that specifies the mode the target should get. The default is the source file's mode with a chmod a+rX
applied to it, or 755 for a new directory. Implies -o 0, or -g 0 if a file is to be set-uid or set-gid and the invoker has permis-
sion to change ownership. This trick allows a group 0 member to install third party software, even though it expects to be
installed by root.
-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 hexa-
decimal number, optionally followed by the multipliers m, k, w, and b for mega (1024*1024), kilo (1024), "word" (2 or 4), and byte
(1). Uppercase M is also accepted for those who know what S.I. means. The compilers use -S 32kw by default, that translates to
64kb for an 8086, and 128kb for other architectures. This option is ignored on a non-executable.
SEE ALSO ln(1), cp(1), strip(1), compress(1), gzip(1), zexec(1), chown(8), chgrp(8), chmod(1), chmem(1), mkdir(1).
BUGS
Uppercase K, W, and B are also accepted for those who don't know what S.I. means.
AUTHOR
Kees J. Bot (kjb@cs.vu.nl)
INSTALL(1)