Index for Section 8

Alphabetical listing for U

updmerge(8)
NAME
  updmerge - Merge customized and user files with newly installed files

SYNOPSIS
  /usr/bin/updmerge [-r] directory
  /usr/bin/updmerge directory
  /usr/bin/updmerge file directory

FLAGS
  -r  Performs a recursive reinstallation of all the files and subdirectories
      in the /var/adm/install/update area relative to the specified
      directory.

PARAMETERS
  directory
      Specifies the directory from which the reinstallation is relative.
      This is typically the root (/) directory.

  file
      Specifies the name of a file in the update area, or specifies the
      relative pathname of that file from the update area.

DESCRIPTION
  The updmerge utility is a part of the Reinstallation Toolkit (RITKIT).
  This utility enables you to merge files that have been preserved from a
  previous installation into the new installation environment.	Thus, 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 this utility, the system must
  be in single-user mode, and this utility must be invoked from the
  /var/adm/install/update directory.  This directory is created by the updmv
  utility.  It contains the files that have been preserved from the previous
  installation.

  To integrate files from the previous installation into the new installation
  environment, the updmerge utility compares each preserved file to the newly
  installed files as follows:

    ·  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 printed to this effect and the next file is checked.

  The updmerge utility is invoked as follows:

    ·  To perform a recursive installation of all preserved subdirectories
       under the /var/adm/install/update area relative to a specific
       directory, specify the -r flag followed by the directory parameter.

    ·  To install only those preserved files directly under the
       /var/adm/install/update directory, specify only the directory
       parameter.  This causes a non-recursive merge of the files in the
       specified directory.  By using this parameter, subdirectories in
       /var/adm/install/update are not merged into the new installation
       environment.

    ·  To install only a single preserved file, use the file parameter
       followed by the directory parameter.  A 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 you specify a directory for the file parameter instead of the name
       of a file, the updmerge utility reinstalls all files in the directory,
       but not in the subdirectories.

EXAMPLES
   1.  In this example, the updmerge utility recursively installs all
       preserved subdirectories and files under /var/adm/install/update
       relative to the root (/) directory:
	    updmerge -r /

   2.  In this example, the updmerge utility installs the preserved
       /etc/hosts file relative to the root (/) directory:
	    updmerge etc/hosts /

   3.  In this example, the updmerge utility installs the preserved files in
       the etc directory relative to the root (/) directory (in this case,
       /etc):
	    updmerge etc /

FILES
  /var/adm/install/update/*
      Storage area created by the updmv utility that contains the files
      preserved by RITKIT.

RELATED INFORMATION
  Commands: genufi(8), invsync(8), updmv(8), udetect(8), usync(8)

  Files: stl_inv(4)