source: trunk/FACT++/src/dataLogger.cc@ 10623

//****************************************************************
/** @class DataLogger
  
  @brief Logs all message and infos between the services
  
  This is the main logging class facility. 
  It derives from StateMachineDim and DimInfoHandler. the first parent is here to enforce 
  a state machine behaviour, while the second one is meant to make the dataLogger receive
  dim services to which it subscribed from.
  The possible states and transitions of the machine are:
  \dot
  digraph datalogger {
                node [shape=record, fontname=Helvetica, fontsize=10];
        e [label="Error" color="red"];
   r [label="Ready"]
   d [label="NightlyOpen"]
   w [label="WaitingRun"]
        l [label="Logging"]
   b [label="BadNightlyconfig" color="red"]
   c [label="BadRunConfig" color="red"]
  
  e -> r
  r -> e
  r -> d
  r -> b
  d -> w
  d -> r
  w -> r
  l -> r
  l -> w
  b -> d
  w -> c
  w -> l
  b -> r
  c -> r
  c -> l
  }
  \enddot
  
  @todo
        - Retrieve also the messages, not only the infos
 */
 //****************************************************************
#include "Event.h"
#include "Time.h"
#include "StateMachineDim.h"
#include "WindowLog.h"
#include "Configuration.h"
#include "ServiceList.h"
#include "Converter.h"
#include "MessageImp.h"
#include "LocalControl.h"
#include "DimDescriptionService.h"

#include "Description.h"

#include "DimServiceInfoList.h"

//for getting stat of opened files
#include <unistd.h>
//for getting disk free space
#include <sys/statvfs.h>
//for getting files sizes
#include <sys/stat.h>

#define HAS_FITS
//#define ONE_RUN_FITS_ONLY

#include <fstream>

#include <boost/bind.hpp>
#if BOOST_VERSION < 104400
#if (__GNUC__ > 4 || (__GNUC__ == 4 && __GNUC_MINOR__ > 4))
#undef BOOST_HAS_RVALUE_REFS
#endif
#endif
#include <boost/thread.hpp>

#ifdef HAS_FITS
#include "Fits.h"
#endif

//Dim structures
struct DataLoggerStats {
        long sizeWritten;
        long freeSpace;
        long writingRate;
};

struct NumSubAndFitsType {
        int numSubscriptions;
        int numOpenFits;
};

struct OpenFileToDim {
        int code;
        char fileName[FILENAME_MAX];
};
//For debugging DIM's services
class MyService
{
public:
        MyService(){};
        MyService(std::string, std::string, void*, int){};
        MyService(std::string, const char*){};
        void updateService(){};
        void updateService(void*, int){};
        void setQuality(int){};
};
class DataLogger : public StateMachineDim, DimInfoHandler//, DimServiceInfoList //,DimInfoHandler 
{
public:
        /// The list of existing states specific to the DataLogger
        enum
        {
                kSM_NightlyOpen = 20, ///< Nightly file openned and writing
                kSM_WaitingRun = 30, ///< waiting for the run number to open the run file
                kSM_Logging = 40, ///< both files openned and writing
                kSM_BadNightlyConfig = 0x101, ///< the folder specified for Nightly logging does not exist or has bad permissions
                kSM_BadRunConfig = 0x102, ///<  the folder specified for the run logging does not exist or has wrong permissions or no run number
        } localstates_t;
        
    DataLogger(std::ostream &out);
        ~DataLogger(); 
        
private:
        //Define all the data structure specific to the DataLogger here
        /// ofstream for the NightlyLogfile
        std::ofstream fNightlyLogFile;
        /// ofstream for the run-specific Log file
        std::ofstream fRunLogFile; 

        /// ofstream for the Nightly report file
        std::ofstream fNightlyReportFile;
        /// ofstream for the run-specific report file
        std::ofstream fRunReportFile;
        /// base path of the Nightlyfile
        std::string fNightlyFileName; 
        ///base path of the run file
        std::string fRunFileName; 
        ///run number (-1 means no run number specified)
        int fRunNumber; 
        ///Current Service Quality
        int fQuality;
        ///Modified Julian Date
        double fMjD;
        
        ///Define all the static names
        static const char* fConfigDay;
        static const char* fConfigRun;
        static const char* fConfigRunNumber;
        static const char* fConfigLog;
        static const char* fTransStart;
        static const char* fTransStop;
        static const char* fTransStartRun;
        static const char* fTransStopRun;
        static const char* fTransReset;
        static const char* fTransWait;
        static const char* fRunNumberInfo; ///< This is the name of the dimInfo received to specify the run number. It must be updated once the final name will be defined
        static const char* fPrintCommand;
        static const char* fDebugOnOff;
        static const char* fStatsPeriod;
        static const char* fStartStopOpenedFiles;
        static const char* fStartStopNumSubsAndFits;
        //overloading of DIM's infoHandler function
        void infoHandler(); 
        
        ///for obtaining the name of the existing services
        ServiceList fServiceList;
        
        ///A std pair to store both the DimInfo pointer and the corresponding outputted fits file
        struct SubscriptionType
        { 
#ifdef HAS_FITS
                ///Nightly FITS output file
                Fits    nightlyFile;
                ///run-specific FITS output file
                Fits    runFile;
#endif
                ///the actual dimInfo pointer
                DimStampedInfo* dimInfo;
                ///the converter for outputting the data according to the format
                Converter* fConv;
                ///the number of existing handlers to this structure.
                ///This is required otherwise I MUST handle the deleting of dimInfo outside from the destructor
                int* numCopies;
                void operator = (const SubscriptionType& other)
                {
#ifdef HAS_FITS
                        nightlyFile = other.nightlyFile;
                        runFile = other.runFile;
#endif
                        dimInfo = other.dimInfo;        
                        numCopies = other.numCopies;
                        fConv = other.fConv;
                        (*numCopies)++;
                }
                SubscriptionType(const SubscriptionType& other)
                {
#ifdef HAS_FITS
                        nightlyFile = other.nightlyFile;
                        runFile = other.runFile;
#endif
                        dimInfo = other.dimInfo;
                        numCopies = other.numCopies;
                        fConv = other.fConv;
                        (*numCopies)++; 
                }
                SubscriptionType(DimStampedInfo* info)
                {
                        dimInfo = info; 
                        fConv = NULL;
                        numCopies = new int(1);
                }
                SubscriptionType()
                {
                        dimInfo = NULL;
                        fConv = NULL;
                        numCopies = new int(1);
                }
                ~SubscriptionType()
                {
                        if (numCopies)
                        (*numCopies)--;
                        if (numCopies)
                        if (*numCopies < 1)
                        {
                                if (dimInfo)
                                delete dimInfo;
#ifdef HAS_FITS
                                if (nightlyFile.IsOpen())
                                        nightlyFile.Close();
                                if (runFile.IsOpen())
                                        runFile.Close();
#endif
                                if (numCopies)  
                                delete numCopies;
                                delete fConv;
                                fConv = NULL;
                                dimInfo = NULL;
                                numCopies = NULL;
                        }
                }
        };
        typedef std::map<const std::string, std::map<std::string, SubscriptionType>> SubscriptionsListType;
        ///All the services to which we have subscribed to, sorted by server name.
        SubscriptionsListType fServiceSubscriptions;

        ///Reporting method for the services info received
        void ReportPlease(DimInfo* I, SubscriptionType& sub);  

        ///Configuration of the nightly file path
        int ConfigureNightlyFileName(const Event& evt); 
        ///Configuration fo the file name
        int ConfigureRunFileName(const Event& evt); 
        ///DEPREC - configuration of the run number
        int ConfigureRunNumber(const Event& evt); 
        ///logging method for the messages
        int LogMessagePlease(const Event& evt); 
        ///print the current state of the dataLogger
        int PrintStatePlease(const Event& evt);
        ///checks whether or not the current info being treated is a run number
        void CheckForRunNumber(DimInfo* I); 
        /// start transition
        int StartPlease(); 
        ///from waiting to logging transition
        int StartRunPlease(); 
        /// from logging to waiting transition
        int StopRunPlease(); 
        ///stop and reset transition
        int GoToReadyPlease(); 
        ///from NightlyOpen to waiting transition
        int NightlyToWaitRunPlease(); 
#ifdef HAS_FITS
        ///Open fits files
        void OpenFITSFilesPlease(SubscriptionType& sub);
        ///Write data to FITS files
        void WriteToFITS(SubscriptionType& sub);
        ///Allocate the buffers required for fits
        void AllocateFITSBuffers(SubscriptionType& sub);
                
#ifdef ONE_RUN_FITS_ONLY
        ///FITS file for runs. only one, hence dealt with in the dataLogger itself
        FITS* fRunFitsFile;
#endif //one_run_fits_only
#endif//has_fits
public: 
        ///checks with fServiceList whether or not the services got updated
        bool CheckForServicesUpdate(); 

private:        
        ///monitoring notification loop
        void ServicesMonitoring();
        ///services notification thread
        boost::thread fMonitoringThread;
        ///end of the monitoring
        bool fContinueMonitoring;
        ///required for accurate monitoring
        std::map<std::string, long> fFileSizesMap;
        std::string fFullNightlyLogFileName;
        std::string fFullNightlyReportFileName;
        std::string fFullRunLogFileName;
        std::string fFullRunReportFileName;
        long fBaseSizeNightly;
        long fPreviousSize;
        long fBaseSizeRun;
        ///Service for opened files
        DimDescribedService* fOpenedNightlyFiles;
        DimDescribedService* fOpenedRunFiles;
        DimDescribedService* fNumSubAndFits;
        NumSubAndFitsType fNumSubAndFitsData;

        inline void NotifyOpenedFile(std::string name, int type, DimDescribedService* service);
public: 
        void setBlackWhiteList(const std::string& , bool);
private:
        std::set<std::string> fGreyList;
        bool fIsBlackList;
        bool fDebugIsOn;
        float fStatsPeriodDuration;
        bool fOpenedFilesIsOn;
        bool fNumSubAndFitsIsOn;
        //functions for controlling the services behavior
        int SetDebugOnOff(const Event& evt);
        int SetStatsPeriod(const Event& evt);
        int SetOpenedFilesOnOff(const Event& evt);
        int SetNumSubsAndFitsOnOff(const Event& evt);
        ///boolean to prevent DIM update while desctructing the dataLogger
        bool fDestructing;      
}; //DataLogger

//static members initialization
//since I do not check the transition/config names any longer, indeed maybe these could be hard-coded... but who knows what will happen in the future ?
const char* DataLogger::fConfigDay = "CONFIG_DAY";
const char* DataLogger::fConfigRun = "CONFIG_RUN";
const char* DataLogger::fConfigRunNumber = "CONFIG_RUN_NUMBER";
const char* DataLogger::fConfigLog = "LOG";
const char* DataLogger::fTransStart = "START";
const char* DataLogger::fTransStop = "STOP";
const char* DataLogger::fTransStartRun = "START_RUN";
const char* DataLogger::fTransStopRun = "STOP_RUN";
const char* DataLogger::fTransReset = "RESET";
const char* DataLogger::fTransWait = "WAIT_RUN_NUMBER";
const char* DataLogger::fRunNumberInfo = "RUN_NUMBER";
const char* DataLogger::fPrintCommand = "PRINT";
const char* DataLogger::fDebugOnOff = "DEBUG";
const char* DataLogger::fStatsPeriod = "STATS_PERIOD";
const char* DataLogger::fStartStopOpenedFiles = "OPENED_FILES_SRVC";
const char* DataLogger::fStartStopNumSubsAndFits = "NUM_SUBS_SRVC";

void DataLogger::ServicesMonitoring()
{
                //create the DIM service
                int dataSize = 2*sizeof(long) + sizeof(long);

                DataLoggerStats statVar;
                statVar.sizeWritten = 0;
                statVar.freeSpace = 0;
                statVar.writingRate = 0;

                struct statvfs vfs;
                if (!statvfs(fNightlyFileName.c_str(), &vfs))
                        statVar.freeSpace = vfs.f_bsize*vfs.f_bavail;
                else
                        statVar.freeSpace = -1;

                DimDescribedService srvc ("DATA_LOGGER/STATS", "X:3", &statVar, dataSize, "Add description here");
                fPreviousSize = 0;
                bool statWarning = false;
                //loop-wait for broadcast
                while (fContinueMonitoring)
                {
                        if (fStatsPeriodDuration == 0.0f)
                        {
                                sleep(0.1f);
                                continue;
                        }
                        else
                                sleep(fStatsPeriodDuration);
                        //update the fits files sizes
#ifdef HAS_FITS
                        SubscriptionsListType::iterator x;
                        std::map<std::string, SubscriptionType>::iterator y;
                        bool runFileDone = false;
                        for (x=fServiceSubscriptions.begin(); x != fServiceSubscriptions.end(); x++)
                        {
                                for (y=x->second.begin(); y != x->second.end(); y++)
                                {
                                        if (y->second.runFile.IsOpen() && !runFileDone)
                                        {
                                                        fFileSizesMap[y->second.runFile.fFileName] = y->second.runFile.GetWrittenSize();
#ifdef ONE_FITS_ONLY
                                                        runFileDone = true;
#endif
                                        }
                                        if (y->second.nightlyFile.IsOpen())
                                                fFileSizesMap[y->second.nightlyFile.fFileName] = y->second.nightlyFile.GetWrittenSize();
                                }
                        }
#endif
                        struct stat st;
                        //gather log and report files sizes on disk
                        if (fNightlyLogFile.is_open())
                        {
                                stat(fFullNightlyLogFileName.c_str(), &st);
                                fFileSizesMap[fFullNightlyLogFileName] = st.st_size;    
                        }
                        if (fNightlyReportFile.is_open())
                        {
                                stat(fFullNightlyReportFileName.c_str(), &st);
                                fFileSizesMap[fFullNightlyReportFileName] = st.st_size; 
                        }
                        if (fRunLogFile.is_open())
                        {
                                stat(fFullRunLogFileName.c_str(), &st);
                                fFileSizesMap[fFullRunLogFileName] = st.st_size;        
                        }
                        if (fRunReportFile.is_open())
                        {
                                stat(fFullRunReportFileName.c_str(), &st);
                                fFileSizesMap[fFullRunReportFileName] = st.st_size;
                        }       

                        if (!statvfs(fNightlyFileName.c_str(), &vfs))
                        {
                                statVar.freeSpace = vfs.f_bsize*vfs.f_bavail;
                                statWarning = false;
                        }
                        else
                        {
                                std::stringstream str;
                                str << "Unable to retrieve stats for " << fNightlyFileName << ". Reason: " << strerror(errno) << " [" << errno << "]";
                                if (!statWarning)
                                        Error(str);
                                statWarning = true;
                                statVar.freeSpace = -1;
                        }
                        
                        //sum up all the file sizes. past and present
                        statVar.sizeWritten = 0;
                        for (std::map<std::string, long>::iterator it=fFileSizesMap.begin(); it != fFileSizesMap.end();  it++)
                                statVar.sizeWritten += it->second;
                        statVar.sizeWritten -= fBaseSizeNightly;
                        statVar.sizeWritten -= fBaseSizeRun;
                        if (fStatsPeriodDuration == 0.0f)
                                continue;
                        statVar.writingRate = (statVar.sizeWritten - fPreviousSize)/fStatsPeriodDuration;  

                        fPreviousSize = statVar.sizeWritten;
                        if (statVar.writingRate != 0) //if data has been written
                        {
                                srvc.updateService();
                                if(fDebugIsOn)
                                {
                                        stringstream str;
                                        str << "Size written: " << statVar.sizeWritten/1024 << " KB; writting rate: ";
                                        str << statVar.writingRate/1024 << " KB/s; free space: ";
                                        str << statVar.freeSpace/(1024*1024) << " MB";
                                        Debug(str.str());
                                }
                        }
                }
}


// --------------------------------------------------------------------------
//
//! Default constructor. The name of the machine is given DATA_LOGGER
//! and the state is set to kSM_Ready at the end of the function.
//
//!Setup the allows states, configs and transitions for the data logger
//
DataLogger::DataLogger(std::ostream &out) : StateMachineDim(out, "DATA_LOGGER")
{
    dic_disable_padding();
    dis_disable_padding();

                //initialize member data
                fNightlyFileName = ".";//"/home/lyard/log";//
                fRunFileName = ".";//"/home/lyard/log";
                fRunNumber = 12345;
#ifdef HAS_FITS
#ifdef ONE_RUN_FITS_ONLY
                fRunFitsFile = NULL;
#endif
#endif

                //Give a name to this machine's specific states
                AddStateName(kSM_NightlyOpen,      "NightlyFileOpen",  "The summary files for the night are open.");
                AddStateName(kSM_WaitingRun,       "WaitForRun",       "The summary files for the night are open and we wait for a run to be started.");
                AddStateName(kSM_Logging,          "Logging",          "The summary files for the night and the files for a single run are open.");
                AddStateName(kSM_BadNightlyConfig, "ErrNightlyFolder", "The folder for the nighly summary files is invalid.");
                AddStateName(kSM_BadRunConfig,     "ErrRunFolder",     "The folder for the run files is invalid.");

                /*Add the possible transitions for this machine*/
                AddTransition(kSM_NightlyOpen, fTransStart, kSM_Ready, kSM_BadNightlyConfig)
                    (boost::bind(&DataLogger::StartPlease, this))
                    ("Start the nightly logging. Nightly file location must be specified already");

                AddTransition(kSM_Ready, fTransStop, kSM_NightlyOpen, kSM_WaitingRun, kSM_Logging)
                    (boost::bind(&DataLogger::GoToReadyPlease, this))
                    ("Stop all data logging, close all files.");

                AddTransition(kSM_Logging, fTransStartRun, kSM_WaitingRun, kSM_BadRunConfig)
                    (boost::bind(&DataLogger::StartRunPlease, this))
                    ("Start the run logging. Run file location must be specified already.");

                AddTransition(kSM_WaitingRun, fTransStopRun, kSM_Logging)
                    (boost::bind(&DataLogger::StopRunPlease, this))
                    ("Wait for a run to be started, open run-files as soon as a run number arrives.");

                AddTransition(kSM_Ready, fTransReset, kSM_Error, kSM_BadNightlyConfig, kSM_BadRunConfig, kSM_Error)
                    (boost::bind(&DataLogger::GoToReadyPlease, this))
                    ("Transition to exit error states. Closes the nightly file if already opened.");

                AddTransition(kSM_WaitingRun, fTransWait, kSM_NightlyOpen)
                    (boost::bind(&DataLogger::NightlyToWaitRunPlease, this));

                /*Add the possible configurations for this machine*/
                AddConfiguration(fConfigDay, "C", kSM_Ready, kSM_BadNightlyConfig)
                    (boost::bind(&DataLogger::ConfigureNightlyFileName, this, _1))
                    ("Configure the folder for the nightly files."
                     "|Path[string]:Absolute or relative path name where the nightly files should be stored.");

                AddConfiguration(fConfigRun, "C", kSM_Ready, kSM_BadNightlyConfig, kSM_NightlyOpen, kSM_WaitingRun, kSM_BadRunConfig)
                    (boost::bind(&DataLogger::ConfigureRunFileName, this, _1))
                    ("Configure the folder for the run files."
                     "|Path[string]:Absolute or relative path name where the run files should be stored.");

                AddConfiguration(fConfigRunNumber, "I", kSM_Ready, kSM_BadNightlyConfig, kSM_NightlyOpen, kSM_WaitingRun, kSM_BadRunConfig)
                    (boost::bind(&DataLogger::ConfigureRunNumber, this, _1))
                    ("configure the run number. cannot be done in logging state");

                //Provide a logging command
                //I get the feeling that I should be going through the EventImp
                //instead of DimCommand directly, mainly because the commandHandler
                //is already done in StateMachineImp.cc
                //Thus I'll simply add a configuration, which I will treat as the logging command
                AddConfiguration(fConfigLog, "C", kSM_NightlyOpen, kSM_Logging, kSM_WaitingRun, kSM_BadRunConfig)
                    (boost::bind(&DataLogger::LogMessagePlease, this, _1))
                    ("Log a single message to the log-files."
                     "|Message[string]:Message to be logged.");
                
                //Provide a print command
                AddConfiguration(fPrintCommand, kSM_NightlyOpen, kSM_Logging, kSM_WaitingRun, kSM_BadNightlyConfig, kSM_BadRunConfig)
                    (boost::bind(&DataLogger::PrintStatePlease, this, _1))
                    ("Print information about the internal status of the data logger.");

                fServiceList.SetHandler(this);
                CheckForServicesUpdate();

                //start the monitoring service
                fContinueMonitoring = true;
                fMonitoringThread = boost::thread(boost::bind(&DataLogger::ServicesMonitoring, this));
                fBaseSizeNightly = 0;
                fBaseSizeRun = 0;
                OpenFileToDim fToDim;
                fToDim.code = 0;
                fToDim.fileName[0] = '\0';

                fOpenedNightlyFiles = new DimDescribedService((GetName() + "/FILENAME_NIGHTLY").c_str(), "I:1;C", &fToDim, sizeof(int)+1,
                                                              "Path and base name which is used to compile the filenames for the nightly files."
                                                              "|Type[int]:type of open files (1=log, 2=rep, 4=fits)"
                                                              "|Name[string]:path and base file name");

                fOpenedRunFiles = new DimDescribedService((GetName() + "/FILENAME_RUN").c_str(), "I:1;C", &fToDim, sizeof(int)+1,
                                                              "Path and base name which is used to compile the filenames for the run files."
                                                              "|Type[int]:type of open files (1=log, 2=rep, 4=fits)"
                                                              "|Name[string]:path and base file name");

                fNumSubAndFitsData.numSubscriptions = 0;
                fNumSubAndFitsData.numOpenFits = 0;
                fNumSubAndFits = new DimDescribedService((GetName() + "/NUM_SUBS").c_str(), "I:2", &fNumSubAndFitsData, sizeof(NumSubAndFitsType),
                                                         "Shows number of services to which the data logger is currently subscribed and the total number of open files."
                                                         "|Subscriptions[int]:number of dim services to which the data logger is currently subscribed."
                                                         "|NumOpenFiles[int]:number of files currently open by the data logger");

                //black/white list
                fIsBlackList = true;
                fGreyList.clear();
        
                //services parameters
                fDebugIsOn = false;
                fStatsPeriodDuration = 1.0f;
                fOpenedFilesIsOn = true;
                fNumSubAndFitsIsOn = true;

                //provide services control commands
                AddConfiguration(fDebugOnOff, "B:1", kSM_NightlyOpen, kSM_Logging, kSM_WaitingRun, kSM_Ready)
                    (boost::bind(&DataLogger::SetDebugOnOff, this, _1))
                    ("Switch debug mode on off. Debug mode prints ifnormation about every service written to a file."
                     "|Enable[bool]:Enable of disable debuig mode (yes/no).");

                AddConfiguration(fStatsPeriod, "F", kSM_NightlyOpen, kSM_Logging, kSM_WaitingRun, kSM_Ready)
                    (boost::bind(&DataLogger::SetStatsPeriod, this, _1))
                    ("Interval in which the data-logger statitistics service (STATS) is updated."
                     "Interval[s]:Floating point value in seconds.");

                AddConfiguration(fStartStopOpenedFiles, "B:1", kSM_NightlyOpen, kSM_Logging, kSM_WaitingRun, kSM_Ready)
                    (boost::bind(&DataLogger::SetOpenedFilesOnOff ,this, _1))
                    ("Can be used to switch the service off which distributes information about the open files.");

                AddConfiguration(fStartStopNumSubsAndFits, "B:1", kSM_NightlyOpen, kSM_Logging, kSM_WaitingRun, kSM_Ready)
                    (boost::bind(&DataLogger::SetNumSubsAndFitsOnOff, this, _1))
                    ("Can be used to switch the service off which distributes information about the number of subscriptions and open files.");

                fDestructing = false;
                if(fDebugIsOn)
                {
                    Debug("DataLogger Init Done.");
                }
}
// --------------------------------------------------------------------------
//
//! Checks for changes in the existing services.
//! Any new service will be added to the service list, while the ones which disappeared are removed.
//! @todo
//!     add the configuration (using the conf class ?)
//
//FIXME The service must be udpated so that I get the first notification. This should not be
bool DataLogger::CheckForServicesUpdate()
{ 
        bool serviceUpdated = false;
        //get the current server list
        const std::vector<std::string> serverList = fServiceList.GetServerList();
        //first let's remove the servers that may have disapeared
        //can't treat the erase on maps the same way as for vectors. Do it the safe way instead
        std::vector<std::string> toBeDeleted;
        for (SubscriptionsListType::iterator cListe = fServiceSubscriptions.begin(); cListe != fServiceSubscriptions.end(); cListe++)
        {
                std::vector<std::string>::const_iterator givenServers;
                for (givenServers=serverList.begin(); givenServers!= serverList.end(); givenServers++)
                        if (cListe->first == *givenServers)
                                break;
                if (givenServers == serverList.end())//server vanished. Remove it
                {       
                        toBeDeleted.push_back(cListe->first);
                        serviceUpdated = true;
                }
                        
        } 
        for (std::vector<std::string>::const_iterator it = toBeDeleted.begin(); it != toBeDeleted.end(); it++)
                fServiceSubscriptions.erase(*it);
        //now crawl through the list of servers, and see if there was some updates
        for (std::vector<std::string>::const_iterator i=serverList.begin(); i!=serverList.end();i++)
        {
                //skip the two de-fact excluded services
                //Dim crashes if the publisher subscribes to its own service. This sounds weird, I agree.
                if ((i->find("DIS_DNS") != std::string::npos) ||
                    (i->find("DATA_LOGGER") != std::string::npos))
                        continue;
                if (fIsBlackList && (fGreyList.find(*i) != fGreyList.end()))
                        continue;
                //find the current server in our subscription list      
                SubscriptionsListType::iterator cSubs = fServiceSubscriptions.find(*i);
                //get the service list of the current server
                std::vector<std::string> cServicesList = fServiceList.GetServiceList(*i);
                if (cSubs != fServiceSubscriptions.end())//if the current server already is in our subscriptions
                {                                                                                //then check and update our list of subscriptions
                        //first, remove the services that may have dissapeared.
                        std::map<std::string, SubscriptionType>::iterator serverSubs;
                        std::vector<std::string>::const_iterator givenSubs;
                        toBeDeleted.clear();
                        for (serverSubs=cSubs->second.begin(); serverSubs != cSubs->second.end(); serverSubs++)
                        {
                                for (givenSubs = cServicesList.begin(); givenSubs != cServicesList.end(); givenSubs++)
                                        if (serverSubs->first == *givenSubs)
                                                break;
                                if (givenSubs == cServicesList.end())
                                {
                                        toBeDeleted.push_back(serverSubs->first);
                                        serviceUpdated = true;
                                }       
                        }
                        for (std::vector<std::string>::const_iterator it = toBeDeleted.begin(); it != toBeDeleted.end(); it++)
                                cSubs->second.erase(*it);
                        //now check for new services
                        for (givenSubs = cServicesList.begin(); givenSubs != cServicesList.end(); givenSubs++)
                        {
                                if (*givenSubs == "SERVICE_LIST")
                                        continue;
                                if (fIsBlackList && fGreyList.find(*givenSubs) != fGreyList.end())
                                        continue;

                                if (fIsBlackList && fGreyList.find((*i) + "/" + (*givenSubs)) != fGreyList.end())
                                        continue;
                                else if (!fIsBlackList && 
                                        (fGreyList.find((*i) + "/" + (*givenSubs)) == fGreyList.end()) &&
                                        (fGreyList.find(*i) == fGreyList.end()) &&
                                        (fGreyList.find(*givenSubs) == fGreyList.end()))
                                                continue;
                                if (cSubs->second.find(*givenSubs) == cSubs->second.end())
                                {//service not found. Add it
                                        cSubs->second[*givenSubs].dimInfo = new DimStampedInfo(((*i) + "/" + *givenSubs).c_str(), const_cast<char*>(""), this);
                                        serviceUpdated = true;
                                        if(fDebugIsOn)
                                        {
                                                stringstream str;
                                                str << "Subscribing to service " << *i << "/" << *givenSubs;
                                                Debug(str.str());       
                                        }
                                }       
                        }
                }
                else //server not found in our list. Create its entry
                {
                        fServiceSubscriptions[*i] = std::map<std::string, SubscriptionType>();
                        std::map<std::string, SubscriptionType>& liste = fServiceSubscriptions[*i];
                        for (std::vector<std::string>::const_iterator j = cServicesList.begin(); j!= cServicesList.end(); j++)
                        {
                                if (*j == "SERVICE_LIST")
                                        continue;
                                if (fIsBlackList && fGreyList.find(*j) != fGreyList.end())
                                        continue;

                                if (fIsBlackList && fGreyList.find((*i) + "/" + (*j)) != fGreyList.end())
                                        continue;
                                else if (!fIsBlackList && 
                                        (fGreyList.find((*i) + "/" + (*j)) == fGreyList.end()) &&
                                        (fGreyList.find(*i) == fGreyList.end()) &&
                                        (fGreyList.find(*j) == fGreyList.end()))
                                                continue;
                                        
                                liste[*j].dimInfo = new DimStampedInfo(((*i) + "/" + (*j)).c_str(), const_cast<char*>(""), this);
                                serviceUpdated = true;
                                if(fDebugIsOn)
                                {
                                        stringstream str;
                                        str << "Subscribing to service " << *i << "/" << *j;
                                        Debug(str.str());       
                                }
                        }
                }       
        }
        return serviceUpdated;
}
// --------------------------------------------------------------------------
//
//! Destructor
//
DataLogger::~DataLogger()
{
        if (fDebugIsOn)
        {
                Debug("DataLogger destruction starts"); 
        }
        fDestructing = true;
        //first let's go to the ready state
        //TODO some closing done below has already been executed by GoToReady. figure out what should be removed.
        GoToReadyPlease(); 
        //release the services subscriptions
        fServiceSubscriptions.clear();
        //exit the monitoring loop
        fContinueMonitoring = false;
//      delete[] fDimBuffer;
        fMonitoringThread.join();
        //close the files
        if (fNightlyLogFile.is_open())
                fNightlyLogFile.close();
        if (fNightlyReportFile.is_open())
                fNightlyReportFile.close();
        if (fRunLogFile.is_open())
                fRunLogFile.close();
        if (fRunReportFile.is_open())
                fRunReportFile.close();
        delete fOpenedNightlyFiles;
        delete fOpenedRunFiles;
        delete fNumSubAndFits;
//TODO notify that all files were closed
#ifdef HAS_FITS
#ifdef ONE_RUN_FITS_ONLY
        if (fRunFitsFile != NULL)
                delete fRunFitsFile;
        fRunFitsFile = NULL;
#endif
#endif
        if (fDebugIsOn)
        {
                Debug("DataLogger desctruction ends");  
        }
}

// --------------------------------------------------------------------------
//
//! Inherited from DimInfo. Handles all the Infos to which we subscribed, and log them
//
void DataLogger::infoHandler()
{
    // Make sure getTimestamp is called _before_ getTimestampMillisecs
        if (fDestructing)
                return;

        DimInfo* I = getInfo();
        SubscriptionsListType::iterator x;
        std::map<std::string, SubscriptionType>::iterator y;
        if (I==NULL)
        {
                if (CheckForServicesUpdate())
                {
                        //services were updated. Notify
                        fNumSubAndFitsData.numSubscriptions = 0;
                        for (x=fServiceSubscriptions.begin(); x != fServiceSubscriptions.end(); x++)
                                fNumSubAndFitsData.numSubscriptions += x->second.size();
                        if (fNumSubAndFitsIsOn)
                        {
                                if (fDebugIsOn)
                                {
                                        stringstream str;
                                        str << "Updating number of subscriptions service: Num Subs=" << fNumSubAndFitsData.numSubscriptions << " Num open FITS=" << fNumSubAndFitsData.numOpenFits;
                                        Debug(str.str());       
                                }
                                fNumSubAndFits->updateService();
                        }
                }
                return;
        }
        //check if the service pointer corresponds to something that we subscribed to
        //this is a fix for a bug that provides bad Infos when a server starts
        bool found = false;
        for (x=fServiceSubscriptions.begin(); x != fServiceSubscriptions.end(); x++)
        {//find current service is subscriptions
                for (y=x->second.begin(); y!=x->second.end();y++)
                        if (y->second.dimInfo == I)
                        {
                                found = true;   
                                break;
                        }
                if (found)
                        break;
        }
        if (!found)
                return;
        if (I->getSize() <= 0)
                return;

        // Make sure that getTimestampMillisecs is NEVER called before
        // getTimestamp is properly called
        // check that the message has been updated by something, i.e. must be different from its initial value
        if (I->getTimestamp() == 0)
                return;

        CheckForRunNumber(I);
        ReportPlease(I, y->second);

}

// --------------------------------------------------------------------------
//
//! Checks whether or not the current info is a run number.
//! If so, then remember it. A run number is required to open the run-log file
//! @param I
//!             the current DimInfo
//
void DataLogger::CheckForRunNumber(DimInfo* I)
{
        if (strstr(I->getName(), fRunNumberInfo) != NULL)
        {//assumes that the run number is an integer
                //TODO check the format here
                fRunNumber = I->getInt();       
                stringstream str;
                str << "New run number is " << fRunNumber;
                Message(str.str());
        }
}

// --------------------------------------------------------------------------
//
//! write infos to log files.
//! @param I
//!     The current DimInfo 
//
void DataLogger::ReportPlease(DimInfo* I, SubscriptionType& sub)
{
        //should we log or report this info ? (i.e. is it a message ?)
        bool isItaReport = ((strstr(I->getName(), "Message") == NULL) && (strstr(I->getName(), "MESSAGE") == NULL));
        if (I->getFormat()[0] == 'C')
                isItaReport = false;
        //TODO add service exclusion
        
        if (!fNightlyReportFile.is_open())
                return;

        //create the converter for that service
        if (sub.fConv == NULL && isItaReport)
        {
                //trick the converter in case of 'C'. why do I do this ? well simple: the converter checks that the right number
                //of bytes was written. because I skip 'C' with fits, the bytes will not be allocated, hence the "size copied ckeck"
                //of the converter will fail, hence throwing an exception.
                std::string fakeFormat(I->getFormat());
                if (fakeFormat[fakeFormat.size()-1] == 'C')
                        fakeFormat = fakeFormat.substr(0, fakeFormat.size()-1);
                sub.fConv = new Converter(Out(), I->getFormat());       
                if (!sub.fConv)
                {
                        std::stringstream str;
                        str << "Couldn't properly parse the format... service " << sub.dimInfo->getName() << " ignored.";
                        Error(str);
                        return; 
                }
        }
                
        //construct the header
        std::stringstream header;
        Time cTime(I->getTimestamp(), I->getTimestampMillisecs()*1000);
        fQuality = I->getQuality();
        fMjD = cTime.Mjd();

        if (isItaReport)
        {
                //write text header
                header << I->getName() << " " << fQuality << " ";
                header << cTime.Y() << " " << cTime.M() << " " << cTime.D() << " ";
                header << cTime.h() << " " << cTime.m() << " " << cTime.s() << " ";
                header << cTime.ms() << " " << I->getTimestamp() << " ";

                std::string text;
        try
        {
                text = sub.fConv->GetString(I->getData(), I->getSize());
        }
        catch (const std::runtime_error &e)
        {
                Out() << kRed << e.what() << endl;
                std::stringstream str;
                str << "Could not properly parse the data for service " << sub.dimInfo->getName();
                str << " reason: " << e.what() << ". Entry ignored";
            Error(str);
            return;
        }

                if (text.empty())
                {
                        std::stringstream str;
                        str << "Service " << sub.dimInfo->getName() << " sent an empty string";
                        Info(str);
                return;
                }
        //replace bizarre characters by white space
        replace(text.begin(), text.end(), '\n', '\\');
        replace_if(text.begin(), text.end(), std::ptr_fun<int, int>(&std::iscntrl), ' ');
        
        //write entry to Nightly report
                if (fNightlyReportFile.is_open())
                {
                        if (fDebugIsOn)
                        {
                                stringstream str;
                                str << "Writing: \"" << header.str() << text << "\" to Nightly report file";
                                Debug(str.str());       
                        }
                        fNightlyReportFile << header.str() << text << std::endl;
                        //check if either eof, bailbit or batbit are set
                        if (!fNightlyReportFile.good())
                        {
                                Error("An error occured while writing to the nightly report file. Closing it");
                                if (fNightlyReportFile.is_open())
                                        fNightlyReportFile.close();
                        }
                }
                //write entry to run-report
                if (fRunReportFile.is_open())
                {
                        if (fDebugIsOn)
                        {
                                stringstream str;
                                str << "Writing: \"" << header.str() << text << "\" to Run report file";
                                Debug(str.str());       
                        }
                        fRunReportFile << header.str() << text << std::endl;
                        if (!fRunReportFile.good())
                        {
                                Error("An error occured while writing to the run report file. Closing it.");
                                if (fRunReportFile.is_open())
                                        fRunReportFile.close(); 
                        }
                }
        }
        else
        {//write entry to both Nightly and run logs
                std::string n = I->getName();
                std::stringstream msg;
                msg << n.substr(0, n.find_first_of('/')) << ": " << I->getString();

                if (fNightlyLogFile.is_open())
                {
                        if (fDebugIsOn)
                        {
                                stringstream str;
                                str << "Writing: \"" << msg.str() << "\" to Nightly log file";
                                Debug(str.str());       
                        }
                        MessageImp nightlyMess(fNightlyLogFile);
                        nightlyMess.Write(cTime, msg.str().c_str(), fQuality);
                        if (!fNightlyLogFile.good())
                        {
                                Error("An error occured while writing to the nightly log file. Closing it.");
                                if (fNightlyLogFile.is_open())
                                        fNightlyLogFile.close();        
                        }
                }
                if (fRunLogFile.is_open())
                {
                        if (fDebugIsOn)
                        {
                                stringstream str;
                                str << "Writing: \"" << msg.str() << "\" to Run log file";
                                Debug(str.str());       
                        }
                        MessageImp runMess(fRunLogFile);
                        runMess.Write(cTime, msg.str().c_str(), fQuality);
                        if (!fRunLogFile.good())
                        {
                                Error("An error occured while writing to the run log file. Closing it.");
                                if (fRunLogFile.is_open())
                                        fRunLogFile.close();    
                        }
                }
        }

#ifdef HAS_FITS
        if (isItaReport)
        {
                if (!sub.nightlyFile.IsOpen() || !sub.runFile.IsOpen())
                        OpenFITSFilesPlease(sub);       
                WriteToFITS(sub);
        }       
#endif

}

// --------------------------------------------------------------------------
//
//! write messages to logs. 
//! @param evt
//!             the current event to log
//! @returns 
//!             the new state. Currently, always the current state
//!
//! @deprecated
//!    I guess that this function should not be any longer
//
//TODO isn't that function not used any longer ? If so I guess that we should get rid of it...
//Otherwise re-write it properly with the MessageImp class
int DataLogger::LogMessagePlease(const Event& evt)
{
        if (!fNightlyLogFile.is_open())
                return GetCurrentState();
        
        std::stringstream header;
        const Time& cTime = evt.GetTime();
        header << evt.GetName() << " " << cTime.Y() << " " << cTime.M() << " " << cTime.D() << " ";
        header << cTime.h() << " " << cTime.m() << " " << cTime.s() << " ";
        header << cTime.ms() << " ";
                
    const Converter conv(Out(), evt.GetFormat());
    if (!conv)
    {
        Error("Couldn't properly parse the format... ignored.");
        return GetCurrentState();
    }

    std::string text;
    try
    {
        text = conv.GetString(evt.GetData(), evt.GetSize());
    }
    catch (const std::runtime_error &e)
    {
        Out() << kRed << e.what() << endl;
        Error("Couldn't properly parse the data... ignored.");
        return GetCurrentState();
    }

        if (text.empty())
        return GetCurrentState();

    //replace bizarre characters by white space
    replace(text.begin(), text.end(), '\n', '\\');
    replace_if(text.begin(), text.end(), std::ptr_fun<int, int>(&std::iscntrl), ' ');
        if (fDebugIsOn)
        {
                stringstream str;
                str << "Logging: \"" << header << text << "\"";
                Debug(str.str());       
        }
        
        if (fNightlyLogFile.is_open())
        {
                fNightlyLogFile << header;
                if (!fNightlyLogFile.good())
                {
                        Error("An error occured while writing to the run log file. Closing it.");
                        if (fNightlyLogFile.is_open())
                                fNightlyLogFile.close();        
                }
        }
        if (fRunLogFile.is_open())
        {
                fRunLogFile << header;
                if (!fRunLogFile.good())
                {
                        Error("An error occured while writing to the run log file. Closing it.");
                        if (fRunLogFile.is_open())
                                fRunLogFile.close();    
                }
        }
        if (fNightlyLogFile.is_open())
        {
                fNightlyLogFile << text;
                if (!fNightlyLogFile.good())
                {
                        Error("An error occured while writing to the run log file. Closing it.");
                        if (fNightlyLogFile.is_open())
                                fNightlyLogFile.close();        
                }
        }
        if (fRunLogFile.is_open())
        {
                fRunLogFile << text;
                if (!fRunLogFile.good())
                {
                        Error("An error occured while writing to the run log file. Closing it.");
                        if (fRunLogFile.is_open())
                                fRunLogFile.close();    
                }
        }
        return GetCurrentState();
}
// --------------------------------------------------------------------------
//
//! print the dataLogger's current state. invoked by the PRINT command
//! @param evt
//!             the current event. Not used by the method
//! @returns 
//!             the new state. Which, in that case, is the current state
//!
int DataLogger::PrintStatePlease(const Event& )
{
        Message("-----------------------------------------");
        Message("------DATA LOGGER CURRENT STATE----------");
        Message("-----------------------------------------");
        //print the path configuration
        std::string actualTargetDir;
        if (fNightlyFileName == ".")
        {
            char currentPath[FILENAME_MAX];
            if (getcwd(currentPath, sizeof(currentPath)))
                actualTargetDir = currentPath;
        }
        else
                actualTargetDir = fNightlyFileName;
        Message("Nightly Path: " + actualTargetDir);
        if (fRunFileName == ".")
        {
            char currentPath[FILENAME_MAX];
            if (getcwd(currentPath, sizeof(currentPath)))
                actualTargetDir = currentPath;
        }
        else
                actualTargetDir = fRunFileName;
        Message("Run Path: " + actualTargetDir);
        stringstream str;
        str << "Run Number: " << fRunFileName;
        Message(str.str());
        Message("-----------OPENED FILES------------------");
        //print all the open files. 
        if (fNightlyLogFile.is_open())
                Message("Nightly Log..........OPEN");
        else
                Message("Nightly log........CLOSED");
        if (fNightlyReportFile.is_open())
                Message("Nightly Report.......OPEN");
        else
                Message("Nightly Report.....CLOSED");
        if (fRunLogFile.is_open())
                Message("Run Log..............OPEN");
        else
                Message("Run Log............CLOSED");
        if (fRunReportFile.is_open())
                Message("Run Report...........OPEN");
        else
                Message("Run Report.........CLOSED");
#ifdef HAS_FITS
        str.str("");
        str << "There are " << fNumSubAndFitsData.numOpenFits << " FITS files open:";
        Message(str.str());
        SubscriptionsListType::iterator x;
        std::map<std::string, SubscriptionType>::iterator y;
        bool runFileDone = false;
        for (x=fServiceSubscriptions.begin(); x != fServiceSubscriptions.end(); x++)
        {
                for (y=x->second.begin(); y != x->second.end(); y++)
                {
                        if (y->second.runFile.IsOpen() && !runFileDone)
                        {
                                        fFileSizesMap[y->second.runFile.fFileName] = y->second.runFile.GetWrittenSize();
                                        Message("-> "+y->second.runFile.fFileName);
#ifdef ONE_FITS_ONLY
                                        runFileDone = true;
#endif
                        }
                        if (y->second.nightlyFile.IsOpen())
                        {
                                fFileSizesMap[y->second.nightlyFile.fFileName] = y->second.nightlyFile.GetWrittenSize();
                                Message("-> "+y->second.nightlyFile.fFileName);
                        }
                }
        }
#else
        Message("FITS output disabled at compilation");
#endif
        struct stat st;
        DataLoggerStats statVar;
        //gather log and report files sizes on disk
        if (fNightlyLogFile.is_open())
        {
                stat(fFullNightlyLogFileName.c_str(), &st);
                fFileSizesMap[fFullNightlyLogFileName] = st.st_size;    
        }
        if (fNightlyReportFile.is_open())
        {
                stat(fFullNightlyReportFileName.c_str(), &st);
                fFileSizesMap[fFullNightlyReportFileName] = st.st_size; 
        }
        if (fRunLogFile.is_open())
        {
                stat(fFullRunLogFileName.c_str(), &st);
                fFileSizesMap[fFullRunLogFileName] = st.st_size;        
        }
        if (fRunReportFile.is_open())
        {
                stat(fFullRunReportFileName.c_str(), &st);
                fFileSizesMap[fFullRunReportFileName] = st.st_size;
        }       
        struct statvfs vfs;
        if (!statvfs(fNightlyFileName.c_str(), &vfs))
        {
                statVar.freeSpace = vfs.f_bsize*vfs.f_bavail;
        }
        else
        {
                str.str("");
                str << "Unable to retrieve stats for " << fNightlyFileName << ". Reason: " << strerror(errno) << " [" << errno << "]";
                Error(str);;
                statVar.freeSpace = -1;
        }
        
        //sum up all the file sizes. past and present
        statVar.sizeWritten = 0;
        for (std::map<std::string, long>::iterator it=fFileSizesMap.begin(); it != fFileSizesMap.end();  it++)
                statVar.sizeWritten += it->second;
        statVar.sizeWritten -= fBaseSizeNightly;
        statVar.sizeWritten -= fBaseSizeRun;
        Message("-----------------STATS-------------------");
        str.str("");
        str << "Total Size written: " << statVar.sizeWritten << " bytes.";
        Message(str.str());
        str.str("");
        str << "Disk free space:    " << statVar.freeSpace   << " bytes.";
        Message(str.str());

        Message("------------DIM SUBSCRIPTIONS------------");

        str.str("");
        str << "There are " << fNumSubAndFitsData.numSubscriptions << " active DIM subscriptions:";
        Message(str.str());

        for (std::map<const std::string, std::map<std::string, SubscriptionType>>::const_iterator it=fServiceSubscriptions.begin(); it!= fServiceSubscriptions.end();it++)
        {
                Message("Server "+it->first);
                for (std::map<std::string, SubscriptionType>::const_iterator it2=it->second.begin(); it2!=it->second.end(); it2++)
                        Message("-> "+it2->first);
        }
        Message("-----------------------------------------");
        
        return GetCurrentState();
}

// --------------------------------------------------------------------------
//
//! turn debug mode on and off
//! @param evt
//!             the current event. contains the instruction string: On, Off, on, off, ON, OFF, 0 or 1
//! @returns 
//!             the new state. Which, in that case, is the current state
//!
int DataLogger::SetDebugOnOff(const Event& evt)
{
        bool backupDebug = fDebugIsOn;
        fDebugIsOn = evt.GetBool();
        if (fDebugIsOn == backupDebug)
                Warn("Warning: debug mode was already in the requested state");
        else
        {
                stringstream str;
                str << "Debug mode is now " << fDebugIsOn;
                Message(str.str());
        }
        return GetCurrentState();
}
// --------------------------------------------------------------------------
//
//! set the statistics update period duration. 0 disables the statistics
//! @param evt
//!             the current event. contains the new duration.
//! @returns 
//!             the new state. Which, in that case, is the current state
//!
int DataLogger::SetStatsPeriod(const Event& evt)
{
        float backupDuration = fStatsPeriodDuration;
        fStatsPeriodDuration = evt.GetFloat();
        if (fStatsPeriodDuration < 0)
        {
                Error("Statistics period duration should be greater than zero. Discarding provided value.");
                fStatsPeriodDuration = backupDuration;
                return GetCurrentState();       
        }
        if (fStatsPeriodDuration != fStatsPeriodDuration)
        {
                Error("Provided duration does not appear to be a valid float. discarding it.");
                fStatsPeriodDuration = backupDuration;
                return GetCurrentState();       
        }
        if (backupDuration == fStatsPeriodDuration)
                Warn("Warning: statistics period was not modified: supplied value already in use");
        else
        {
                if (fStatsPeriodDuration == 0.0f)
                        Message("Statistics are now OFF");
                else
                {
                        stringstream str;
                        str << "Statistics period is now " << fStatsPeriodDuration << " seconds";
                        Message(str.str());     
                }       
        }
        return GetCurrentState();
}
// --------------------------------------------------------------------------
//
//! set the opened files service on or off. 
//! @param evt
//!             the current event. contains the instruction string. similar to setdebugonoff
//! @returns 
//!             the new state. Which, in that case, is the current state
//!
int DataLogger::SetOpenedFilesOnOff(const Event& evt)
{
        bool backupOpened = fOpenedFilesIsOn;
        fOpenedFilesIsOn = evt.GetBool();
        if (fOpenedFilesIsOn == backupOpened)
                Warn("Warning: opened files service mode was already in the requested state");
        else
        {
                stringstream str;
                str << "Opened files service mode is now " << fOpenedFilesIsOn;
                Message(str.str());
        }
        return GetCurrentState();
        
}
// --------------------------------------------------------------------------
//
//! set the number of subscriptions and opened fits on and off
//! @param evt
//!             the current event. contains the instruction string. similar to setdebugonoff
//! @returns 
//!             the new state. Which, in that case, is the current state
//!
int DataLogger::SetNumSubsAndFitsOnOff(const Event& evt)
{
        bool backupSubs = fNumSubAndFitsIsOn;
        fNumSubAndFitsIsOn = evt.GetBool();
        if (fNumSubAndFitsIsOn == backupSubs)
                Warn("Warning: Number of subscriptions service mode was already in the requested state");
        else
        {
                stringstream str;
                str << "Number of subscriptions service mode is now " << fNumSubAndFitsIsOn;
                Message(str.str());
        }
        return GetCurrentState();
}
// --------------------------------------------------------------------------
//
//!     Sets the path to use for the Nightly log file.
//! @param evt
//!     the event transporting the path
//! @returns
//!             currently only the current state.
//
int DataLogger::ConfigureNightlyFileName(const Event& evt)
{
        if (evt.GetText() != NULL)
        {
                fNightlyFileName = std::string(evt.GetText());  
                Message("New Nightly folder specified: " + fNightlyFileName);
        }
        else
                Error("Empty Nightly folder given. Please specify a valid path.");

        return GetCurrentState();
}
// --------------------------------------------------------------------------
//
//! Sets the path to use for the run log file.
//! @param evt
//!             the event transporting the path
//! @returns
//!     currently only the current state
int DataLogger::ConfigureRunFileName(const Event& evt)
{
        if (evt.GetText() != NULL)
        {
                fRunFileName = std::string(evt.GetText());
                Message("New Run folder specified: " + fRunFileName);
        }
        else
                Error("Empty Nightly folder given. Please specify a valid path");

        return GetCurrentState();
}
// --------------------------------------------------------------------------
//
//! Sets the run number.
//! @param evt
//!             the event transporting the run number
//! @returns
//!     currently only the current state
//TODO remove this function as the run numbers will be distributed through a dedicated service
int DataLogger::ConfigureRunNumber(const Event& evt)
{
        fRunNumber = evt.GetInt();
        std::stringstream str;
        str << "The new run number is: " << fRunNumber;
        Message(str.str());
        return GetCurrentState();
}
// --------------------------------------------------------------------------
//
//! Notifies the DIM service that a particular file was opened
//! @ param name the base name of the opened file, i.e. without path nor extension. 
//!     WARNING: use string instead of string& because I pass values that do not convert to string&.
//!             this is not a problem though because file are not opened so often.
//! @ param type the type of the opened file. 0 = none open, 1 = log, 2 = text, 4 = fits
inline void DataLogger::NotifyOpenedFile(std::string name, int type, DimDescribedService* service)
{
        if (fOpenedFilesIsOn)
        {
                if (fDebugIsOn)
                {
                        stringstream str;
                        str << "Updating files service " << service->getName() << "with code: " << type << " and file: " << name;
                        Debug(str.str());
                        str.str("");
                        str << "Num subs: " << fNumSubAndFitsData.numSubscriptions << " Num open FITS: " << fNumSubAndFitsData.numOpenFits;
                        Debug(str.str());
                }
                OpenFileToDim fToDim;
                fToDim.code = type;
                memcpy(fToDim.fileName, name.c_str(), name.size()+1);
                service->setData(reinterpret_cast<void*>(&fToDim), name.size()+1+sizeof(int));
                service->setQuality(0);
                service->updateService();
        }
}
// --------------------------------------------------------------------------
//
//! Implements the Start transition.
//! Concatenates the given path for the Nightly file and the filename itself (based on the day), 
//! and tries to open it.
//! @returns 
//!             kSM_NightlyOpen if success, kSM_BadNightlyConfig if failure
int DataLogger::StartPlease()
{
        if (fDebugIsOn)
        {
                Debug("Starting...");   
        }
        Time time;
        std::stringstream sTime;
        sTime << time.Y() << "_" << time.M() << "_" << time.D();

        fFullNightlyLogFileName = fNightlyFileName + '/' + sTime.str() + ".log"; 
        fNightlyLogFile.open(fFullNightlyLogFileName.c_str(), std::ios_base::out | std::ios_base::app); 
        if (errno != 0)
        {
                std::stringstream str;
                str << "Unable to open Nightly Log " << fFullNightlyLogFileName << ". Reason: " << strerror(errno) << " [" << errno << "]";
                Error(str);     
        }
        fFullNightlyReportFileName = fNightlyFileName + '/' + sTime.str() + ".rep";
        fNightlyReportFile.open(fFullNightlyReportFileName.c_str(), std::ios_base::out | std::ios_base::app);
        if (errno != 0)
        {
                std::stringstream str;
                str << "Unable to open Nightly Report " << fFullNightlyReportFileName << ". Reason: " << strerror(errno) << " [" << errno << "]";
                Error(str);     
        }

        if (!fNightlyLogFile.is_open() || !fNightlyReportFile.is_open())
        {       
                //TODO send an error message    
            return kSM_BadNightlyConfig;
        }
        //get the size of the newly opened file.
        struct stat st;
        stat(fFullNightlyLogFileName.c_str(), &st);
        fBaseSizeNightly = st.st_size;  
        stat(fFullNightlyReportFileName.c_str(), &st);
        fBaseSizeNightly += st.st_size;
        fFileSizesMap.clear();
        fBaseSizeRun = 0;
        fPreviousSize = 0;
        //notify that files were opened
        std::string actualTargetDir;
        if (fNightlyFileName == ".")
        {
                char currentPath[FILENAME_MAX];
                if (!getcwd(currentPath, sizeof(currentPath)))
                {
                    if (errno != 0)
                    {
                        std::stringstream str;
                        str << "Unable retrieve current path" << ". Reason: " << strerror(errno) << " [" << errno << "]";
                        Error(str);
                    }
                }
                actualTargetDir = currentPath;
        }
        else
        {
                actualTargetDir = fNightlyFileName;     
        }
        //notify that a new file has been opened.
        NotifyOpenedFile(actualTargetDir + '/' + sTime.str(), 3, fOpenedNightlyFiles);
        
        return kSM_NightlyOpen;         
}

#ifdef HAS_FITS
// --------------------------------------------------------------------------
//
//! open if required a the FITS files corresponding to a given subscription
//! @param sub
//!     the current DimInfo subscription being examined
void DataLogger::OpenFITSFilesPlease(SubscriptionType& sub)
{
        std::string serviceName(sub.dimInfo->getName());
        for (unsigned int i=0;i<serviceName.size(); i++)
        {
                if (serviceName[i] == '/')
                {
                        serviceName[i] = '_';
                        break;  
                }       
        }
        Time time;
        std::stringstream sTime;
        sTime << time.Y() << "_" << time.M() << "_" << time.D();
        //we open the NightlyFile anyway, otherwise this function shouldn't have been called.
        if (!sub.nightlyFile.IsOpen())
        {
                std::string partialName = fNightlyFileName + '/' + sTime.str() + '_' + serviceName + ".fits";
                AllocateFITSBuffers(sub);
                //get the size of the file we're about to open
                if (fFileSizesMap.find(partialName) == fFileSizesMap.end())
                {
                        struct stat st;
                        if (!stat(partialName.c_str(), &st))
                                fBaseSizeNightly += st.st_size;
                        fFileSizesMap[partialName] = 0;
                }
                sub.nightlyFile.Open(partialName, serviceName, NULL, &fNumSubAndFitsData.numOpenFits, Out());
                //notify the opening
                std::string actualTargetDir;
                if (fNightlyFileName == ".")
                {
                        char currentPath[FILENAME_MAX];
                        if (getcwd(currentPath, sizeof(currentPath)))
                            actualTargetDir = currentPath;
                }
                else
                {
                        actualTargetDir = fNightlyFileName;     
                }               
                NotifyOpenedFile(actualTargetDir + '/' + sTime.str(), 7, fOpenedNightlyFiles);
                if (fNumSubAndFitsIsOn)
                        fNumSubAndFits->updateService();
                if (fDebugIsOn)
                {
                        stringstream str;
                        str << "Opened Nightly FITS: " << partialName << " and table: FACT-" << serviceName << ".current number of opened FITS: " << fNumSubAndFitsData.numOpenFits;
                        Debug(str.str());       
                }
        }
        if (!sub.runFile.IsOpen() && (GetCurrentState() == kSM_Logging))
        {//buffer for the run file have already been allocated when doing the Nightly file
                std::stringstream sRun;
                sRun << fRunNumber;
#ifdef ONE_RUN_FITS_ONLY
                std::string partialName = fRunFileName + '/' + sRun.str() + ".fits";
                if (fRunFitsFile == NULL)
                {
#else
                std::string partialName = fRunFileName + '/' + sRun.str() + '_' + serviceName + ".fits";
#endif
                        //get the size of the file we're about to open
                        if (fFileSizesMap.find(partialName) == fFileSizesMap.end())
                        {
                                struct stat st;
                                if (!stat(partialName.c_str(), &st))
                                        fBaseSizeRun += st.st_size;
                                else
                                        fBaseSizeRun = 0;
                                fFileSizesMap[partialName] = 0; 
                        }
#ifdef ONE_RUN_FITS_ONLY
                        try
                        {
                                fRunFitsFile = new FITS(partialName, RWmode::Write);    
                                (fNumSubAndFitsData.numOpenFits)++;
                        }       
                        catch (CCfits::FitsError e)
                        {
                                std::stringstream str;
                                str << "Could not open FITS Run file " << partialName << " reason: " << e.message();
                                Error(str);
                                fRunFitsFile = NULL;
                        }
#endif
                        std::string actualTargetDir;
                        if (fRunFileName == ".")
                        {
                                char currentPath[FILENAME_MAX];
                                if (getcwd(currentPath, sizeof(currentPath)))
                                    actualTargetDir = currentPath;
                        }
                        else
                        {
                                actualTargetDir = fRunFileName; 
                        }               
                        NotifyOpenedFile(actualTargetDir + '/' + sRun.str(), 7, fOpenedRunFiles);// + '_' + serviceName, 4);
#ifdef ONE_RUN_FITS_ONLY
                }
                sub.runFile.Open(partialName, serviceName, fRunFitsFile, &fNumSubAndFitsData.numOpenFits, Out());
#else
                sub.runFile.Open(partialName, serviceName, NULL, &fNumSubAndFitsData.numOpenFits, Out());
#endif //one_run_fits_only
           if (fNumSubAndFitsIsOn)
                   fNumSubAndFits->updateService();
                if (fDebugIsOn)
                {
                        stringstream str;
                        str << "Opened Run FITS: " << partialName << " and table: FACT-" << serviceName << ".current number of opened FITS: " << fNumSubAndFitsData.numOpenFits;
                        Debug(str.str());       
                }
        }
}       
// --------------------------------------------------------------------------
//
void DataLogger::AllocateFITSBuffers(SubscriptionType& sub)
{
        int size = sub.dimInfo->getSize();
         
        //Init the time columns of the file
        Description dateDesc(std::string("Time"), std::string("Modified Julian Date"), std::string("MjD"));
        sub.nightlyFile.AddStandardColumn(dateDesc, "1D", &fMjD, sizeof(double));
        sub.runFile.AddStandardColumn(dateDesc, "1D", &fMjD, sizeof(double));

        Description QoSDesc("Qos", "Quality of service", "None");
        sub.nightlyFile.AddStandardColumn(QoSDesc, "1J", &fQuality, sizeof(int));
        sub.runFile.AddStandardColumn(QoSDesc, "1J", &fQuality, sizeof(int));

        const Converter::FormatList flist = sub.fConv->GetList();
    // Compilation failed
    if (flist.empty() || flist.back().first.second!=0)
    {
        Error("Compilation of format string failed.");
        return;
    }

        //we've got a nice structure describing the format of this service's messages.
        //Let's create the appropriate FITS columns
        std::vector<std::string> dataFormatsLocal;
        for (unsigned int i=0;i<flist.size()-1;i++)
        {
                std::stringstream dataQualifier; 

                dataQualifier << flist[i].second.first;
                switch (flist[i].first.first->name()[0])
                {//TODO handle all the data format cases
                        case 'c':
                        case 'C':
                                dataQualifier.str("S");
                        break;
                        case 's':
                                dataQualifier << "I";
                        break;
                        case 'i':
                        case 'I':
                                dataQualifier << "J";
                        break;
                        case 'l':
                        case 'L':
                                dataQualifier << "J";
                                //TODO triple check that in FITS, long = int
                        break;
                        case 'f':
                        case 'F':
                                dataQualifier << "E";
                        break;
                        case 'd':
                        case 'D':
                                dataQualifier << "D";
                        break;
                        case 'x':
                        case 'X':
                                dataQualifier << "K";
                        break;
                        case 'S':
                                //for strings, the number of elements I get is wrong. Correct it
                                dataQualifier.str(""); //clear
                                dataQualifier << size-1 <<  "A";
                                size = size-1;
                        break;
                        
                        default:
                                Error("THIS SHOULD NEVER BE REACHED. dataLogger.cc ln 1198.");
                };
                //we skip the variable length strings for now (in fits only)
                if (dataQualifier.str() != "S")
                        dataFormatsLocal.push_back(dataQualifier.str());
         }
         sub.nightlyFile.InitDataColumns(fServiceList.GetDescriptions(sub.dimInfo->getName()), dataFormatsLocal, sub.dimInfo->getData(), size);
         sub.runFile.InitDataColumns(fServiceList.GetDescriptions(sub.dimInfo->getName()), dataFormatsLocal, sub.dimInfo->getData(), size);
}
// --------------------------------------------------------------------------
//
//! write a dimInfo data to its corresponding FITS files
//
void DataLogger::WriteToFITS(SubscriptionType& sub)
{
                //nightly File status (open or not) already checked
                if (sub.nightlyFile.IsOpen())
                {
                        sub.nightlyFile.Write(sub.fConv);
                        if (fDebugIsOn)
                        {
                                Debug("Writing to nightly FITS " + sub.nightlyFile.fFileName);  
                        }
                }
                if (sub.runFile.IsOpen())
                {
                        sub.runFile.Write(sub.fConv);
                        if (fDebugIsOn)
                        {
                                Debug("Writing to Run FITS " + sub.runFile.fFileName);  
                        }
                }
}
#endif //if has_fits
// --------------------------------------------------------------------------
//
//! Implements the StartRun transition.
//! Concatenates the given path for the run file and the filename itself (based on the run number),
//! and tries to open it.
//! @returns
//!             kSM_Logging if success, kSM_BadRunConfig if failure.
int DataLogger::StartRunPlease()
{
        if (fDebugIsOn)
        {
                Debug("Starting Run Logging...");       
        }
        //attempt to open run file with current parameters
        if (fRunNumber == -1)
                return kSM_BadRunConfig;
        std::stringstream sRun;
        sRun << fRunNumber;
        fFullRunLogFileName = fRunFileName + '/' + sRun.str() + ".log";
        fRunLogFile.open(fFullRunLogFileName.c_str(), std::ios_base::out | std::ios_base::app); //maybe should be app instead of ate
        if (errno != 0)
        {
                std::stringstream str;
                str << "Unable to open run Log " << fFullRunLogFileName << ". Reason: " << strerror(errno) << " [" << errno << "]";
                Error(str);     
        }
        fFullRunReportFileName = fRunFileName + '/' + sRun.str() + ".rep";
        fRunReportFile.open(fFullRunReportFileName.c_str(), std::ios_base::out | std::ios_base::app);
        if (errno != 0)
        {
                std::stringstream str;
                str << "Unable to open run report " << fFullRunReportFileName << ". Reason: " << strerror(errno) << " [" << errno << "]";
                Error(str);     
        }
        
        if (!fRunLogFile.is_open() || !fRunReportFile.is_open())
        {
                //TODO send an error message
                return kSM_BadRunConfig;        
        }
        //get the size of the newly opened file.
        struct stat st;
        fBaseSizeRun = 0;
        if (fFileSizesMap.find(fFullRunLogFileName) == fFileSizesMap.end())
        {
                stat(fFullRunLogFileName.c_str(), &st);
                if (errno != 0)
                {
                        std::stringstream str;
                        str << "Unable to stat " << fFullRunLogFileName << ". Reason: " << strerror(errno) << " [" << errno << "]";
                        Error(str);     
                }
                else
                        fBaseSizeRun += st.st_size;
                fFileSizesMap[fFullRunLogFileName] = 0;
        }
        if (fFileSizesMap.find(fFullRunReportFileName) == fFileSizesMap.end())
        {
                stat(fFullRunReportFileName.c_str(), &st);
                if (errno != 0)
                {
                        std::stringstream str;
                        str << "Unable to stat " << fFullRunReportFileName << ". Reason: " << strerror(errno) << " [" << errno << "]";
                        Error(str);     
                }
                else
                        fBaseSizeRun += st.st_size;
                fFileSizesMap[fFullRunReportFileName] = 0;
        }
        std::string actualTargetDir;
        if (fRunFileName == ".")
        {
                char currentPath[FILENAME_MAX];
                if (!getcwd(currentPath, sizeof(currentPath)))
                {
                    if (errno != 0)
                    {
                        std::stringstream str;
                        str << "Unable to retrieve the current path" << ". Reason: " << strerror(errno) << " [" << errno << "]";
                        Error(str);
                    }
                }
                actualTargetDir = currentPath;
        }
        else
        {
                actualTargetDir = fRunFileName; 
        }               
        NotifyOpenedFile(actualTargetDir + '/' + sRun.str(), 3, fOpenedRunFiles);
        
        return kSM_Logging;
}
// --------------------------------------------------------------------------
//
//! Implements the StopRun transition.
//! Attempts to close the run file.
//! @returns
//!             kSM_WaitingRun if success, kSM_FatalError otherwise
int DataLogger::StopRunPlease()
{
        if (fDebugIsOn)
        {
                Debug("Stopping Run Logging...");       
        }
        if (!fRunLogFile.is_open() || !fRunReportFile.is_open())
                return kSM_FatalError;
        
        fRunLogFile.close();
        fRunReportFile.close();
#ifdef HAS_FITS
        for (SubscriptionsListType::iterator i = fServiceSubscriptions.begin(); i != fServiceSubscriptions.end(); i++)
                for (std::map<std::string, SubscriptionType>::iterator j = i->second.begin(); j != i->second.end(); j++)
                {
                                if (j->second.runFile.IsOpen())
                                        j->second.runFile.Close();      
                }
#ifdef ONE_RUN_FITS_ONLY
        if (fRunFitsFile != NULL)
        {
                delete fRunFitsFile;
                fRunFitsFile = NULL;    
                (fNumSubAndFitsData.numOpenFits)--;
        }
#endif
#endif
        NotifyOpenedFile("", 0, fOpenedRunFiles);
        if (fNumSubAndFitsIsOn)
                fNumSubAndFits->updateService();
        return kSM_WaitingRun;

}
// --------------------------------------------------------------------------
//
//! Implements the Stop and Reset transitions.
//! Attempts to close any openned file.
//! @returns
//!     kSM_Ready
int DataLogger::GoToReadyPlease()
{
        if (fDebugIsOn)
        {
                Debug("Going to the Ready state...");
        }       
        if (fNightlyLogFile.is_open())
                fNightlyLogFile.close();
        if (fNightlyReportFile.is_open())
                fNightlyReportFile.close();

        if (fRunLogFile.is_open())
                fRunLogFile.close();
        if (fRunReportFile.is_open())
                fRunReportFile.close();
                
#ifdef HAS_FITS
        for (SubscriptionsListType::iterator i = fServiceSubscriptions.begin(); i != fServiceSubscriptions.end(); i++)
                for (std::map<std::string, SubscriptionType>::iterator j = i->second.begin(); j != i->second.end(); j++)
                {
                                if (j->second.nightlyFile.IsOpen())
                                        j->second.nightlyFile.Close();
                                if (j->second.runFile.IsOpen())
                                        j->second.runFile.Close();      
                }
#ifdef ONE_RUN_FITS_ONLY
        if (fRunFitsFile != NULL)
        {
                delete fRunFitsFile;
                fRunFitsFile = NULL;
                (fNumSubAndFitsData.numOpenFits)--;
        }
#endif
#endif
        if (GetCurrentState() == kSM_Logging)
                NotifyOpenedFile("", 0, fOpenedRunFiles);
        if (GetCurrentState() == kSM_Logging || 
            GetCurrentState() == kSM_WaitingRun || 
            GetCurrentState() == kSM_NightlyOpen)
        { 
                NotifyOpenedFile("", 0, fOpenedNightlyFiles);
                if (fNumSubAndFitsIsOn)
                        fNumSubAndFits->updateService();
        }
        return kSM_Ready;
}
// --------------------------------------------------------------------------
//
//! Implements the transition towards kSM_WaitingRun
//! Does nothing really.
//!     @returns
//!             kSM_WaitingRun
int DataLogger::NightlyToWaitRunPlease()
{
        if (fDebugIsOn)
        {
                Debug("Going to Wait Run Number state...");     
        }
        return kSM_WaitingRun;  
}

void DataLogger::setBlackWhiteList(const std::string& black, bool isBlack)
{
        if (fDebugIsOn)
        {
                if (isBlack)
                        Debug("Setting BLACK list: " + black);  
                else
                        Debug("Setting WHITE list: " + black);
        }
        fGreyList.clear();
        stringstream stream(black);

        string buffer;
        while (getline(stream, buffer, '|')) {
                fGreyList.insert(buffer);       
        }
        fIsBlackList = isBlack;
}

// --------------------------------------------------------------------------

int RunDim(Configuration &conf)
{
    WindowLog wout;

    //log.SetWindow(stdscr);
    if (conf.Has("log"))
        if (!wout.OpenLogFile(conf.Get<std::string>("log")))
            wout << kRed << "ERROR - Couldn't open log-file " << conf.Get<std::string>("log") << ": " << strerror(errno) << std::endl;

    // Start io_service.Run to use the StateMachineImp::Run() loop
    // Start io_service.run to only use the commandHandler command detaching
    DataLogger logger(wout);
    logger.Run(true);

    return 0;
}

void RunThread(DataLogger* logger)
{
        // This is necessary so that the StateMachine Thread can signal the 
        // Readline thread to exit
        logger->Run(true);
        Readline::Stop();       
}

template<class T>
int RunShell(Configuration &conf)
{
    static T shell(conf.GetName().c_str(), conf.Get<int>("console")!=1);

    WindowLog &win  = shell.GetStreamIn();
    WindowLog &wout = shell.GetStreamOut();

    if (conf.Has("log"))
        if (!wout.OpenLogFile(conf.Get<std::string>("log")))
            win << kRed << "ERROR - Couldn't open log-file " << conf.Get<std::string>("log") << ": " << strerror(errno) << std::endl;

    DataLogger logger(wout);
    
    if (conf.Has("black-list"))
    {   if (conf.Get<std::string>("black-list") != "")
                logger.setBlackWhiteList(conf.Get<std::string>("black-list"), true);
            else if (conf.Has("white-list"))
                {
                        if (conf.Get<std::string>("white-list") != "")
                                logger.setBlackWhiteList(conf.Get<std::string>("white-list"), false);
                }
    }
    shell.SetReceiver(logger);

        boost::thread t(boost::bind(RunThread, &logger));
        
        shell.Run(); // Run the shell
        
        logger.Stop();
        
        //Wait until the StateMachine has finished its thread
        //before returning and destroyinng the dim objects which might 
        //still be in use.
        t.join();

    return 0;
}

/*
 Extract usage clause(s) [if any] for SYNOPSIS.
 Translators: "Usage" and "or" here are patterns (regular expressions) which
 are used to match the usage synopsis in program output.  An example from cp
 (GNU coreutils) which contains both strings:
  Usage: cp [OPTION]... [-T] SOURCE DEST
    or:  cp [OPTION]... SOURCE... DIRECTORY
    or:  cp [OPTION]... -t DIRECTORY SOURCE...
 */
void PrintUsage()
{
    cout << "\n"
        "The data logger connects to all available Dim services and "
        "writes them to ascii and fits files.\n"
        "\n"
        "Usage: dataLogger [-c type] [OPTIONS]\n"
        "  or:  dataLogger [OPTIONS]\n"
        "\n"
        "Options:\n"
        "The following describes the available commandline options. "
        "For further details on how command line option are parsed "
        "and in which order which configuration sources are accessed "
        "please refer to the class reference of the Configuration class.";
    cout << endl;

}

void PrintHelp()
{
    cout << "\n"
        "The default is that the program is started without user interaction. "
        "All actions are supposed to arrive as DimCommands. Using the -c "
        "option, a local shell can be initialized. With h or help a short "
        "help message about the usuage can be brought to the screen."
        << endl;
}

/*
 The first line of the --version information is assumed to be in one
 of the following formats:

   <version>
   <program> <version>
   {GNU,Free} <program> <version>
   <program> ({GNU,Free} <package>) <version>
   <program> - {GNU,Free} <package> <version>

 and separated from any copyright/author details by a blank line.

 Handle multi-line bug reporting sections of the form:

   Report <program> bugs to <addr>
   GNU <package> home page: <url>
   ...
*/
void PrintVersion(const char *name)
{
    cout <<
        name << " - "PACKAGE_STRING"\n"
        "\n"
        "Written by Thomas Bretz et al.\n"
        "\n"
        "Report bugs to <"PACKAGE_BUGREPORT">\n"
        "Home page: "PACKAGE_URL"\n"
        "\n"
        "Copyright (C) 2011 by the FACT Collaboration.\n"
        "This is free software; see the source for copying conditions.\n"
        << endl;
}


void SetupConfiguration(Configuration &conf)
{
    const string n = conf.GetName()+".log";

    po::options_description config("Program options");
    config.add_options()
        ("dns",       var<string>("localhost"),  "Dim nameserver host name (Overwites DIM_DNS_NODE environment variable)")
        ("log,l",     var<string>(n), "Write log-file")
        ("console,c", var<int>(),     "Use console (0=shell, 1=simple buffered, X=simple unbuffered)")
        ("black-list,b", var<string>(""), "Black-list of services")
        ("white-list,w", var<string>(""), "White-list of services")
        ;

    conf.AddEnv("dns", "DIM_DNS_NODE");

    conf.AddOptions(config);
}

int main(int argc, const char* argv[])
{
    Configuration conf(argv[0]);
    conf.SetPrintUsage(PrintUsage);
    SetupConfiguration(conf);

    po::variables_map vm;
    try
    {
        vm = conf.Parse(argc, argv);
    }
    catch (std::exception &e)
    {
#if BOOST_VERSION > 104000
        po::multiple_occurrences *MO = dynamic_cast<po::multiple_occurrences*>(&e);
        if (MO)
            cout << "Error: " << e.what() << " of '" << MO->get_option_name() << "' option." << endl;
        else
#endif
            cout << "Error: " << e.what() << endl;
        cout << endl;

        return -1;
    }

    if (conf.HasPrint())
        return -1;

    if (conf.HasVersion())
    {
        PrintVersion(argv[0]);
        return -1;
    }

    if (conf.HasHelp())
    {
        PrintHelp();
        return -1;
    }

    setenv("DIM_DNS_NODE", conf.Get<string>("dns").c_str(), 1);

    try
    {
        // No console access at all
        if (!conf.Has("console"))
            return RunDim(conf);

        // Console access w/ and w/o Dim
        if (conf.Get<int>("console")==0)
            return RunShell<LocalShell>(conf);
        else
            return RunShell<LocalConsole>(conf);
    }
    catch (std::exception& e)
    {
        cerr << "Exception: " << e.what() << endl;
        return -1;
    }

    return 0;
}