updmerge(8) System Manager's Manual updmerge(8)
NAME
updmerge - 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
directory.
OPERANDS
Specifies the directory from which the reinstallation is relative, typically 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 relative 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 installation 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
preserved 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 (/) directory: 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 ALSO
genufi(8), invsync(8), updmv(8), udetect(8), usync(8) stl_inv(4)
updmerge(8)