d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
933f6f8689
freebsd-dev/usr.bin/xinstall/install.1

203 lines
5.2 KiB
Groff
Raw Normal View History

BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.\" Copyright (c) 1987, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
.\" This product includes software developed by the University of
.\" California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\" may be used to endorse or promote products derived from this software
.\" without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
.\" From: @(#)install.1 8.1 (Berkeley) 6/6/93
$Id$ -> $FreeBSD$
1999-08-28 01:08:13 +00:00
.\" $FreeBSD$
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.\"
Implement -d in install. Update the man page to reflect this change.
1996-09-29 06:29:54 +00:00
.Dd September 22, 1996
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Dt INSTALL 1
.Os BSD 4.2
.Sh NAME
.Nm install
.Nd install binaries
.Sh SYNOPSIS
.Nm install
Document the "-v" flag. [It was like that when I got here.. honestly.]
1999-12-06 05:01:14 +00:00
.Op Fl CcDMpsv
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Op Fl f Ar flags
.Op Fl g Ar group
.Op Fl m Ar mode
.Op Fl o Ar owner
.Ar file1 file2
.Nm install
Document the "-v" flag. [It was like that when I got here.. honestly.]
1999-12-06 05:01:14 +00:00
.Op Fl CcDMpsv
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Op Fl f Ar flags
.Op Fl g Ar group
.Op Fl m Ar mode
.Op Fl o Ar owner
.Ar file1
\&...
.Ar fileN directory
Implement -d in install. Update the man page to reflect this change.
1996-09-29 06:29:54 +00:00
.Nm install
.Fl d
Document the "-v" flag. [It was like that when I got here.. honestly.]
1999-12-06 05:01:14 +00:00
.Op Fl v
Implement -d in install. Update the man page to reflect this change.
1996-09-29 06:29:54 +00:00
.Op Fl g Ar group
.Op Fl m Ar mode
.Op Fl o Ar owner
.Ar directory
\&...
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Sh DESCRIPTION
The file(s) are moved (or copied if the
.Fl c
option is specified) to the target file or directory.
If the destination is a directory, then the
.Ar file
is moved into
.Ar directory
with its original filename.
If the target file already exists, it is overwritten if permissions
allow.
.Pp
.Bl -tag -width Ds
Fix a couple of typos. Submitted by: Philippe Charnier <charnier@limrr.fr>
1996-03-11 03:31:51 +00:00
.It Fl C
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
Copy the file, as if the
.Fl c
Fix a bunch of spelling errors in a bunch of man pages.
1996-01-30 13:52:50 +00:00
option is specified,
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
except if the target file already exists and the files are the same,
Fix a couple of typos. Submitted by: Philippe Charnier <charnier@limrr.fr>
1996-03-11 03:31:51 +00:00
then don't change the modification time of the target.
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl c
Copy the file.
This flag turns off the default behavior of
.Nm install
where it deletes the original file after creating the target.
Implement -d in install. Update the man page to reflect this change.
1996-09-29 06:29:54 +00:00
.It Fl D
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
Print debugging information.
If
Implement -d in install. Update the man page to reflect this change.
1996-09-29 06:29:54 +00:00
.Fl D
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
is specified one or more times,
then print the renaming steps for
.Fl C .
If
Implement -d in install. Update the man page to reflect this change.
1996-09-29 06:29:54 +00:00
.Fl D
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
is specified two or more times,
then warn about files that aren't installed with
.Fl C .
Implement -d in install. Update the man page to reflect this change.
1996-09-29 06:29:54 +00:00
.It Fl d
Create directories.
Missing parent directories are created as required.
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl f
Uncomment sccsid string and enclose it inside #if 0/#endif. Cosmetic in man page.
1997-08-27 06:29:23 +00:00
Specify the target's file flags; see
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Xr chflags 1
Uncomment sccsid string and enclose it inside #if 0/#endif. Cosmetic in man page.
1997-08-27 06:29:23 +00:00
for a list of possible flags and their meanings.
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl g
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-01 12:20:22 +00:00
Specify a group.
A numeric GID is allowed.
Add an option (-M) to install to disable use of mmap(2). This is kinda handy at the moment with -current's mmap+unlink interactions.. The problems seem worst when using INSTALL="install -C" in /etc/make.conf. This could well come in handy in the future too.
1998-01-11 11:43:36 +00:00
.It Fl M
Disable all use of
.Xr mmap 2 .
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl m
Specify an alternate mode.
The default mode is set to rwxr-xr-x (0755).
The specified mode may be either an octal or symbolic value; see
.Xr chmod 1
for a description of possible mode values.
.It Fl o
Remove single-space hard sentence breaks. These degrade the quality of the typeset output, tend to make diffs harder to read and provide bad examples for new-comers to mdoc.
2000-03-01 12:20:22 +00:00
Specify an owner.
A numeric UID is allowed.
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
.It Fl p
Preserve the modification time.
Copy the file, as if the
.Fl C
Fix a bunch of spelling errors in a bunch of man pages.
1996-01-30 13:52:50 +00:00
(Compare and copy) option is specified,
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
except if the target file doesn't already exist or is different,
then preserve the modification time of the file.
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.It Fl s
.Nm Install
exec's the command
.Xr strip 1
to strip binaries so that install can be portable over a large
number of systems and binary types.
Document the "-v" flag. [It was like that when I got here.. honestly.]
1999-12-06 05:01:14 +00:00
.It Fl v
Causes
.Nm
to show when
.Fl C
acutally installs something.
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.El
.Pp
By default,
Uncomment sccsid string and enclose it inside #if 0/#endif. Cosmetic in man page.
1997-08-27 06:29:23 +00:00
.Nm
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
preserves all file flags, with the exception of the ``nodump'' flag.
.Pp
The
Uncomment sccsid string and enclose it inside #if 0/#endif. Cosmetic in man page.
1997-08-27 06:29:23 +00:00
.Nm
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
utility attempts to prevent moving a file onto itself.
.Pp
Installing
.Pa /dev/null
creates an empty file.
Add DIAGNOSTICS section name
2000-03-26 15:06:46 +00:00
.Sh DIAGNOSTICS
The
.Nm
utility exits 0 on success, and 1 otherwise.
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
.Sh FILES
.Bl -tag -width INS@XXXX -compact
.It Pa INS@XXXX
If the
.Fl C
or
.Fl p
option is used, then temporary files named INS@XXXX,
where XXXX is decided by
.Xr mkstemp 3 ,
are created in the target directory.
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Sh SEE ALSO
.Xr chflags 1 ,
.Xr chgrp 1 ,
.Xr chmod 1 ,
.Xr cp 1 ,
.Xr mv 1 ,
.Xr strip 1 ,
Add an option (-M) to install to disable use of mmap(2). This is kinda handy at the moment with -current's mmap+unlink interactions.. The problems seem worst when using INSTALL="install -C" in /etc/make.conf. This could well come in handy in the future too.
1998-01-11 11:43:36 +00:00
.Xr mmap 2 ,
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
.Xr chown 8
.Sh HISTORY
The
Uncomment sccsid string and enclose it inside #if 0/#endif. Cosmetic in man page.
1997-08-27 06:29:23 +00:00
.Nm
BSD 4.4 Lite Usr.bin Sources
1994-05-27 12:33:43 +00:00
utility appeared in
.Bx 4.2 .
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
.Sh BUGS
Temporary files may be left in the target directory if
Uncomment sccsid string and enclose it inside #if 0/#endif. Cosmetic in man page.
1997-08-27 06:29:23 +00:00
.Nm
Add options -C (same as -c except for preserving the modification time of the target if the target file is the same as the source), -d (debug), and -p (same as -C except for preserving the modification time of the source if the target doesn't exists or is different from the source. Use library err() functions instead of our own and pass them better exit codes. Submitted by: wollman (and changed a lot by me)
1995-10-09 07:21:00 +00:00
exits abnormally.
Treat an EOPNOTSUPP from fchflags() as a non-fatal case. Only warn about it if flags were explicitly specified on the command line. Do not warn if we were merely trying to preserve flags or remove UF_NODUMP. NFS does not support flags. I'm not sure that this is ideal, but it should do for now. Installing a plain file onto a NFS server must work, we used to silently ignore the attempt. Doing a binary install looses the flags anyway since cpio doens't preserve them with the cdrom/network images. XXX make world should not use flags or chown/chgrp in the obj/tmp area. This is based on a suggestion from Ken Merry <ken@plutotech.com>.
1998-06-02 12:00:08 +00:00
.Pp
File flags cannot be set by
fchflags(8) -> fchflags(2) Submitted by: Kenneth Merry <ken@plutotech.com> Also, while here, mention that other FS's don't do flags.
1998-06-10 07:17:59 +00:00
.Xr fchflags 2
over a NFS file system. Other file systems do not have a concept of flags.
Treat an EOPNOTSUPP from fchflags() as a non-fatal case. Only warn about it if flags were explicitly specified on the command line. Do not warn if we were merely trying to preserve flags or remove UF_NODUMP. NFS does not support flags. I'm not sure that this is ideal, but it should do for now. Installing a plain file onto a NFS server must work, we used to silently ignore the attempt. Doing a binary install looses the flags anyway since cpio doens't preserve them with the cdrom/network images. XXX make world should not use flags or chown/chgrp in the obj/tmp area. This is based on a suggestion from Ken Merry <ken@plutotech.com>.
1998-06-02 12:00:08 +00:00
.Nm
will only warn when flags could not be set on a file system
that does not support them.
Document the "-v" flag. [It was like that when I got here.. honestly.]
1999-12-06 05:01:14 +00:00
.Pp
.Nm
with
.Fl v
falsely says a file is copied when
.Fl C
snaps hard links.
Reference in New Issue Copy Permalink