ZConfig.cc

Go to the documentation of this file.

/*---------------------------------------------------------------------\
|                          ____ _   __ __ ___                          |
|                         |__  / \ / / . \ . \                         |
|                           / / \ V /|  _/  _/                         |
|                          / /__ | | | | | |                           |
|                         /_____||_| |_| |_|                           |
|                                                                      |
\---------------------------------------------------------------------*/
extern "C"
{
#include <features.h>
#include <sys/utsname.h>
#if __GLIBC_PREREQ (2,16)
#include <sys/auxv.h>   // getauxval for PPC64P7 detection
#endif
#include <unistd.h>
#include <solv/solvversion.h>
}
#include <iostream>
#include <fstream>
#include "zypp/base/LogTools.h"
#include "zypp/base/IOStream.h"
#include "zypp/base/InputStream.h"
#include "zypp/base/String.h"
#include "zypp/base/Regex.h"
 
#include "zypp/ZConfig.h"
#include "zypp/ZYppFactory.h"
#include "zypp/PathInfo.h"
#include "zypp/parser/IniDict.h"
 
#include "zypp/sat/Pool.h"
#include "zypp/sat/detail/PoolImpl.h"
 
using namespace std;
using namespace zypp::filesystem;
using namespace zypp::parser;
 
#undef ZYPP_BASE_LOGGER_LOGGROUP
#define ZYPP_BASE_LOGGER_LOGGROUP "zconfig"
 
namespace zypp
{ 
 
  namespace
  { 
 
    Arch _autodetectSystemArchitecture()
    {
      struct ::utsname buf;
      if ( ::uname( &buf ) < 0 )
      {
        ERR << "Can't determine system architecture" << endl;
        return Arch_noarch;
      }
 
      Arch architecture( buf.machine );
      MIL << "Uname architecture is '" << buf.machine << "'" << endl;
 
      if ( architecture == Arch_i686 )
      {
        // some CPUs report i686 but dont implement cx8 and cmov
        // check for both flags in /proc/cpuinfo and downgrade
        // to i586 if either is missing (cf bug #18885)
        std::ifstream cpuinfo( "/proc/cpuinfo" );
        if ( cpuinfo )
        {
          for( iostr::EachLine in( cpuinfo ); in; in.next() )
          {
            if ( str::hasPrefix( *in, "flags" ) )
            {
              if (    in->find( "cx8" ) == std::string::npos
                   || in->find( "cmov" ) == std::string::npos )
              {
                architecture = Arch_i586;
                WAR << "CPU lacks 'cx8' or 'cmov': architecture downgraded to '" << architecture << "'" << endl;
              }
              break;
            }
          }
        }
        else
        {
          ERR << "Cant open " << PathInfo("/proc/cpuinfo") << endl;
        }
      }
      else if ( architecture == Arch_sparc || architecture == Arch_sparc64 )
      {
        // Check for sun4[vum] to get the real arch. (bug #566291)
        std::ifstream cpuinfo( "/proc/cpuinfo" );
        if ( cpuinfo )
        {
          for( iostr::EachLine in( cpuinfo ); in; in.next() )
          {
            if ( str::hasPrefix( *in, "type" ) )
            {
              if ( in->find( "sun4v" ) != std::string::npos )
              {
                architecture = ( architecture == Arch_sparc64 ? Arch_sparc64v : Arch_sparcv9v );
                WAR << "CPU has 'sun4v': architecture upgraded to '" << architecture << "'" << endl;
              }
              else if ( in->find( "sun4u" ) != std::string::npos )
              {
                architecture = ( architecture == Arch_sparc64 ? Arch_sparc64 : Arch_sparcv9 );
                WAR << "CPU has 'sun4u': architecture upgraded to '" << architecture << "'" << endl;
              }
              else if ( in->find( "sun4m" ) != std::string::npos )
              {
                architecture = Arch_sparcv8;
                WAR << "CPU has 'sun4m': architecture upgraded to '" << architecture << "'" << endl;
              }
              break;
            }
          }
        }
        else
        {
          ERR << "Cant open " << PathInfo("/proc/cpuinfo") << endl;
        }
      }
      else if ( architecture == Arch_armv7l || architecture == Arch_armv6l )
      {
        std::ifstream platform( "/etc/rpm/platform" );
        if (platform)
        {
          for( iostr::EachLine in( platform ); in; in.next() )
          {
            if ( str::hasPrefix( *in, "armv7hl-" ) )
            {
              architecture = Arch_armv7hl;
              WAR << "/etc/rpm/platform contains armv7hl-: architecture upgraded to '" << architecture << "'" << endl;
              break;
            }
            if ( str::hasPrefix( *in, "armv6hl-" ) )
            {
              architecture = Arch_armv6hl;
              WAR << "/etc/rpm/platform contains armv6hl-: architecture upgraded to '" << architecture << "'" << endl;
              break;
            }
          }
        }
      }
#if __GLIBC_PREREQ (2,16)
      else if ( architecture == Arch_ppc64 )
      {
        const char * platform = (const char *)getauxval( AT_PLATFORM );
        int powerlvl;
        if ( platform && sscanf( platform, "power%d", &powerlvl ) == 1 && powerlvl > 6 )
          architecture = Arch_ppc64p7;
      }
#endif
      return architecture;
    }
 
    Locale _autodetectTextLocale()
    {
      Locale ret( Locale::enCode );
      const char * envlist[] = { "LC_ALL", "LC_MESSAGES", "LANG", NULL };
      for ( const char ** envvar = envlist; *envvar; ++envvar )
      {
        const char * envlang = getenv( *envvar );
        if ( envlang )
        {
          std::string envstr( envlang );
          if ( envstr != "POSIX" && envstr != "C" )
          {
            Locale lang( envstr );
            if ( lang )
            {
              MIL << "Found " << *envvar << "=" << envstr << endl;
              ret = lang;
              break;
            }
          }
        }
      }
      MIL << "Default text locale is '" << ret << "'" << endl;
#warning HACK AROUND BOOST_TEST_CATCH_SYSTEM_ERRORS
      setenv( "BOOST_TEST_CATCH_SYSTEM_ERRORS", "no", 1 );
      return ret;
    }
 
 
    inline Pathname _autodetectSystemRoot()
    {
      Target_Ptr target( getZYpp()->getTarget() );
      return target ? target->root() : Pathname();
    }
 
    inline Pathname _autodetectZyppConfPath()
    {
      const char *env_confpath = getenv( "ZYPP_CONF" );
      return env_confpath ? env_confpath : "/etc/zypp/zypp.conf";
    }
 
  } // namespace zypp
 
  template<class Tp>
      struct Option
      {
        typedef Tp value_type;
 
        Option( const value_type & initial_r )
          : _val( initial_r )
        {}
 
        const value_type & get() const
        { return _val; }
 
        operator const value_type &() const
        { return _val; }
 
        void set( const value_type & newval_r )
        { _val = newval_r; }
 
        value_type & ref()
        { return _val; }
 
        private:
          value_type _val;
      };
 
  template<class Tp>
      struct DefaultOption : public Option<Tp>
      {
        typedef Tp         value_type;
        typedef Option<Tp> option_type;
 
        DefaultOption( const value_type & initial_r )
          : Option<Tp>( initial_r ), _default( initial_r )
        {}
 
        void restoreToDefault()
        { this->set( _default.get() ); }
 
        void restoreToDefault( const value_type & newval_r )
        { setDefault( newval_r ); restoreToDefault(); }
 
        const value_type & getDefault() const
        { return _default.get(); }
 
        void setDefault( const value_type & newval_r )
        { _default.set( newval_r ); }
 
        private:
          option_type _default;
      };
 
  //
  //    CLASS NAME : ZConfig::Impl
  //
  class ZConfig::Impl
  {
    typedef std::set<std::string> MultiversionSpec;
 
    public:
      Impl( const Pathname & override_r = Pathname() )
        : _parsedZyppConf               ( override_r )
        , cfg_arch                      ( defaultSystemArchitecture() )
        , cfg_textLocale                ( defaultTextLocale() )
        , updateMessagesNotify          ( "" )
        , repo_add_probe                ( false )
        , repo_refresh_delay            ( 10 )
        , repoLabelIsAlias              ( false )
        , download_use_deltarpm         ( true )
        , download_use_deltarpm_always  ( false )
        , download_media_prefer_download( true )
        , download_mediaMountdir        ( "/var/adm/mount" )
        , download_max_concurrent_connections( 5 )
        , download_min_download_speed   ( 0 )
        , download_max_download_speed   ( 0 )
        , download_max_silent_tries     ( 5 )
        , download_transfer_timeout     ( 180 )
        , commit_downloadMode           ( DownloadDefault )
        , gpgCheck                      ( true )
        , repoGpgCheck                  ( indeterminate )
        , pkgGpgCheck                   ( indeterminate )
        , solver_focus                  ( ResolverFocus::Default )
        , solver_onlyRequires           ( false )
        , solver_allowVendorChange      ( false )
        , solver_dupAllowDowngrade      ( true )
        , solver_dupAllowNameChange     ( true )
        , solver_dupAllowArchChange     ( true )
        , solver_dupAllowVendorChange   ( true )
        , solver_cleandepsOnRemove      ( false )
        , solver_upgradeTestcasesToKeep ( 2 )
        , solverUpgradeRemoveDroppedPackages( true )
        , apply_locks_file              ( true )
        , pluginsPath                   ( "/usr/lib/zypp/plugins" )
      {
        MIL << "libzypp: " LIBZYPP_VERSION_STRING << endl;
        // override_r has higest prio
        // ZYPP_CONF might override /etc/zypp/zypp.conf
        if ( _parsedZyppConf.empty() )
        {
          _parsedZyppConf = _autodetectZyppConfPath();
        }
        else
        {
          // Inject this into ZConfig. Be shure this is
          // allocated via new. See: reconfigureZConfig
          INT << "Reconfigure to " << _parsedZyppConf << endl;
          ZConfig::instance()._pimpl.reset( this );
        }
        if ( PathInfo(_parsedZyppConf).isExist() )
        {
          parser::IniDict dict( _parsedZyppConf );
          for ( IniDict::section_const_iterator sit = dict.sectionsBegin();
                sit != dict.sectionsEnd();
                ++sit )
          {
            string section(*sit);
            //MIL << section << endl;
            for ( IniDict::entry_const_iterator it = dict.entriesBegin(*sit);
                  it != dict.entriesEnd(*sit);
                  ++it )
            {
              string entry(it->first);
              string value(it->second);
              //DBG << (*it).first << "=" << (*it).second << endl;
              if ( section == "main" )
              {
                if ( entry == "arch" )
                {
                  Arch carch( value );
                  if ( carch != cfg_arch )
                  {
                    WAR << "Overriding system architecture (" << cfg_arch << "): " << carch << endl;
                    cfg_arch = carch;
                  }
                }
                else if ( entry == "cachedir" )
                {
                  cfg_cache_path = Pathname(value);
                }
                else if ( entry == "metadatadir" )
                {
                  cfg_metadata_path = Pathname(value);
                }
                else if ( entry == "solvfilesdir" )
                {
                  cfg_solvfiles_path = Pathname(value);
                }
                else if ( entry == "packagesdir" )
                {
                  cfg_packages_path = Pathname(value);
                }
                else if ( entry == "configdir" )
                {
                  cfg_config_path = Pathname(value);
                }
                else if ( entry == "reposdir" )
                {
                  cfg_known_repos_path = Pathname(value);
                }
                else if ( entry == "servicesdir" )
                {
                  cfg_known_services_path = Pathname(value);
                }
                else if ( entry == "varsdir" )
                {
                  cfg_vars_path = Pathname(value);
                }
                else if ( entry == "repo.add.probe" )
                {
                  repo_add_probe = str::strToBool( value, repo_add_probe );
                }
                else if ( entry == "repo.refresh.delay" )
                {
                  str::strtonum(value, repo_refresh_delay);
                }
                else if ( entry == "repo.refresh.locales" )
                {
                  std::vector<std::string> tmp;
                  str::split( value, back_inserter( tmp ), ", \t" );
 
                  boost::function<Locale(const std::string &)> transform(
                    [](const std::string & str_r)->Locale{ return Locale(str_r); }
                  );
                  repoRefreshLocales.insert( make_transform_iterator( tmp.begin(), transform ),
                                             make_transform_iterator( tmp.end(), transform ) );
                }
                else if ( entry == "download.use_deltarpm" )
                {
                  download_use_deltarpm = str::strToBool( value, download_use_deltarpm );
                }
                else if ( entry == "download.use_deltarpm.always" )
                {
                  download_use_deltarpm_always = str::strToBool( value, download_use_deltarpm_always );
                }
                else if ( entry == "download.media_preference" )
                {
                  download_media_prefer_download.restoreToDefault( str::compareCI( value, "volatile" ) != 0 );
                }
 
                else if ( entry == "download.media_mountdir" )
                {
                  download_mediaMountdir.restoreToDefault( Pathname(value) );
                }
 
                else if ( entry == "download.max_concurrent_connections" )
                {
                  str::strtonum(value, download_max_concurrent_connections);
                }
                else if ( entry == "download.min_download_speed" )
                {
                  str::strtonum(value, download_min_download_speed);
                }
                else if ( entry == "download.max_download_speed" )
                {
                  str::strtonum(value, download_max_download_speed);
                }
                else if ( entry == "download.max_silent_tries" )
                {
                  str::strtonum(value, download_max_silent_tries);
                }
                else if ( entry == "download.transfer_timeout" )
                {
                  str::strtonum(value, download_transfer_timeout);
                  if ( download_transfer_timeout < 0 )          download_transfer_timeout = 0;
                  else if ( download_transfer_timeout > 3600 )  download_transfer_timeout = 3600;
                }
                else if ( entry == "commit.downloadMode" )
                {
                  commit_downloadMode.set( deserializeDownloadMode( value ) );
                }
                else if ( entry == "gpgcheck" )
                {
                  gpgCheck.restoreToDefault( str::strToBool( value, gpgCheck ) );
                }
                else if ( entry == "repo_gpgcheck" )
                {
                  repoGpgCheck.restoreToDefault( str::strToTriBool( value ) );
                }
                else if ( entry == "pkg_gpgcheck" )
                {
                  pkgGpgCheck.restoreToDefault( str::strToTriBool( value ) );
                }
                else if ( entry == "vendordir" )
                {
                  cfg_vendor_path = Pathname(value);
                }
                else if ( entry == "multiversiondir" )
                {
                  cfg_multiversion_path = Pathname(value);
                }
                else if ( entry == "multiversion.kernels" )
                {
                  cfg_kernel_keep_spec = value;
                }
                else if ( entry == "solver.focus" )
                {
                  fromString( value, solver_focus );
                }
                else if ( entry == "solver.onlyRequires" )
                {
                  solver_onlyRequires.set( str::strToBool( value, solver_onlyRequires ) );
                }
                else if ( entry == "solver.allowVendorChange" )
                {
                  solver_allowVendorChange.set( str::strToBool( value, solver_allowVendorChange ) );
                }
                else if ( entry == "solver.dupAllowDowngrade" )
                {
                  solver_dupAllowDowngrade.set( str::strToBool( value, solver_dupAllowDowngrade ) );
                }
                else if ( entry == "solver.dupAllowNameChange" )
                {
                  solver_dupAllowNameChange.set( str::strToBool( value, solver_dupAllowNameChange ) );
                }
                else if ( entry == "solver.dupAllowArchChange" )
                {
                  solver_dupAllowArchChange.set( str::strToBool( value, solver_dupAllowArchChange ) );
                }
                else if ( entry == "solver.dupAllowVendorChange" )
                {
                  solver_dupAllowVendorChange.set( str::strToBool( value, solver_dupAllowVendorChange ) );
                }
                else if ( entry == "solver.cleandepsOnRemove" )
                {
                  solver_cleandepsOnRemove.set( str::strToBool( value, solver_cleandepsOnRemove ) );
                }
                else if ( entry == "solver.upgradeTestcasesToKeep" )
                {
                  solver_upgradeTestcasesToKeep.set( str::strtonum<unsigned>( value ) );
                }
                else if ( entry == "solver.upgradeRemoveDroppedPackages" )
                {
                  solverUpgradeRemoveDroppedPackages.restoreToDefault( str::strToBool( value, solverUpgradeRemoveDroppedPackages.getDefault() ) );
                }
                else if ( entry == "solver.checkSystemFile" )
                {
                  solver_checkSystemFile = Pathname(value);
                }
                else if ( entry == "solver.checkSystemFileDir" )
                {
                  solver_checkSystemFileDir = Pathname(value);
                }
                else if ( entry == "multiversion" )
                {
                  MultiversionSpec & defSpec( _multiversionMap.getDefaultSpec() );
                  str::splitEscaped( value, std::inserter( defSpec, defSpec.end() ), ", \t" );
                }
                else if ( entry == "locksfile.path" )
                {
                  locks_file = Pathname(value);
                }
                else if ( entry == "locksfile.apply" )
                {
                  apply_locks_file = str::strToBool( value, apply_locks_file );
                }
                else if ( entry == "update.datadir" )
                {
                  update_data_path = Pathname(value);
                }
                else if ( entry == "update.scriptsdir" )
                {
                  update_scripts_path = Pathname(value);
                }
                else if ( entry == "update.messagessdir" )
                {
                  update_messages_path = Pathname(value);
                }
                else if ( entry == "update.messages.notify" )
                {
                  updateMessagesNotify.set( value );
                }
                else if ( entry == "rpm.install.excludedocs" )
                {
                  rpmInstallFlags.setFlag( target::rpm::RPMINST_EXCLUDEDOCS,
                                           str::strToBool( value, false ) );
                }
                else if ( entry == "history.logfile" )
                {
                  history_log_path = Pathname(value);
                }
                else if ( entry == "credentials.global.dir" )
                {
                  credentials_global_dir_path = Pathname(value);
                }
                else if ( entry == "credentials.global.file" )
                {
                  credentials_global_file_path = Pathname(value);
                }
              }
            }
          }
          //
 
        }
        else
        {
          MIL << _parsedZyppConf << " not found, using defaults instead." << endl;
          _parsedZyppConf = _parsedZyppConf.extend( " (NOT FOUND)" );
        }
 
        // legacy:
        if ( getenv( "ZYPP_TESTSUITE_FAKE_ARCH" ) )
        {
          Arch carch( getenv( "ZYPP_TESTSUITE_FAKE_ARCH" ) );
          if ( carch != cfg_arch )
          {
            WAR << "ZYPP_TESTSUITE_FAKE_ARCH: Overriding system architecture (" << cfg_arch << "): " << carch << endl;
            cfg_arch = carch;
          }
        }
        MIL << "ZConfig singleton created." << endl;
      }
 
      ~Impl()
      {}
 
    public:
    Pathname _parsedZyppConf;
 
    Arch     cfg_arch;
    Locale   cfg_textLocale;
 
    Pathname cfg_cache_path;
    Pathname cfg_metadata_path;
    Pathname cfg_solvfiles_path;
    Pathname cfg_packages_path;
 
    Pathname cfg_config_path;
    Pathname cfg_known_repos_path;
    Pathname cfg_known_services_path;
    Pathname cfg_vars_path;
    Pathname cfg_repo_mgr_root_path;
 
    Pathname cfg_vendor_path;
    Pathname cfg_multiversion_path;
    std::string cfg_kernel_keep_spec;
    Pathname locks_file;
 
    Pathname update_data_path;
    Pathname update_scripts_path;
    Pathname update_messages_path;
    DefaultOption<std::string> updateMessagesNotify;
 
    bool        repo_add_probe;
    unsigned    repo_refresh_delay;
    LocaleSet   repoRefreshLocales;
    bool        repoLabelIsAlias;
 
    bool download_use_deltarpm;
    bool download_use_deltarpm_always;
    DefaultOption<bool> download_media_prefer_download;
    DefaultOption<Pathname> download_mediaMountdir;
 
    int download_max_concurrent_connections;
    int download_min_download_speed;
    int download_max_download_speed;
    int download_max_silent_tries;
    int download_transfer_timeout;
 
    Option<DownloadMode> commit_downloadMode;
 
    DefaultOption<bool>         gpgCheck;
    DefaultOption<TriBool>      repoGpgCheck;
    DefaultOption<TriBool>      pkgGpgCheck;
 
    ResolverFocus       solver_focus;
    Option<bool>        solver_onlyRequires;
    Option<bool>        solver_allowVendorChange;
    Option<bool>        solver_dupAllowDowngrade;
    Option<bool>        solver_dupAllowNameChange;
    Option<bool>        solver_dupAllowArchChange;
    Option<bool>        solver_dupAllowVendorChange;
    Option<bool>        solver_cleandepsOnRemove;
    Option<unsigned>    solver_upgradeTestcasesToKeep;
    DefaultOption<bool> solverUpgradeRemoveDroppedPackages;
 
    Pathname solver_checkSystemFile;
    Pathname solver_checkSystemFileDir;
 
    MultiversionSpec &          multiversion()          { return getMultiversion(); }
    const MultiversionSpec &    multiversion() const    { return getMultiversion(); }
 
    bool apply_locks_file;
 
    target::rpm::RpmInstFlags rpmInstallFlags;
 
    Pathname history_log_path;
    Pathname credentials_global_dir_path;
    Pathname credentials_global_file_path;
 
    std::string userData;
 
    Option<Pathname> pluginsPath;
 
  private:
    // HACK for bnc#906096: let pool re-evaluate multiversion spec
    // if target root changes. ZConfig returns data sensitive to
    // current target root.
    // TODO Actually we'd need to scan the target systems zypp.conf and
    // overlay all system specific values.
    struct MultiversionMap
    {
      typedef std::map<Pathname,MultiversionSpec> SpecMap;
 
      MultiversionSpec & getSpec( Pathname root_r, const Impl & zConfImpl_r )   // from system at root
      {
        // _specMap[]     - the plain zypp.conf value
        // _specMap[/]    - combine [] and multiversion.d scan
        // _specMap[root] - scan root/zypp.conf and root/multiversion.d
 
        if ( root_r.empty() )
          root_r = "/";
        bool cacheHit = _specMap.count( root_r );
        MultiversionSpec & ret( _specMap[root_r] );     // creates new entry on the fly
 
        if ( ! cacheHit )
        {
          if ( root_r == "/" )
            ret.swap( _specMap[Pathname()] );           // original zypp.conf
          else
            scanConfAt( root_r, ret, zConfImpl_r );     // scan zypp.conf at root_r
          scanDirAt( root_r, ret, zConfImpl_r );        // add multiversion.d at root_r
          using zypp::operator<<;
          MIL << "MultiversionSpec '" << root_r << "' = " << ret << endl;
        }
        return ret;
      }
 
      MultiversionSpec & getDefaultSpec()       // Spec from zypp.conf parsing; called before any getSpec
      { return _specMap[Pathname()]; }
 
    private:
      void scanConfAt( const Pathname root_r, MultiversionSpec & spec_r, const Impl & zConfImpl_r )
      {
        static const str::regex rx( "^multiversion *= *(.*)" );
        str::smatch what;
        iostr::simpleParseFile( InputStream( Pathname::assertprefix( root_r, _autodetectZyppConfPath() ) ),
                                [&]( int num_r, std::string line_r )->bool
                                {
                                  if ( line_r[0] == 'm' && str::regex_match( line_r, what, rx ) )
                                  {
                                    str::splitEscaped( what[1], std::inserter( spec_r, spec_r.end() ), ", \t" );
                                    return false;       // stop after match
                                  }
                                  return true;
                                } );
      }
 
      void scanDirAt( const Pathname root_r, MultiversionSpec & spec_r, const Impl & zConfImpl_r )
      {
        // NOTE:  Actually we'd need to scan and use the root_r! zypp.conf values.
        Pathname multiversionDir( zConfImpl_r.cfg_multiversion_path );
        if ( multiversionDir.empty() )
          multiversionDir = ( zConfImpl_r.cfg_config_path.empty()
                            ? Pathname("/etc/zypp")
                            : zConfImpl_r.cfg_config_path ) / "multiversion.d";
 
        filesystem::dirForEach( Pathname::assertprefix( root_r, multiversionDir ),
                                [&spec_r]( const Pathname & dir_r, const char *const & name_r )->bool
                                {
                                  MIL << "Parsing " << dir_r/name_r << endl;
                                  iostr::simpleParseFile( InputStream( dir_r/name_r ),
                                                          [&spec_r]( int num_r, std::string line_r )->bool
                                                          {
                                                            DBG << "  found " << line_r << endl;
                                                            spec_r.insert( std::move(line_r) );
                                                            return true;
                                                          } );
                                  return true;
                                } );
      }
 
    private:
      SpecMap _specMap;
    };
 
    MultiversionSpec & getMultiversion() const
    { return _multiversionMap.getSpec( _autodetectSystemRoot(), *this ); }
 
    mutable MultiversionMap _multiversionMap;
  };
 
  // Backdoor to redirect ZConfig from within the running
  // TEST-application. HANDLE WITH CARE!
  void reconfigureZConfig( const Pathname & override_r )
  {
    // ctor puts itself unter smart pointer control.
    new ZConfig::Impl( override_r );
  }
 
  //
  //    METHOD NAME : ZConfig::instance
  //    METHOD TYPE : ZConfig &
  //
  ZConfig & ZConfig::instance()
  {
    static ZConfig _instance; // The singleton
    return _instance;
  }
 
  //
  //    METHOD NAME : ZConfig::ZConfig
  //    METHOD TYPE : Ctor
  //
  ZConfig::ZConfig()
  : _pimpl( new Impl )
  {
    about( MIL );
  }
 
  //
  //    METHOD NAME : ZConfig::~ZConfig
  //    METHOD TYPE : Dtor
  //
  ZConfig::~ZConfig( )
  {}
 
  Pathname ZConfig::systemRoot() const
  { return _autodetectSystemRoot(); }
 
 
  Pathname ZConfig::repoManagerRoot() const
  {
    return ( _pimpl->cfg_repo_mgr_root_path.empty()
             ? systemRoot() : _pimpl->cfg_repo_mgr_root_path );
  }
 
  void ZConfig::setRepoManagerRoot(const zypp::filesystem::Pathname &root)
  { _pimpl->cfg_repo_mgr_root_path = root; }
 
  //
  // system architecture
  //
 
  Arch ZConfig::defaultSystemArchitecture()
  {
    static Arch _val( _autodetectSystemArchitecture() );
    return _val;
  }
 
  Arch ZConfig::systemArchitecture() const
  { return _pimpl->cfg_arch; }
 
  void ZConfig::setSystemArchitecture( const Arch & arch_r )
  {
    if ( arch_r != _pimpl->cfg_arch )
    {
      WAR << "Overriding system architecture (" << _pimpl->cfg_arch << "): " << arch_r << endl;
      _pimpl->cfg_arch = arch_r;
    }
  }
 
  //
  // text locale
  //
 
  Locale ZConfig::defaultTextLocale()
  {
    static Locale _val( _autodetectTextLocale() );
    return _val;
  }
 
  Locale ZConfig::textLocale() const
  { return _pimpl->cfg_textLocale; }
 
  void ZConfig::setTextLocale( const Locale & locale_r )
  {
    if ( locale_r != _pimpl->cfg_textLocale )
    {
      WAR << "Overriding text locale (" << _pimpl->cfg_textLocale << "): " << locale_r << endl;
      _pimpl->cfg_textLocale = locale_r;
#warning prefer signal
      sat::Pool::instance().setTextLocale( locale_r );
    }
  }
 
  // user data
 
  bool ZConfig::hasUserData() const
  { return !_pimpl->userData.empty(); }
 
  std::string ZConfig::userData() const
  { return _pimpl->userData; }
 
  bool ZConfig::setUserData( const std::string & str_r )
  {
    for_( ch, str_r.begin(), str_r.end() )
    {
      if ( *ch < ' ' && *ch != '\t' )
      {
        ERR << "New user data string rejectded: char " << (int)*ch << " at position " <<  (ch - str_r.begin()) << endl;
        return false;
      }
    }
    MIL << "Set user data string to '" << str_r << "'" << endl;
    _pimpl->userData = str_r;
    return true;
  }
 
 
  Pathname ZConfig::repoCachePath() const
  {
    return ( _pimpl->cfg_cache_path.empty()
             ? Pathname("/var/cache/zypp") : _pimpl->cfg_cache_path );
  }
 
  Pathname ZConfig::pubkeyCachePath() const
  {
    return ( _pimpl->cfg_cache_path.empty()
             ? Pathname("/var/cache/zypp/pubkeys") : _pimpl->cfg_cache_path/"pubkeys" );
  }
 
  void ZConfig::setRepoCachePath(const zypp::filesystem::Pathname &path_r)
  {
    _pimpl->cfg_cache_path = path_r;
  }
 
  Pathname ZConfig::repoMetadataPath() const
  {
    return ( _pimpl->cfg_metadata_path.empty()
        ? (repoCachePath()/"raw") : _pimpl->cfg_metadata_path );
  }
 
  void ZConfig::setRepoMetadataPath(const zypp::filesystem::Pathname &path_r)
  {
    _pimpl->cfg_metadata_path = path_r;
  }
 
  Pathname ZConfig::repoSolvfilesPath() const
  {
    return ( _pimpl->cfg_solvfiles_path.empty()
        ? (repoCachePath()/"solv") : _pimpl->cfg_solvfiles_path );
  }
 
  void ZConfig::setRepoSolvfilesPath(const zypp::filesystem::Pathname &path_r)
  {
    _pimpl->cfg_solvfiles_path = path_r;
  }
 
  Pathname ZConfig::repoPackagesPath() const
  {
    return ( _pimpl->cfg_packages_path.empty()
        ? (repoCachePath()/"packages") : _pimpl->cfg_packages_path );
  }
 
  void ZConfig::setRepoPackagesPath(const zypp::filesystem::Pathname &path_r)
  {
    _pimpl->cfg_packages_path = path_r;
  }
 
 
  Pathname ZConfig::configPath() const
  {
    return ( _pimpl->cfg_config_path.empty()
        ? Pathname("/etc/zypp") : _pimpl->cfg_config_path );
  }
 
  Pathname ZConfig::knownReposPath() const
  {
    return ( _pimpl->cfg_known_repos_path.empty()
        ? (configPath()/"repos.d") : _pimpl->cfg_known_repos_path );
  }
 
  Pathname ZConfig::knownServicesPath() const
  {
    return ( _pimpl->cfg_known_services_path.empty()
        ? (configPath()/"services.d") : _pimpl->cfg_known_services_path );
  }
 
  Pathname ZConfig::needrebootFile() const
  { return configPath()/"needreboot"; }
 
  Pathname ZConfig::needrebootPath() const
  { return configPath()/"needreboot.d"; }
 
  Pathname ZConfig::varsPath() const
  {
    return ( _pimpl->cfg_vars_path.empty()
        ? (configPath()/"vars.d") : _pimpl->cfg_vars_path );
  }
 
  Pathname ZConfig::vendorPath() const
  {
    return ( _pimpl->cfg_vendor_path.empty()
        ? (configPath()/"vendors.d") : _pimpl->cfg_vendor_path );
  }
 
  Pathname ZConfig::locksFile() const
  {
    return ( _pimpl->locks_file.empty()
        ? (configPath()/"locks") : _pimpl->locks_file );
  }
 
 
  bool ZConfig::repo_add_probe() const
  { return _pimpl->repo_add_probe; }
 
  unsigned ZConfig::repo_refresh_delay() const
  { return _pimpl->repo_refresh_delay; }
 
  LocaleSet ZConfig::repoRefreshLocales() const
  { return _pimpl->repoRefreshLocales.empty() ? Target::requestedLocales("") :_pimpl->repoRefreshLocales; }
 
  bool ZConfig::repoLabelIsAlias() const
  { return _pimpl->repoLabelIsAlias; }
 
  void ZConfig::repoLabelIsAlias( bool yesno_r )
  { _pimpl->repoLabelIsAlias = yesno_r; }
 
  bool ZConfig::download_use_deltarpm() const
  { return _pimpl->download_use_deltarpm; }
 
  bool ZConfig::download_use_deltarpm_always() const
  { return download_use_deltarpm() && _pimpl->download_use_deltarpm_always; }
 
  bool ZConfig::download_media_prefer_download() const
  { return _pimpl->download_media_prefer_download; }
 
  void ZConfig::set_download_media_prefer_download( bool yesno_r )
  { _pimpl->download_media_prefer_download.set( yesno_r ); }
 
  void ZConfig::set_default_download_media_prefer_download()
  { _pimpl->download_media_prefer_download.restoreToDefault(); }
 
  long ZConfig::download_max_concurrent_connections() const
  { return _pimpl->download_max_concurrent_connections; }
 
  long ZConfig::download_min_download_speed() const
  { return _pimpl->download_min_download_speed; }
 
  long ZConfig::download_max_download_speed() const
  { return _pimpl->download_max_download_speed; }
 
  long ZConfig::download_max_silent_tries() const
  { return _pimpl->download_max_silent_tries; }
 
  long ZConfig::download_transfer_timeout() const
  { return _pimpl->download_transfer_timeout; }
 
  Pathname ZConfig::download_mediaMountdir() const              { return _pimpl->download_mediaMountdir; }
  void ZConfig::set_download_mediaMountdir( Pathname newval_r ) { _pimpl->download_mediaMountdir.set( std::move(newval_r) ); }
  void ZConfig::set_default_download_mediaMountdir()            { _pimpl->download_mediaMountdir.restoreToDefault(); }
 
  DownloadMode ZConfig::commit_downloadMode() const
  { return _pimpl->commit_downloadMode; }
 
 
  bool ZConfig::gpgCheck() const                        { return _pimpl->gpgCheck; }
  TriBool ZConfig::repoGpgCheck() const                 { return _pimpl->repoGpgCheck; }
  TriBool ZConfig::pkgGpgCheck() const                  { return _pimpl->pkgGpgCheck; }
 
  void ZConfig::setGpgCheck( bool val_r )               { _pimpl->gpgCheck.set( val_r ); }
  void ZConfig::setRepoGpgCheck( TriBool val_r )        { _pimpl->repoGpgCheck.set( val_r ); }
  void ZConfig::setPkgGpgCheck( TriBool val_r )         { _pimpl->pkgGpgCheck.set( val_r ); }
 
  void ZConfig::resetGpgCheck()                         { _pimpl->gpgCheck.restoreToDefault(); }
  void ZConfig::resetRepoGpgCheck()                     { _pimpl->repoGpgCheck.restoreToDefault(); }
  void ZConfig::resetPkgGpgCheck()                      { _pimpl->pkgGpgCheck.restoreToDefault(); }
 
  ResolverFocus ZConfig::solver_focus() const           { return _pimpl->solver_focus; }
 
  bool ZConfig::solver_onlyRequires() const
  { return _pimpl->solver_onlyRequires; }
 
  bool ZConfig::solver_allowVendorChange() const
  { return _pimpl->solver_allowVendorChange; }
 
  bool ZConfig::solver_dupAllowDowngrade() const        { return _pimpl->solver_dupAllowDowngrade; }
  bool ZConfig::solver_dupAllowNameChange() const       { return _pimpl->solver_dupAllowNameChange; }
  bool ZConfig::solver_dupAllowArchChange() const       { return _pimpl->solver_dupAllowArchChange; }
  bool ZConfig::solver_dupAllowVendorChange() const     { return _pimpl->solver_dupAllowVendorChange; }
 
  bool ZConfig::solver_cleandepsOnRemove() const
  { return _pimpl->solver_cleandepsOnRemove; }
 
  Pathname ZConfig::solver_checkSystemFile() const
  { return ( _pimpl->solver_checkSystemFile.empty()
      ? (configPath()/"systemCheck") : _pimpl->solver_checkSystemFile ); }
 
  Pathname ZConfig::solver_checkSystemFileDir() const
  { return ( _pimpl->solver_checkSystemFileDir.empty()
      ? (configPath()/"systemCheck.d") : _pimpl->solver_checkSystemFileDir ); }
 
  unsigned ZConfig::solver_upgradeTestcasesToKeep() const
  { return _pimpl->solver_upgradeTestcasesToKeep; }
 
  bool ZConfig::solverUpgradeRemoveDroppedPackages() const              { return _pimpl->solverUpgradeRemoveDroppedPackages; }
  void ZConfig::setSolverUpgradeRemoveDroppedPackages( bool val_r )     { _pimpl->solverUpgradeRemoveDroppedPackages.set( val_r ); }
  void ZConfig::resetSolverUpgradeRemoveDroppedPackages()               { _pimpl->solverUpgradeRemoveDroppedPackages.restoreToDefault(); }
 
  namespace
  {
    inline void sigMultiversionSpecChanged()
    {
      sat::detail::PoolMember::myPool().multiversionSpecChanged();
    }
  }
 
  const std::set<std::string> & ZConfig::multiversionSpec() const       { return _pimpl->multiversion(); }
  void ZConfig::multiversionSpec( std::set<std::string> new_r )         { _pimpl->multiversion().swap( new_r );         sigMultiversionSpecChanged(); }
  void ZConfig::clearMultiversionSpec()                                 { _pimpl->multiversion().clear();               sigMultiversionSpecChanged(); }
  void ZConfig::addMultiversionSpec( const std::string & name_r )       { _pimpl->multiversion().insert( name_r );      sigMultiversionSpecChanged(); }
  void ZConfig::removeMultiversionSpec( const std::string & name_r )    { _pimpl->multiversion().erase( name_r );       sigMultiversionSpecChanged(); }
 
  bool ZConfig::apply_locks_file() const
  { return _pimpl->apply_locks_file; }
 
  Pathname ZConfig::update_dataPath() const
  {
    return ( _pimpl->update_data_path.empty()
        ? Pathname("/var/adm") : _pimpl->update_data_path );
  }
 
  Pathname ZConfig::update_messagesPath() const
  {
    return ( _pimpl->update_messages_path.empty()
             ? Pathname(update_dataPath()/"update-messages") : _pimpl->update_messages_path );
  }
 
  Pathname ZConfig::update_scriptsPath() const
  {
    return ( _pimpl->update_scripts_path.empty()
             ? Pathname(update_dataPath()/"update-scripts") : _pimpl->update_scripts_path );
  }
 
  std::string ZConfig::updateMessagesNotify() const
  { return _pimpl->updateMessagesNotify; }
 
  void ZConfig::setUpdateMessagesNotify( const std::string & val_r )
  { _pimpl->updateMessagesNotify.set( val_r ); }
 
  void ZConfig::resetUpdateMessagesNotify()
  { _pimpl->updateMessagesNotify.restoreToDefault(); }
 
 
  target::rpm::RpmInstFlags ZConfig::rpmInstallFlags() const
  { return _pimpl->rpmInstallFlags; }
 
 
  Pathname ZConfig::historyLogFile() const
  {
    return ( _pimpl->history_log_path.empty() ?
        Pathname("/var/log/zypp/history") : _pimpl->history_log_path );
  }
 
  Pathname ZConfig::credentialsGlobalDir() const
  {
    return ( _pimpl->credentials_global_dir_path.empty() ?
        Pathname("/etc/zypp/credentials.d") : _pimpl->credentials_global_dir_path );
  }
 
  Pathname ZConfig::credentialsGlobalFile() const
  {
    return ( _pimpl->credentials_global_file_path.empty() ?
        Pathname("/etc/zypp/credentials.cat") : _pimpl->credentials_global_file_path );
  }
 
 
  std::string ZConfig::distroverpkg() const
  { return "system-release"; }
 
 
  Pathname ZConfig::pluginsPath() const
  { return _pimpl->pluginsPath.get(); }
 
  string ZConfig::multiversionKernels() const
  {
    return _pimpl->cfg_kernel_keep_spec;
  }
 
 
  std::ostream & ZConfig::about( std::ostream & str ) const
  {
    str << "libzypp: " LIBZYPP_VERSION_STRING << endl;
 
    str << "libsolv: " << solv_version;
    if ( ::strcmp( solv_version, LIBSOLV_VERSION_STRING ) )
      str << " (built against " << LIBSOLV_VERSION_STRING << ")";
    str << endl;
 
    str << "zypp.conf: '" << _pimpl->_parsedZyppConf << "'" << endl;
    str << "TextLocale: '" << textLocale() << "' (" << defaultTextLocale() << ")" << endl;
    str << "SystemArchitecture: '" << systemArchitecture() << "' (" << defaultSystemArchitecture() << ")" << endl;
    return str;
  }
 
} // namespace zypp