merge-new-configs

Description

The merge-new-configs utility, usually located at /usr/bin/merge-new-configs, is a helper application used by the update-buildspace application to merge new default configuration files without overwriting those used by the build-space utilities or those critical to the correct operation of the build-space.

Configuration

The merge-new-configs utility uses the same configuration file as all the other applications in the buildspace-scripts package which is usually located at /etc/buildspace on a standard installation. The sections relevant to the merge-new-configs utility are highlighted in the example below.

/etc/buildspace
# Name of the build space
BUILDSPACE_NAME="x86-64bit-workstation"

# Base path for logs
LOGPATH="/var/log/autobuild"

# List of configuration files to protect from updates.
CONFFILES="aliases bashrc buildspace clock hosts layman.cfg locale.gen make.conf resolv.conf ssmtp.conf"

# List of kernel sources which should not be automatically cleaned.
KERNELS="sys-kernel/gentoo-sources"

As you can see the configuration is a simple space-separated list of file names stored in the CONFFILES variable. The names of the configuration files to protect should not contain any directories and all locations under /etc will be scanned for files matching those listed.

Use

The merge-new-configs has a single mode of operation and requires no command line parameters as long as a suitable CONFFILES setting is provided in the configuration file. Alternatively the list of files may be specified using the -f or --files option followed by a quoted, space separated list of filenames.

build merge-new-configs
Searching for new configurations for: 
    aliases : none. 
    bashrc : none. 
    buildspace : none. 
    clock : none. 
    hosts : none. 
    layman.cfg : none. 
    locale.gen : none. 
    make.conf : none. 
    resolv.conf : none. 
    ssmtp.conf : none. 
 
Scanning Configuration files... 
Exiting: Nothing left to do; exiting. :)