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      * load resolvables into the pool
  64      */
  65     void load();
  66
  67     /**
  68      * unload target resolvables from the
  69      * pool
  70      */
  71     void unload();
  72
  73     /** \deprecated NOOP
  74     */
  75     ZYPP_DEPRECATED void reset() {}
  76
  77     /** Null implementation */
  78     static Target_Ptr nullimpl();
  79
  80     /** Refference to the RPM database */
  81     target::rpm::RpmDb & rpmDb();
  82
  83     /** If the package is installed and provides the file
  84      Needed to evaluate split provides during Resolver::Upgrade() */
  85     bool providesFile (const std::string & name_str, const std::string & path_str) const;
  86
  87     /** Return name of package owning \a path_str
  88      * or empty string if no installed package owns \a path_str.
  89      **/
  90     std::string whoOwnsFile (const std::string & path_str) const;
  91
  92     /** Set the log file for target */
  93     bool setInstallationLogfile(const Pathname & path_r);
  94
  95     /** Return the root set for this target */
  96     Pathname root() const;
  97
  98     /** return the last modification date of the target */
  99     Date timestamp() const;
 100
 101   public:
 102     /** Ctor */
 103     explicit
 104     Target( const Pathname & root = "/" );
 105     /** Ctor */
 106     explicit
 107     Target( const Impl_Ptr & impl_r );
 108
 109   private:
 110     friend std::ostream & operator<<( std::ostream & str, const Target & obj );
 111     /** Stream output. */
 112     std::ostream & dumpOn( std::ostream & str ) const;
 113
 114   private:
 115     /** Direct access to Impl. */
 116     friend class zypp_detail::ZYppImpl;
 117
 118     /** Pointer to implementation */
 119     RW_pointer<Impl,rw_pointer::Intrusive<Impl> > _pimpl;
 120
 121     static Target_Ptr _nullimpl;
 122   };
 123   ///////////////////////////////////////////////////////////////////
 124
 125   /** \relates Target Stream output. */
 126   inline std::ostream & operator<<( std::ostream & str, const Target & obj )
 127   { return obj.dumpOn( str ); }
 128
 129
 130   /////////////////////////////////////////////////////////////////
 131 } // namespace zypp
 132 ///////////////////////////////////////////////////////////////////
 133 #endif // ZYPP_TARGET_H