#include <memory>
#include <vector>
#include <boost/utility.hpp>
-#include <boost/type_traits/is_base_of.hpp>
-#include <boost/type_traits/has_trivial_constructor.hpp>
-#include <boost/type_traits/has_trivial_destructor.hpp>
#include <boost/static_assert.hpp>
+#include <boost/ptr_container/ptr_vector.hpp>
#include <senf/Utils/pool_alloc_mixin.hh>
#include <senf/Utils/singleton.hh>
//#include "PacketImpl.mpp"
+#include "PacketImpl.ih"
///////////////////////////////hh.p////////////////////////////////////////
namespace senf {
*/
struct ComplexAnnotation {};
-namespace detail {
-
- struct AnnotationP
- {
- virtual ~AnnotationP();
- };
-
- template <class Annotation>
- struct TAnnotationP
- : public AnnotationP
- {
- Annotation annotation;
- };
-
- union AnnotationEntry {
- AnnotationP * p;
- unsigned long long i;
- };
+ /** \brief Dump annotation registry debug information
+
+ This function will dump debug information about all registered annotations to \a os. This
+ information may then be used to tune the following annotation parameters for optimal
+ performance:
+ \li \c SENF_PACKET_ANNOTATION_SLOTS (define, default 8) is the number of slots available for
+ fast annotations
+ \li \c SENF_PACKET_ANNOTATION_SLOTSIZE (define, default 16) is the maximum size of a fast
+ annotation in bytes
+
+ The output includes the current parameter and has the following columns:
+ \li \c NAME: Annotation type name
+ \li \c FAST: This is 'yes', if the annotation was allocated to a fast slot. Otherwise the
+ annotation is managed as a slow/complex annotation
+ \li \c COMPLEX: This is 'yes', if the annotation inherits from ComplexAnnotation
+ \li \c SIZE: Size of the annotation in bytes
+
+ Fast annotations are considerable faster than complex and slow annotations. However, only
+ annotations which do not need constructor or destructor calls and which may be
+ zero-initialized (on the memory level) are legible as fast annotations.
+
+ It is thus desirable to eliminate any complex and slow annotations, if possible. To optimize
+ the annotation system, you may take the following steps:
+ \li If there are reasonably sized non-complex annotations which are larger than the current
+ \c SENF_PACKET_ANNOTATION_SLOTSIZE value, increase this value accordingly
+ \li If there are more non-complex annotations with a size less than
+ \c SENF_PACKET_ANNOTATION_SLOTSIZE than there are available slots, increase \c
+ SENF_PACKET_ANNOTATION_SLOTS accordingly
+ \li If all fast annotations are smaller than \c SENF_PACKET_ANNOTATION_SLOTSIZE, you may
+ decrease that value accordingly
+ \li If there are fewer than \c SENF_PACKET_ANNOTATION_SLOTS fast annotations, you may
+ decrease that value accordingly
- struct AnnotationIndexerBase
- {
- virtual ~AnnotationIndexerBase();
- virtual void v_dump(PacketImpl * p, std::ostream & os) = 0;
-
- static unsigned maxAnnotations;
- static std::vector<bool> & small();
- static std::vector<AnnotationIndexerBase*> & registry();
- static void dump(PacketImpl * p, std::ostream & os);
- };
-
- template <class Annotation>
- struct AnnotationIndexer
- : public senf::singleton< AnnotationIndexer<Annotation> >,
- public AnnotationIndexerBase
- {
- AnnotationIndexer();
- virtual void v_dump(PacketImpl * p, std::ostream & os);
- unsigned index_;
- static unsigned index();
- static bool const Complex = boost::is_base_of<ComplexAnnotation, Annotation>::value;
- static bool const Small = (sizeof(Annotation) <= sizeof(AnnotationEntry) && ! Complex);
-
-# if 0 // The test is difficult since it does not work with user-defined trivial constructors
-# ifdef BOOST_HAS_TYPE_TRAITS_INTRINSICS
-
- BOOST_STATIC_ASSERT(( (boost::has_trivial_constructor<Annotation>::value
- && boost::has_trivial_destructor<Annotation>::value)
- || Complex ));
-
-# endif
-# endif
- };
-
- template <class Annotation, bool Small = AnnotationIndexer<Annotation>::Small>
- struct GetAnnotation
- {
- static Annotation & get(AnnotationEntry & e);
- static void dump(AnnotationEntry & e, std::ostream & os);
- };
+ \see \ref packet_usage_annotation
+ */
+ void dumpPacketAnnotationRegistry(std::ostream & os);
- template <class Annotation>
- struct GetAnnotation<Annotation, true>
- {
- static Annotation & get(AnnotationEntry & e);
- static void dump(AnnotationEntry & e, std::ostream & os);
- };
+namespace detail {
/** \brief Internal: Packet data storage
// rerference/memory management
- void add_ref(refcount_t n=1);
- void release(refcount_t n=1);
+ void add_ref();
+ void release();
refcount_t refcount() const;
// Interpreter chain
// Annotations
template <class Annotation>
Annotation & annotation();
+
+ void clearAnnotations();
void dumpAnnotations(std::ostream & os);
- template <class Annotation>
- void dumpAnnotation(std::ostream & os);
/** \brief Internal: Keep PacketImpl instance alive
};
private:
+ void eraseInterpreters(interpreter_list::iterator b, interpreter_list::iterator e);
+ void updateIterators(PacketData * self, difference_type pos, difference_type n);
+
+ void * annotation(AnnotationRegistry::key_type key); // may return 0 !
+ void * complexAnnotation(AnnotationRegistry::key_type key); // may return 0 !
+ template <class Annotation>
+ void * complexAnnotation();
+
refcount_t refcount_;
raw_container data_;
interpreter_list interpreters_;
- typedef std::vector<AnnotationEntry> Annotations;
- Annotations annotations_;
+ union SimpleAnnotationSlot
+ {
+ unsigned char _ [SENF_PACKET_ANNOTATION_SLOTSIZE];
+ };
+
+ typedef boost::ptr_vector< boost::nullable<AnnotationRegistry::EntryBase> >
+ ComplexAnnotations;
+ ComplexAnnotations complexAnnotations_;
- void eraseInterpreters(interpreter_list::iterator b, interpreter_list::iterator e);
- void updateIterators(PacketData * self, difference_type pos, difference_type n);
+ SimpleAnnotationSlot simpleAnnotations_[SENF_PACKET_ANNOTATION_SLOTS];
};
}}
#if !defined(HH_SENF_Packets_Packets__decls_) && !defined(HH_SENF_Packets_PacketImpl_i_)
#define HH_SENF_Packets_PacketImpl_i_
#include "PacketImpl.cci"
-//#include "PacketImpl.ct"
+#include "PacketImpl.ct"
#include "PacketImpl.cti"
#endif
// compile-command: "scons -u test"
// comment-column: 40
// End:
-