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