libzypp  17.36.3
MediaSetAccess.h
Go to the documentation of this file.
1 /*---------------------------------------------------------------------\
2 | ____ _ __ __ ___ |
3 | |__ / \ / / . \ . \ |
4 | / / \ V /| _/ _/ |
5 | / /__ | | | | | | |
6 | /_____||_| |_| |_| |
7 | |
8 \---------------------------------------------------------------------*/
9 
10 #ifndef ZYPP_MediaSetAccess_H
11 #define ZYPP_MediaSetAccess_H
12 
13 #include <iosfwd>
14 #include <string>
15 #include <vector>
16 #include <zypp/base/Function.h>
17 
19 #include <zypp/base/NonCopyable.h>
20 #include <zypp/base/Flags.h>
21 #include <zypp/base/PtrTypes.h>
23 #include <zypp/Pathname.h>
24 #include <zypp/CheckSum.h>
25 #include <zypp-core/OnMediaLocation>
26 #include <zypp/ManagedFile.h>
27 
29 namespace zypp
30 {
31 
33 
35  //
36  // CLASS NAME : MediaSetAccess
37  //
81  {
82  friend std::ostream & operator<<( std::ostream & str, const MediaSetAccess & obj );
83 
84  public:
92  MediaSetAccess( Url url, Pathname prefered_attach_point = "" );
94  MediaSetAccess( std::string label_r, Url url, Pathname prefered_attach_point = "" );
95  ~MediaSetAccess() override;
96 
100  void setVerifier( unsigned media_nr, const media::MediaVerifierRef& verifier );
101 
105  const std::string & label() const
106  { return _label; }
107 
111  void setLabel( const std::string & label_r )
112  { _label = label_r; }
113 
115  {
119  PROVIDE_DEFAULT = 0x0,
120  PROVIDE_NON_INTERACTIVE = 0x1
121  };
122  ZYPP_DECLARE_FLAGS(ProvideFileOptions,ProvideFileOption);
123 
134  void precacheFiles(const std::vector<OnMediaLocation> &files);
135 
163  Pathname provideFile( const OnMediaLocation & resource, ProvideFileOptions options = PROVIDE_DEFAULT );
164 
168  ZYPP_DEPRECATED Pathname provideFile( const OnMediaLocation & resource, ProvideFileOptions options, const Pathname &deltafile );
169 
190  Pathname provideFile(const Pathname & file, unsigned media_nr = 1, ProvideFileOptions options = PROVIDE_DEFAULT );
191 
199  Pathname provideOptionalFile( const Pathname & file, unsigned media_nr = 1 );
200 
218  static ManagedFile provideFileFromUrl( const Url & file_url, ProvideFileOptions options = PROVIDE_DEFAULT );
219 
227  static ManagedFile provideOptionalFileFromUrl( const Url & file_url );
228 
235  void releaseFile( const OnMediaLocation &resource );
236 
237 
245  void releaseFile(const Pathname & file, unsigned media_nr = 1 );
246 
263  {
266  ReleaseFileGuard( MediaSetAccess & media_r, const OnMediaLocation & loc_r )
267  : _media( media_r )
268  , _loc( loc_r )
269  {}
271  { _media.releaseFile( _loc ); }
272  private:
275  };
276 
294  Pathname provideDir(const Pathname & dir, bool recursive, unsigned media_nr = 1, ProvideFileOptions options = PROVIDE_DEFAULT );
295 
310  bool doesFileExist(const Pathname & file, unsigned media_nr = 1 );
311 
315  void dirInfo( filesystem::DirContent &retlist, const Pathname &dirname,
316  bool dots = true, unsigned media_nr = 1 );
317 
323  void release();
324 
339  static Url rewriteUrl (const Url & url_r, const media::MediaNr medianr);
340 
341  protected:
357  Pathname provideFileInternal( const OnMediaLocation &resource, ProvideFileOptions options );
358 
359  using ProvideOperation = function<void (media::MediaAccessId, const OnMediaLocation &)>;
360 
361  void provide( const ProvideOperation& op, const OnMediaLocation &resource, ProvideFileOptions options );
362 
363  media::MediaAccessId getMediaAccessId (media::MediaNr medianr);
364  std::ostream & dumpOn( std::ostream & str ) const override;
365 
366  private:
369 
377 
378  std::string _label;
379 
380  using MediaMap = std::map<media::MediaNr, media::MediaAccessId>;
381  using VerifierMap = std::map<media::MediaNr, media::MediaVerifierRef>;
382 
387  };
389  ZYPP_DECLARE_OPERATORS_FOR_FLAGS(MediaSetAccess::ProvideFileOptions);
390 
392  inline std::ostream & operator<<( std::ostream & str, const MediaSetAccess & obj )
393  { return obj.dumpOn( str ); }
394 
395 
396 } // namespace zypp
398 #endif // ZYPP_SOURCE_MediaSetAccess_H
void setLabel(const std::string &label_r)
Set the label identifing this media set and to be sent in a media change request. ...
ZYPP_DECLARE_FLAGS(VendorSupportOptions, VendorSupportOption)
std::map< media::MediaNr, media::MediaAccessId > MediaMap
Pathname deltafile
Describes a resource file located on a medium.
MediaMap _medias
Mapping between media number and Media Access ID.
Url _url
Media or media set URL.
ZYPP_DECLARE_OPERATORS_FOR_FLAGS(DiskUsageCounter::MountPoint::HintFlags)
String related utilities and Regular expression matching.
std::ostream & operator<<(std::ostream &str, const SerialNumber &obj)
Definition: SerialNumber.cc:52
Pathname _prefAttachPoint
Prefered mount point.
std::ostream & operator<<(std::ostream &str, const MediaSetAccess &obj)
std::list< DirEntry > DirContent
Returned by readdir.
Definition: PathInfo.h:526
std::ostream & dumpOn(std::ostream &str) const override
Overload to realize std::ostream & operator<<.
unsigned int MediaAccessId
Media manager access Id type.
Definition: MediaSource.h:30
MediaHandle _media
ManagedFile provideFile(RepoInfo repo_r, const OnMediaLocation &loc_r, const ProvideFilePolicy &policy_r)
Provide a file from a Repository.
const Arch Arch_armv7hnl Arch_armv7nhl ZYPP_API
Definition: ResTraits.h:93
DEFINE_PTR_TYPE(Application)
ReleaseFileGuard(MediaSetAccess &media_r, const OnMediaLocation &loc_r)
std::ostream & dumpOn(std::ostream &str, const Capability &obj)
Definition: Capability.cc:580
Base class for reference counted objects.
#define NON_MOVABLE(CLASS)
Delete move ctor and move assign.
Definition: Easy.h:59
MediaVerifierRef verifier
unsigned int MediaNr
Definition: MediaManager.h:32
Wrapper for const correct access via Smart pointer types.
Definition: PtrTypes.h:292
#define NON_COPYABLE(CLASS)
Delete copy ctor and copy assign.
Definition: Easy.h:49
const std::string & label() const
The label identifing this media set and to be sent in a media change request.
std::map< media::MediaNr, media::MediaVerifierRef > VerifierMap
Easy-to use interface to the ZYPP dependency resolver.
Definition: Application.cc:19
function< void(media::MediaAccessId, const OnMediaLocation &)> ProvideOperation
#define ZYPP_DEPRECATED
The ZYPP_DEPRECATED macro can be used to trigger compile-time warnings with gcc >= 3...
Definition: Globals.h:112
VerifierMap _verifiers
Mapping between media number and corespondent verifier.
bool provide(const Pathname &delta_r, const Pathname &new_r, const Progress &report_r)
Apply a binary delta to on-disk data to re-create a new rpm.
Url manipulation class.
Definition: Url.h:92
boost::noncopyable NonCopyable
Ensure derived classes cannot be copied.
Definition: NonCopyable.h:26