/usr/include/ns3/trace-source-accessor.h is in libns3-dev 3.13+dfsg-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 | /* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
* Copyright (c) 2008 INRIA
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as
* published by the Free Software Foundation;
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
* Authors: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
*/
#ifndef TRACE_SOURCE_ACCESSOR_H
#define TRACE_SOURCE_ACCESSOR_H
#include <stdint.h>
#include "callback.h"
#include "ptr.h"
#include "simple-ref-count.h"
namespace ns3 {
class ObjectBase;
/**
* \ingroup tracing
*
* \brief control access to objects' trace sources
*
* This class abstracts the kind of trace source to which we want to connect
* and provides services to Connect and Disconnect a sink to a trace source.
*/
class TraceSourceAccessor : public SimpleRefCount<TraceSourceAccessor>
{
public:
TraceSourceAccessor ();
virtual ~TraceSourceAccessor ();
/**
* \param obj the object instance which contains the target trace source.
* \param cb the callback to connect to the target trace source.
*/
virtual bool ConnectWithoutContext (ObjectBase *obj, const CallbackBase &cb) const = 0;
/**
* \param obj the object instance which contains the target trace source.
* \param context the context to bind to the user callback.
* \param cb the callback to connect to the target trace source.
*/
virtual bool Connect (ObjectBase *obj, std::string context, const CallbackBase &cb) const = 0;
/**
* \param obj the object instance which contains the target trace source.
* \param cb the callback to disconnect from the target trace source.
*/
virtual bool DisconnectWithoutContext (ObjectBase *obj, const CallbackBase &cb) const = 0;
/**
* \param obj the object instance which contains the target trace source.
* \param context the context which was bound to the user callback.
* \param cb the callback to disconnect from the target trace source.
*/
virtual bool Disconnect (ObjectBase *obj, std::string context, const CallbackBase &cb) const = 0;
};
/**
* \param a the trace source
*
* Create a TraceSourceAccessor which will control access to the underlying
* trace source. This helper template method assumes that the underlying
* type implements a statically-polymorphic set of Connect and Disconnect
* methods and creates a dynamic-polymorphic class to wrap the underlying
* static-polymorphic class.
*/
template <typename T>
Ptr<const TraceSourceAccessor> MakeTraceSourceAccessor (T a);
} // namespace ns3
namespace ns3 {
template <typename T, typename SOURCE>
Ptr<const TraceSourceAccessor>
DoMakeTraceSourceAccessor (SOURCE T::*a)
{
struct Accessor : public TraceSourceAccessor
{
virtual bool ConnectWithoutContext (ObjectBase *obj, const CallbackBase &cb) const {
T *p = dynamic_cast<T*> (obj);
if (p == 0)
{
return false;
}
(p->*m_source).ConnectWithoutContext (cb);
return true;
}
virtual bool Connect (ObjectBase *obj, std::string context, const CallbackBase &cb) const {
T *p = dynamic_cast<T*> (obj);
if (p == 0)
{
return false;
}
(p->*m_source).Connect (cb, context);
return true;
}
virtual bool DisconnectWithoutContext (ObjectBase *obj, const CallbackBase &cb) const {
T *p = dynamic_cast<T*> (obj);
if (p == 0)
{
return false;
}
(p->*m_source).DisconnectWithoutContext (cb);
return true;
}
virtual bool Disconnect (ObjectBase *obj, std::string context, const CallbackBase &cb) const {
T *p = dynamic_cast<T*> (obj);
if (p == 0)
{
return false;
}
(p->*m_source).Disconnect (cb, context);
return true;
}
SOURCE T::*m_source;
} *accessor = new Accessor ();
accessor->m_source = a;
return Ptr<const TraceSourceAccessor> (accessor, false);
}
template <typename T>
Ptr<const TraceSourceAccessor> MakeTraceSourceAccessor (T a)
{
return DoMakeTraceSourceAccessor (a);
}
} // namespace ns3
#endif /* TRACE_SOURCE_ACCESSOR_H */
|