INSTALL

Section: User Commands (1)
Index Return to Main Contents

BSD mandoc
BSD 4.2  

NAME

install - install binaries  

SYNOPSIS

[-cps ] [-f flags ] [-m mode ] [-o owner ] [-g group ] [-l linkflags ] [-S stripflag ] file1 file2
[-cps ] [-f flags ] [-m mode ] [-o owner ] [-g group ] [-l linkflags ] [-S stripflag ] file1 ... fileN directory
-pd [-m mode ] [-o owner ] [-g group ] directory ...  

DESCRIPTION

The file(s) are moved (copied if the -c option is specified, or linked if the -l option is specified) to the target file or directory. If the destination is a directory, then the file is moved into directory with its original filename. If the target file already exists, it is overwritten if permissions allow.

-c
Copy the file. This flag turns off the default behavior of where it deletes the original file after creating the target.
-f
Specify the target's file flags. (See chflags(1) for a list of possible flags and their meanings.)
-g
Specify a group.
-m
Specify an alternative mode. The default mode is set to rwxr-xr-x (0755). The specified mode may be either an octal or symbolic value; see chmod(1) for a description of possible mode values.
-l linkflags
Instead of copying the file make a link to the source. The type of the link is determined by the linkflags argument. Valid linkflags are: a (absolute), r (relative), h (hard), s (symbolic), m (mixed). Absolute and relative have effect only for symbolic links. Mixed links are hard links for files on the same filesystem, symbolic otherwise.
-o
Specify an owner.
-p
Preserve the source files access and modification times.
-s
exec's the command strip(1) to strip binaries so that install can be portable over a large number of systems and binary types. If the environment variable STRIP is set, it is used as the strip(1) program.
-S stripflags
passes stripflags as option arguments to strip(1). When -S is used, strip(1) is invoked via the sh(1) shell, allowing a single -S argument be to specified to which the shell can then tokenize. Normally, invokes strip(1) directly. This flag implies -s.
-d
Create directories. Missing parent directories are created as required.

By default, preserves all file flags, with the exception of the ``nodump'' flag.

The utility attempts to prevent moving a file onto itself.

Installing /dev/null creates an empty file.

Upon successful completion a value of 0 is returned. Otherwise, a value of 1 is returned.  

SEE ALSO

chflags(1), chgrp(1), chmod(1), cp(1), mv(1), strip(1), chown(8)  

HISTORY

The utility appeared in BSD 4.2


 

Index

NAME
SYNOPSIS
DESCRIPTION
SEE ALSO
HISTORY

This document was created by man2html, using the manual pages.
Time: 04:30:12 GMT, April 24, 2025