updmerge(8)updmerge(8)NAMEupdmerge - DO NOT USE THE updmerge UTILITY!
SYNOPSIS
/usr/bin/updmerge [-r] directory
/usr/bin/updmerge directory
/usr/bin/updmerge file directory
OPTIONS
Performs a recursive reinstallation of all the files and subdirectories
in the /var/adm/install/update area relative to the specified direc‐
tory.
OPERANDS
Specifies the directory from which the reinstallation is relative, typ‐
ically the root (/) directory. Specifies the name of a file in the
update area, or specifies the relative pathname of that file from the
update area.
DESCRIPTION
Caution
DO NOT USE THE updmerge UTILITY!
The updmerge utility lets you merge files that have been preserved from
a previous installation into a new installation environment. Any user
file or customized file from a previous installation that you do not
want replaced or overwritten can be saved and reintegrated into a new
installation environment.
You must have superuser privileges to invoke the updmerge utility, and
the system must be in single-user mode. The updmerge utility must be
invoked from the /var/adm/install/update directory, which is created by
the updmv utility and contains entries for the files that have been
preserved from the previous installation. Use the -r option followed
by the directory operand to perform a recursive installation of all
preserved subdirectories under the /var/adm/install/update area rela‐
tive to a specific directory. Use the directory operand only to
install only those preserved files directly under the
/var/adm/install/update directory. This causes a non-recursive merge of
the files in the specified directory. If you use the directory operand
only, subdirectories in /var/adm/install/update are not merged into the
new installation environment. Use the file operand followed by the
directory operand to install a single preserved file. This file can be
the name of the file in the /var/adm/install/update directory, or it
can contain the relative pathname of that file from the
/var/adm/install/update directory.
If the file operand is a directory name instead of a file name,
the updmerge utility reinstalls all files in that directory, but
none in its subdirectories.
To integrate files from the previous installation into the new instal‐
lation environment, the updmerge utility compares each preserved file
to the newly installed files with the following rules: If the preserved
file does not exist on the system, you can view the preserved file
before determining whether or not to install it. If the preserved file
does exist on the system, you can view the differences between the pre‐
served file and the newly installed file before selecting the file you
want installed on the system. If a preserved file is identical to a
newly installed file, a message is issued and the next file is checked.
EXAMPLES
Recursively install all preserved subdirectories and files under
/var/adm/install/update relative to the root (/) directory: updmerge-r
/
Install the preserved /etc/hosts file relative to the root (/) direc‐
tory: updmerge etc/hosts /
Install the preserved files in the etc directory relative to the root
(/) directory (in this case, /etc): updmerge etc /
RESTRICTIONS
Caution
DO NOT USE THE updmerge UTILITY!
You must have superuser privileges to invoke the updmerge utility.
The system must be in single-user mode before you invoke the updmerge
utility.
The updmerge utility must be invoked from the /var/adm/install/update
directory.
FILES
Storage area created by the updmv utility.
SEE ALSOgenufi(8), invsync(8), updmv(8), udetect(8), usync(8)stl_inv(4)updmerge(8)
