NAME    [Toc]    [Back]

       updmerge - DO NOT USE THE updmerge UTILITY!

SYNOPSIS    [Toc]    [Back]

       /usr/bin/updmerge [-r] directory

       /usr/bin/updmerge directory

       /usr/bin/updmerge file directory

OPTIONS    [Toc]    [Back]

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

OPERANDS    [Toc]    [Back]

       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    [Toc]    [Back]

                                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  nonrecursive
  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    [Toc]    [Back]

       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    [Toc]    [Back]

                                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    [Toc]    [Back]

       Storage area created by the updmv utility.

SEE ALSO    [Toc]    [Back]

       genufi(8),   invsync(8),  updmv(8),  udetect(8),  usync(8)
       stl_inv(4)



                                                      updmerge(8)