reftrack.h

/*
 * Copyright information and license terms for this software can be
 * found in the file LICENSE that is included with the distribution
 */
#ifndef REFTRACK_H
#define REFTRACK_H
 
#ifdef __cplusplus
 
#include <map>
#include <string>
#include <ostream>
 
#include <stdlib.h>
 
#include <epicsVersion.h>
#include <epicsAtomic.h>
 
#define REFTRACE_INCREMENT(counter) ::epics::atomic::increment(counter)
#define REFTRACE_DECREMENT(counter) ::epics::atomic::decrement(counter)
 
#include <shareLib.h>
 
namespace epics {
 
epicsShareFunc
void registerRefCounter(const char *name, const size_t* counter);
 
epicsShareFunc
void unregisterRefCounter(const char *name, const size_t* counter);
 
epicsShareFunc
size_t readRefCounter(const char *name);
 
class epicsShareClass RefSnapshot
{
public:
    struct Count {
        size_t current;
        long delta; 
        Count() :current(0u), delta(0) {}
        explicit Count(size_t c, long d) :current(c), delta(d) {}
        bool operator==(const Count& o) const
        { return current==o.current && delta==o.delta; }
    };
 
private:
    typedef std::map<std::string, Count> cnt_map_t;
    cnt_map_t counts;
public:
    typedef cnt_map_t::const_iterator iterator;
    typedef cnt_map_t::const_iterator const_iterator;
 
    void update();
 
    const Count& operator[](const std::string& name) const;
 
    iterator begin() const { return counts.begin(); }
    iterator end() const { return counts.end(); }
    size_t size() const { return counts.size(); }
 
    inline void swap(RefSnapshot& o)
    {
        counts.swap(o.counts);
    }
 
    RefSnapshot operator-(const RefSnapshot& rhs) const;
};
 
epicsShareFunc
std::ostream& operator<<(std::ostream& strm, const RefSnapshot& snap);
 
class epicsShareClass RefMonitor
{
    struct Impl;
    Impl *impl;
public:
    RefMonitor();
    virtual ~RefMonitor();
 
    void start(double period=10.0);
    void stop();
    bool running() const;
 
    void current();
protected:
    virtual void show(const RefSnapshot& snap, bool complete=false);
};
 
} // namespace epics
 
extern "C" {
#endif /* __cplusplus */
 
char* epicsRefSnapshotCurrent();
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif // REFTRACK_H