Logo ROOT   6.30.04
Reference Guide
 All Namespaces Files Pages
TDataSetManagerFile.h
Go to the documentation of this file.
1 // @(#)root/proof:$Id$
2 // Author: Jan Fiete Grosse-Oetringhaus, 08.08.07
3 
4 /*************************************************************************
5  * Copyright (C) 1995-2000, Rene Brun and Fons Rademakers. *
6  * All rights reserved. *
7  * *
8  * For the licensing terms see $ROOTSYS/LICENSE. *
9  * For the list of contributors see $ROOTSYS/README/CREDITS. *
10  *************************************************************************/
11 
12 #ifndef ROOT_TDataSetManagerFile
13 #define ROOT_TDataSetManagerFile
14 
15 //////////////////////////////////////////////////////////////////////////
16 // //
17 // TDataSetManagerFile //
18 // //
19 // Implementation of TDataSetManager handling datasets from root //
20 // files under a specific directory path //
21 // //
22 //////////////////////////////////////////////////////////////////////////
23 
24 #include "TDataSetManager.h"
25 
26 const char* const kDataSet_LocalCache = "dataset.cache"; // default cache subdirectory
27 const char* const kDataSet_DataSetList = "dataset.list"; // file with info about all datasets
28 const char* const kDataSet_LockLocation = "lock.location"; // location of the lock file
29 
30 class TDataSetManagerFile : public TDataSetManager {
31 
32 private:
33  TString fDataSetDir; // Location of datasets
34  TString fMSSUrl; // URL for the Mass Storage System
35  TString fStageOpts; // Option string to be used in issuing staging requests
36  TString fDataSetLockFile; // Dataset lock file
37  Int_t fLockFileTimeLimit; // Limit in seconds after a lock automatically expires
38  TString fListFile; // File to check repository updates
39  Bool_t fIsRemote; // True if the repository is remote
40  Bool_t fUseCache; // True if the cache is used for browsing remote repositories
41  TString fLocalCacheDir; // Local cache when the repository is remote
42  Int_t fCacheUpdatePeriod; // Period for checking for new updated information
43  Bool_t fOpenPerms; // True if file permissions must be open
44 
45  // Local cache handling
46  void InitLocalCache();
47  Int_t CheckLocalCache(const char *group, const char *user, const char *dsName = "ls", UInt_t option = 0);
48 
49 protected:
50  const char *GetDataSetPath(const char *group, const char *user, const char *dsName);
51  const char *GetDataSetPath(const char *group, const char *user, const char *dsName,
52  TString &md5path, Bool_t local = kFALSE);
53  void Init();
54  Bool_t BrowseDataSets(const char *group, const char *user, const char *dsName,
55  UInt_t option, TObject *target);
56 
57  Bool_t RemoveDataSet(const char *group, const char *user, const char *dsName);
58  Bool_t ExistsDataSet(const char *group, const char *user, const char *dsName);
59 
60  Int_t ScanDataSet(const char *group, const char *user, const char *dsName, UInt_t option = kReopen | kDebug);
61 
62  Int_t ChecksumDataSet(const char *path, const char *md5path, TString &checksum);
63 
64  Int_t CreateLsFile(const char *group, const char *user, Long_t &mtime, TString &checksum);
65  Int_t FillLsDataSet(const char *group, const char *user, const char *dsName, TList *out, UInt_t option);
66 
67  void UpdateUsedSpace();
68 
69 public:
70  TDataSetManagerFile() : TDataSetManager(0, 0, 0) { }
71  TDataSetManagerFile(const char *group, const char *user, const char *ins);
72  TDataSetManagerFile(const char *ins);
73  virtual ~TDataSetManagerFile() { }
74 
75  void ParseInitOpts(const char *opts);
76 
77  Int_t ClearCache(const char *uri = 0);
78  TFileCollection *GetDataSet(const char *uri, const char *srv = 0);
79  TMap *GetDataSets(const char *uri, UInt_t option = TDataSetManager::kExport);
80  Bool_t ExistsDataSet(const char *uri);
81  Bool_t RemoveDataSet(const char *uri);
82 
83  Int_t RegisterDataSet(const char *uri, TFileCollection *dataSet, const char *opt);
84  Int_t ScanDataSet(const char *uri, UInt_t option = kReopen | kDebug);
85  Int_t NotifyUpdate(const char *group, const char *user,
86  const char *dspath, Long_t mtime, const char *checksum = 0);
87  Int_t ShowCache(const char *uri = 0);
88 
89  // These should / could be private but they are used directly by the external daemon
90  TFileCollection *GetDataSet(const char *group, const char *user, const char *dsName,
91  UInt_t option = 0, TMD5 **checksum = 0);
92  TMap *GetDataSets(const char *group, const char *user, const char *dsName = 0,
93  UInt_t option = 0);
94  const char *GetMSSUrl() const { return fMSSUrl; }
95  const char *GetStageOpts() const { return fStageOpts; }
96  Int_t WriteDataSet(const char *group, const char *user, const char *dsName,
97  TFileCollection *dataset, UInt_t option = 0, TMD5 *checksum = 0);
98  Long_t GetModTime(const char *uri);
99 
100  ClassDef(TDataSetManagerFile, 0) // DataSet manager for files
101 };
102 
103 #endif