/*
** This file is part of the ViTE project.
**
** This software is governed by the CeCILL-A license under French law
** and abiding by the rules of distribution of free software. You can
** use, modify and/or redistribute the software under the terms of the
** CeCILL-A license as circulated by CEA, CNRS and INRIA at the following
** URL: "http://www.cecill.info".
** 
** As a counterpart to the access to the source code and rights to copy,
** modify and redistribute granted by the license, users are provided
** only with a limited warranty and the software's author, the holder of
** the economic rights, and the successive licensors have only limited
** liability.
** 
** In this respect, the user's attention is drawn to the risks associated
** with loading, using, modifying and/or developing or reproducing the
** software by the user in light of its specific status of free software,
** that may mean that it is complicated to manipulate, and that also
** therefore means that it is reserved for developers and experienced
** professionals having in-depth computer knowledge. Users are therefore
** encouraged to load and test the software's suitability as regards
** their requirements in conditions enabling the security of their
** systems and/or data to be ensured and, more generally, to use and
** operate it in the same conditions as regards security.
** 
** The fact that you are presently reading this means that you have had
** knowledge of the CeCILL-A license and that you accept its terms.
**
**
** ViTE developers are (for version 0.* to 1.0):
**
**        - COULOMB Kevin
**        - FAVERGE Mathieu
**        - JAZEIX Johnny
**        - LAGRASSE Olivier
**        - MARCOUEILLE Jule
**        - NOISETTE Pascal
**        - REDONDY Arthur
**        - VUCHENER Clément 
**
*/
/*!
 * \file ParserTau.hpp
 * \brief the implementation of Parser for TAU traces.
 */

#ifndef PARSERTAU_HPP
#define PARSERTAU_HPP

#include "parser/TauParser/TauStructs.hpp"

/*!
 *
 * \class ParserTau
 * \brief parse the input data format of Tau.
 *
 */
class ParserTau : public Parser {
private:
    Ttf_CallbacksT  _callbacks;
    Ttf_FileHandleT _file;

     /* The string is corresponding to : node_id+'-'+thread_id */
    static std::map <std::string, Tau::Container> _containers;
    static std::map <int, Tau::State>             _states;
    static std::map <int, Tau::StateGroup>        _states_groups;
    static std::map <int, Tau::Event>             _events;

    static double _clock_period;

    /*!
     *  \fn static int set_timer_resolution(void *trace, double clkPeriod)
     *  \brief Callback method to set the timer resolution
     *  \param trace : useless here
     *  \param clkPeriod : the timer resolution
     *  \return 0, always.
     */
    static int set_timer_resolution(void *trace, double clkPeriod);

    /*!
     *  \fn static int def_process(void *trace, unsigned int nodeToken, unsigned int threadToken, const char *threadName)
     *  \brief Callback method to define a container
     *  \param trace : useless here
     *  \param nodeToken : the node id of the container
     *  \param threadToken : the thread id of the container
     *  \param threadName : the name of the container
     *  \return 0, always.
     */
    static int def_process(void *trace, unsigned int nodeToken, unsigned int threadToken, const char *threadName);

    /*!
     *  \fn static int def_state(void *trace, unsigned int stateToken, const char *stateName, unsigned int stateGroupToken)
     *  \brief Callback method to define a state
     *  \param trace : useless here
     *  \param stateToken : the state id
     *  \param stateName : the state name
     *  \param stateGroupToken : the id of the state group
     *  \return 0, always.
     */
    static int def_state(void *trace, unsigned int stateToken, const char *stateName, unsigned int stateGroupToken);

    /*!
     *  \fn static int def_state_group(void *trace, unsigned int stateGroupToken, const char *stateGroupName)
     *  \brief Callback method to define a state group (StateType)
     *  \param trace : useless here
     *  \param stateGroupToken : the state group id
     *  \param stateGroupName : the state group name
     *  \return 0, always.
     */
    static int def_state_group(void *trace, unsigned int stateGroupToken, const char *stateGroupName);

    /*!
     *  \fn static int def_event(void *trace, unsigned int userEventToken, const char *userEventName, int monotonicallyIncreasing)
     *  \brief Callback method to define a event
     *  \param trace : useless here
     *  \param userEventToken : the event id
     *  \param userEventName : the event name
     *  \param monotonicallyIncreasing : unused.
     *  \return 0, always.
     */
    static int def_event(void *trace, unsigned int userEventToken, const char *userEventName, int monotonicallyIncreasing);

    /*!
     *  \fn static int enter_state(void *trace, double time, unsigned int nid, unsigned int tid, unsigned int stateid)
     *  \brief Callback method to start a new state
     *  \param trace : the trace where we add the state.
     *  \param time : the time when entering in the state
     *  \param nid : the node id of the container
     *  \param tid : the thread id of the container
     *  \param stateid : the state id
     *  \return 0, always.
     */
    static int enter_state(void *trace, double time, unsigned int nid, unsigned int tid, unsigned int stateid);

    /*!
     *  \fn static int leave_state(void *trace, double time, unsigned int nid, unsigned int tid, unsigned int stateid)
     *  \brief Callback method to leave a state
     *  \param trace : the trace where we add the state.
     *  \param time : the time when entering in the state
     *  \param nid : the node id of the container
     *  \param tid : the thread id of the container
     *  \param stateid : the state id
     *  \return 0, always.
     */
    static int leave_state (void *trace, double time, unsigned int nid, unsigned int tid, unsigned int stateid);

    /*!
     *  \fn static int event_triggered(void *trace, double time, unsigned int nid, unsigned int tid, unsigned int eventid, long long eventValue)
     *  \brief Callback method to create a event
     *  \param trace : the trace where we add the state.
     *  \param time : the time when entering in the state
     *  \param nid : the node id of the container
     *  \param tid : the thread id of the container
     *  \param eventid : the event id
     *  \param eventValue : the event value
     *  \return 0, always.
     */
    static int event_triggered(void *trace, double time, unsigned int nid, unsigned int tid, unsigned int eventid, long long eventValue);

    /*!
     *  \fn static int send_message (void *trace, double time, unsigned int srcNid, unsigned int srcTid, unsigned int destNid, unsigned int destTid, unsigned int messageSize, unsigned int messageTag, unsigned int messageComm)
     *  \brief Callback method to send a message
     *  \param trace : the trace where we add the state.
     *  \param time : the time when entering in the state
     *  \param srcNid : the node id of the container source
     *  \param srcTid : the thread id of the container source
     *  \param destNid : the node id of the container destination
     *  \param destTid : the thread id of the container destination
     *  \param messageSize : unused (could be added as optional field)
     *  \param messageTag : used as key for finding the end of the message.
     *  \param messageComm : used as the value of the message.
     *  \return 0, always.
     */
    static int send_message (void *trace, double time, unsigned int srcNid, unsigned int srcTid, unsigned int destNid, unsigned int destTid, unsigned int messageSize, unsigned int messageTag, unsigned int messageComm);

    /*!
     *  \fn static int receive_message (void *trace, double time, unsigned int srcNid, unsigned int srcTid, unsigned int destNid, unsigned int destTid, unsigned int messageSize, unsigned int messageTag, unsigned int messageComm)
     *  \brief Callback method to receive a message
     *  \param trace : the trace where we add the state.
     *  \param time : the time when entering in the state
     *  \param srcNid : the node id of the container source
     *  \param srcTid : the thread id of the container source
     *  \param destNid : the node id of the container destination
     *  \param destTid : the thread id of the container destination
     *  \param messageSize : unused (could be added as optional field)
     *  \param messageTag : used as key for finding the begin of the message.
     *  \param messageComm : used as the value of the message.
     *  \return 0, always.
     */
    static int receive_message (void *trace, double time, unsigned int srcNid, unsigned int srcTid, unsigned int destNid, unsigned int destTid, unsigned int messageSize, unsigned int messageTag, unsigned int messageComm);

    /*!
     *  \fn static int end_trace(void *trace, unsigned int nodeToken, unsigned int threadToken)
     *  \brief Callback method to destroy a container
     *  \param trace : the trace where we destroy the container.
     *  \param nid : the node id of the container
     *  \param tid : the thread id of the container
     *  \return 0, always.
     */
    static int end_trace(void *trace, unsigned int nid, unsigned int tid);

    ParserTau(const ParserTau &);
public:

    /*!
     *  \fn ParserTau()
     */
    ParserTau();
    ParserTau(const std::string &filename);
    ~ParserTau();

    /*!
     *  \fn parse(Trace &trace, bool finish_trace_after_parse)
     *  \param trace : the structure of data to fill
     *  \param finish_trace_after_parse boolean set if we do not have to finish the trace after parsing
     */
    void parse(Trace &trace, bool finish_trace_after_parse = true);
    
    /*!
     *  \fn get_percent_loaded() const
     *  \brief return the size of the file already read.
     *  \return the scale of the size already loaded of the file by the parser. (between 0 and 1)
     */
    float get_percent_loaded() const;

};

#endif // PARSERTAU_HPP

