zypp/Target.h

   1 /*---------------------------------------------------------------------\
   2 |                          ____ _   __ __ ___                          |
   3 |                         |__  / \ / / . \ . \                         |
   4 |                           / / \ V /|  _/  _/                         |
   5 |                          / /__ | | | | | |                           |
   6 |                         /_____||_| |_| |_|                           |
   7 |                                                                      |
   8 \---------------------------------------------------------------------*/
   9 /** \file zypp/Target.h
  10  *
  11 */
  12 #ifndef ZYPP_TARGET_H
  13 #define ZYPP_TARGET_H
  14
  15 #include <iosfwd>
  16
  17 #include "zypp/base/ReferenceCounted.h"
  18 #include "zypp/base/NonCopyable.h"
  19 #include "zypp/base/PtrTypes.h"
  20 #include "zypp/base/Deprecated.h"
  21
  22 #include "zypp/Pathname.h"
  23 #include "zypp/ResPool.h"
  24
  25 ///////////////////////////////////////////////////////////////////
  26 namespace zypp
  27 { /////////////////////////////////////////////////////////////////
  28   namespace target
  29   {
  30     class TargetImpl;
  31     namespace rpm {
  32       class RpmDb;
  33     }
  34   }
  35   namespace zypp_detail
  36   {
  37     class ZYppImpl;
  38   }
  39
  40   DEFINE_PTR_TYPE(Target);
  41
  42   ///////////////////////////////////////////////////////////////////
  43   //
  44   //    CLASS NAME : Target
  45   //
  46   /**
  47   */
  48   class Target : public base::ReferenceCounted, public base::NonCopyable
  49   {
  50   public:
  51     typedef target::TargetImpl  Impl;
  52     typedef intrusive_ptr<Impl> Impl_Ptr;
  53     typedef std::list<PoolItem> PoolItemList;
  54
  55   public:
  56
  57     /**
  58      * builds or refreshes the target cache
  59      */
  60     void buildCache();
  61
  62     /**
  63      * cleans the target cache (.solv files)
  64      */
  65     void cleanCache();
  66
  67    /**
  68      * load resolvables into the pool
  69      */
  70     void load();
  71
  72     /**
  73      * unload target resolvables from the
  74      * pool
  75      */
  76     void unload();
  77
  78     /** \deprecated NOOP
  79     */
  80     ZYPP_DEPRECATED void reset() {}
  81
  82     /** Null implementation */
  83     static Target_Ptr nullimpl();
  84
  85     /** Refference to the RPM database */
  86     target::rpm::RpmDb & rpmDb();
  87
  88     /** If the package is installed and provides the file
  89      Needed to evaluate split provides during Resolver::Upgrade() */
  90     bool providesFile (const std::string & name_str, const std::string & path_str) const;
  91
  92     /** Return name of package owning \a path_str
  93      * or empty string if no installed package owns \a path_str.
  94      **/
  95     std::string whoOwnsFile (const std::string & path_str) const;
  96
  97     /** Set the log file for target */
  98     bool setInstallationLogfile(const Pathname & path_r);
  99
 100     /** Return the root set for this target */
 101     Pathname root() const;
 102
 103     /** return the last modification date of the target */
 104     Date timestamp() const;
 105
 106     /** The targets distribution release string.
 107      * \code
 108      *   openSUSE 10.3 (i586)
 109      * \endcode
 110     */
 111     std::string release() const;
 112
 113     /**
 114      * anonymous unique id
 115      *
 116      * This id is generated once and stays in the
 117      * saved in the target.
 118      * It is unique and is used only for statistics.
 119      *
 120      */
 121     std::string anonymousUniqueId() const;
 122
 123   public:
 124     /** Ctor. If \c doRebuild_r is \c true, an already existing
 125      * database is rebuilt (rpm --rebuilddb ).
 126     */
 127     explicit
 128     Target( const Pathname & root = "/", bool doRebuild_r = false );
 129     /** Ctor */
 130     explicit
 131     Target( const Impl_Ptr & impl_r );
 132
 133   private:
 134     friend std::ostream & operator<<( std::ostream & str, const Target & obj );
 135     /** Stream output. */
 136     std::ostream & dumpOn( std::ostream & str ) const;
 137
 138   private:
 139     /** Direct access to Impl. */
 140     friend class zypp_detail::ZYppImpl;
 141
 142     /** Pointer to implementation */
 143     RW_pointer<Impl,rw_pointer::Intrusive<Impl> > _pimpl;
 144
 145     static Target_Ptr _nullimpl;
 146   };
 147   ///////////////////////////////////////////////////////////////////
 148
 149   /** \relates Target Stream output. */
 150   inline std::ostream & operator<<( std::ostream & str, const Target & obj )
 151   { return obj.dumpOn( str ); }
 152
 153
 154   /////////////////////////////////////////////////////////////////
 155 } // namespace zypp
 156 ///////////////////////////////////////////////////////////////////
 157 #endif // ZYPP_TARGET_H