History log of /freebsd-current/usr.bin/xinstall/install.1
Revision Date Author Comments
# a0439a1b 16-Apr-2024 Dag-Erling Smørgrav <des@FreeBSD.org>

install: Remove the mmap(2) option.

We already removed it from cp(1) over a year ago but never followed up
here. Do so now, for the same reasons: significant complexity for
little to no benefit.

MFC after: 1 week
Sponsored by: Klara, Inc.
Reviewed by: markj
Differential Revision: https://reviews.freebsd.org/D44809


# e5035d08 12-Apr-2024 Dag-Erling Smørgrav <des@FreeBSD.org>

install: Always use a temporary file.

Previously, we would only use a temporary file if explicitly asked to
with the `-S` option, and even then, only if the target file already
existed. This meant that an outside observer looking for the target
file might see a partial file, and might see the file disappear and
then reappear.

With this patch, we always use a temporary file, ensuring atomicity.
The downside is slightly increased disk usage. The upside is never
having to worry about, for instance, cron jobs randomly failing if
they happen to run simultaneously with `make installworld`.

The `-S` option is retained, partly for compatibility, and partly
to control the use of `fsync(2)`, which has a non-negligible cost
(approximately 10% increase in wall time for `make installworld`).

MFC after: 1 week
Sponsored by: Klara, Inc.
Reviewed by: 0mp, brooks, imp, markj
Differential Revision: https://reviews.freebsd.org/D44742


# bdcbfde3 23-Nov-2023 Warner Losh <imp@FreeBSD.org>

usr.bin: Remove ancient SCCS tags.

Remove ancient SCCS tags from the tree, automated scripting, with two
minor fixup to keep things compiling. All the common forms in the tree
were removed with a perl script.

Sponsored by: Netflix


# b2c76c41 16-Aug-2023 Warner Losh <imp@FreeBSD.org>

Remove $FreeBSD$: one-line nroff pattern

Remove /^\.\\"\s*\$FreeBSD\$$\n/


# f44e2577 03-Aug-2022 Dag-Erling Smørgrav <des@FreeBSD.org>

xinstall: alphabetize: upper case precedes lower.

Sponsored by: Klara, Inc.


# 0fd54da0 15-Jul-2020 Alex Richardson <arichardson@FreeBSD.org>

Allow install(1)'s create_tempfile() to work on Linux hosts

GLibc expects six 'X' characters in the mkstemp template argument and
will return EINVAL otherwise.

Reviewed By: emaste, imp, mjg
Differential Revision: https://reviews.freebsd.org/D25662


# 9236a881 12-Aug-2019 Mateusz Piotrowski <0mp@FreeBSD.org>

install.1: Add missing arguments to option descriptions

While here:
- Remove deprecated Tn macros.
- Do not use macros with the -width option.

Reviewed by: bcr
Approved by: doc (bcr)
Differential Revision: https://reviews.freebsd.org/D21173


# 209e744f 25-Sep-2015 Ed Maste <emaste@FreeBSD.org>

xinstall: renumber UCB clauses to avoid skipping #3


# 78229472 05-Jun-2013 Brooks Davis <brooks@FreeBSD.org>

New install flags were merged to 9-STABLE and will appear in FreeBSD-9.2.

Sponsored by: DARPA, AFRL
Submitted by: ru
MFC after: 3 days


# bf8596f6 22-Jan-2013 Brooks Davis <brooks@FreeBSD.org>

Remove documentation of the old -M option.

Sponsored by: DARPA, AFRL


# bf77e2db 19-Jan-2013 Joel Dahl <joel@FreeBSD.org>

Remove EOL whitespace.


# f2b19f9e 18-Jan-2013 Brooks Davis <brooks@FreeBSD.org>

Introduce six new options from NetBSD:
* -M <metalog> Log metadata in mtree format.
* -D <destdir> Log paths relative to <destdir>.
* -h <hash> Log digest of type <hash>.
* -T <tags> Specify which mtree tags to log.
* -l <linkflag> Create hard or symbolic links (allows logging).
* -U Install without root privileges (owner, group, mode,
and flags can be logged via -M

NOTE: In the interest of compatibility with NetBSD and because it is the
obvious letter, the nearly useless -M option (disable mmap) has been
repurposed.

Sponsored by: DARPA, AFRL
Obtained from: NetBSD
Reviewed by: bz


# a6a1856e 11-Jan-2013 Brooks Davis <brooks@FreeBSD.org>

Implement the -N <dbdir> option which allows an alternate passwd and
group file to be used. This is useful for installing on systems where
a user or group does not currently exist.

Sponsored by: DARPA, AFRL
Obtained from: NetBSD
MFC after: 5 days


# da52b4ca 11-Dec-2010 Joel Dahl <joel@FreeBSD.org>

Remove the advertising clause from UCB copyrighted files in usr.bin. This
is in accordance with the information provided at
ftp://ftp.cs.berkeley.edu/pub/4bsd/README.Impt.License.Change

Also add $FreeBSD$ to a few files to keep svn happy.

Discussed with: imp, rwatson


# a7d5f7eb 19-Oct-2010 Jamie Gritton <jamie@FreeBSD.org>

A new jail(8) with a configuration file, to replace the work currently done
by /etc/rc.d/jail.


# fe0506d7 09-Mar-2010 Marcel Moolenaar <marcel@FreeBSD.org>

Create the altix project branch. The altix project will add support
for the SGI Altix 350 to FreeBSD/ia64. The hardware used for porting
is a two-module system, consisting of a base compute module and a
CPU expansion module. SGI's NUMAFlex architecture can be an excellent
platform to test CPU affinity and NUMA-aware features in FreeBSD.


# d7f03759 19-Oct-2008 Ulf Lilleengen <lulf@FreeBSD.org>

- Import the HEAD csup code which is the basis for the cvsmode work.


# cb29445a 29-Sep-2006 Ruslan Ermilov <ru@FreeBSD.org>

Markup fixes.


# 858494e4 06-Mar-2006 David E. O'Brien <obrien@FreeBSD.org>

Add an override (DONTSTRIP) so that one can easily install debugable
binaries when one cannot easily edit a package's Makefiles and/or
configure scripts.


# 6fb9b618 30-Jul-2005 Giorgos Keramidas <keramida@FreeBSD.org>

Fix all the spelling mistakes I could find in the man pages for words
that have at least 3 characters.

MFC after: 1 week
Thanks to: Music band ``Chingon''
for keeping me company while searching for these.


# 0227791b 13-Feb-2005 Ruslan Ermilov <ru@FreeBSD.org>

Expand *n't contractions.


# 6c7216df 18-Jan-2005 Ruslan Ermilov <ru@FreeBSD.org>

Sort sections.


# a866e170 17-Jan-2005 Ruslan Ermilov <ru@FreeBSD.org>

Added the EXIT STATUS section where appropriate.


# 6a3e8b0a 02-Jul-2004 Ruslan Ermilov <ru@FreeBSD.org>

Mechanically kill hard sentence breaks.


# 74b010eb 11-Jun-2004 Marcel Moolenaar <marcel@FreeBSD.org>

Document the STRIPBIN environment variable. This includes adding a
forward reference from where strip(1) is being mention (-s option).

PR: bin/28620


# 8d5d039f 12-Dec-2002 Ruslan Ermilov <ru@FreeBSD.org>

Uniformly refer to a file system as "file system".

Approved by: re


# b9889f93 31-Oct-2002 Ruslan Ermilov <ru@FreeBSD.org>

Document the new behavior of -C with respect to inode-change-time.
Document that -p also preserves the access time of the source.


# 46c2a2cf 15-May-2002 Tom Rhodes <trhodes@FreeBSD.org>

More consistancy. file system > filesystem


# e8937ba0 19-Apr-2002 Philippe Charnier <charnier@FreeBSD.org>

Use `The .Nm utility'


# 47790a5b 22-Oct-2001 Dima Dorfman <dd@FreeBSD.org>

This program uses sysexits(3), so it does not exit 1 on failure.

PR: 31415


# 65c7e9c1 21-Aug-2001 Ruslan Ermilov <ru@FreeBSD.org>

Update -v documentation to match reality.

Spotted by: bde


# b4ad2d5f 30-May-2001 Ruslan Ermilov <ru@FreeBSD.org>

Note that the default behavior has changed to copy files.
Also, fix markup in the SYNOPSIS.

Submitted by: dougb


# f120c88c 28-May-2001 Ruslan Ermilov <ru@FreeBSD.org>

Many new features and optimization improvements:

o New flags: -b and -B (backup)
o New flag: -S (safe copy; aka "atomic" install)
o The -c flag is now the default.
o The -D flag was withdrawn.

Reviewed by: bde (up to some point)
Obtained from: OpenBSD but heavily modified
MFC after: 1 month


# 9b88faec 19-Dec-2000 Ruslan Ermilov <ru@FreeBSD.org>

Prepare for mdoc(7)NG.


# 8fe908ef 20-Nov-2000 Ruslan Ermilov <ru@FreeBSD.org>

mdoc(7) police: use the new features of the Nm macro.


# dbb9d8f8 26-Mar-2000 Philippe Charnier <charnier@FreeBSD.org>

Add DIAGNOSTICS section name


# 87faa07b 29-Feb-2000 Sheldon Hearn <sheldonh@FreeBSD.org>

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.


# 522f2bf8 05-Dec-1999 David E. O'Brien <obrien@FreeBSD.org>

Document the "-v" flag. [It was like that when I got here.. honestly.]


# c3aac50f 27-Aug-1999 Peter Wemm <peter@FreeBSD.org>

$Id$ -> $FreeBSD$


# 30035fd5 10-Jun-1998 Peter Wemm <peter@FreeBSD.org>

fchflags(8) -> fchflags(2)
Submitted by: Kenneth Merry <ken@plutotech.com>

Also, while here, mention that other FS's don't do flags.


# defff809 01-Jun-1998 Peter Wemm <peter@FreeBSD.org>

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>.


# ff896244 11-Jan-1998 Peter Wemm <peter@FreeBSD.org>

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.


# 7d85a3e8 27-Aug-1997 Philippe Charnier <charnier@FreeBSD.org>

Uncomment sccsid string and enclose it inside #if 0/#endif.
Cosmetic in man page.


# c115df18 22-Feb-1997 Peter Wemm <peter@FreeBSD.org>

Revert $FreeBSD$ to $Id$


# 1130b656 14-Jan-1997 Jordan K. Hubbard <jkh@FreeBSD.org>

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.


# a9c6b614 29-Sep-1996 Warner Losh <imp@FreeBSD.org>

Implement -d in install. Update the man page to reflect this change.


# bc2b0548 23-Sep-1996 Warner Losh <imp@FreeBSD.org>

Per discussions in -current
- Change the debug flag from -d to -D to avoid conflict with other
install programs.
- Update man page to reflect this
- Update usage string
-d meaning creat directory is specifically not implemented by these changes.


# b897ddaf 05-Apr-1996 Julian Elischer <julian@FreeBSD.org>

Submitted by: archie@tribe.com

allow the user to install using a Numeric GID or UID.
this brings it in to line with chgrp and chown, ans is required
by some people using FreeBSD in a product.


# ade9638b 10-Mar-1996 Mike Pritchard <mpp@FreeBSD.org>

Fix a couple of typos.

Submitted by: Philippe Charnier <charnier@limrr.fr>


# 4a8d0283 30-Jan-1996 Mike Pritchard <mpp@FreeBSD.org>

Fix a bunch of spelling errors in a bunch of man pages.


# de264c2b 09-Oct-1995 Bruce Evans <bde@FreeBSD.org>

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)


# 9b50d902 26-May-1994 Rodney W. Grimes <rgrimes@FreeBSD.org>

BSD 4.4 Lite Usr.bin Sources