/Users/yzchen/ns/ns-allinone-2.33/ns-2.33/trace/trace.h

/* -*-  Mode:C++; c-basic-offset:8; tab-width:8 -*- */
/*
 * Copyright (c) 1997 Regents of the University of California.
 * All rights reserved.
 * 
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 * 3. All advertising materials mentioning features or use of this software
 *    must display the following acknowledgement:
 *      This product includes software developed by the MASH Research
 *      Group at the University of California Berkeley.
 * 4. Neither the name of the University nor of the Research Group may be
 *    used to endorse or promote products derived from this software without
 *    specific prior written permission.
 * 
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * @(#) $Header: /cvsroot/nsnam/ns-2/trace/trace.h,v 1.34 2003/08/21 18:22:02 haldar Exp $
 */

#ifndef ns_trace_h
#define ns_trace_h

#define NUMFLAGS 8

#include <math.h> // floor
#include "packet.h"
#include "basetrace.h"


/* Tracing has evolved into two types, packet tracing and event tracing.
Class Trace essentially supports packet tracing. 
However in addition to the basic tracing properties (that it derives from a BaseTrace class), pkt-tracing also requires to inherit some of the Connector class properties as well.

Hence Trace should be renamed as ConnectorTrace in the future.
And it shall have a BaseTrace * variable, where BaseTrace class supporting pure tracing functionalities and should be the parent class for all subsequent trace-related classes.
*/

class Trace : public Connector {
protected:
        nsaddr_t src_;
        nsaddr_t dst_;
        int callback_;

        virtual void format(int tt, int s, int d, Packet* p);
        void annotate(const char* s);
        int show_tcphdr_;  // bool flags; backward compat
        int show_sctphdr_; // bool flags; backward compat
        void callback();
public:
        Trace(int type);
        ~Trace();

        BaseTrace *pt_;    // support for pkt tracing

        int type_;      
        int command(int argc, const char*const* argv);
        static int get_seqno(Packet* p);
        void recv(Packet* p, Handler*);
        void recvOnly(Packet *p);

        //Default rounding is to 6 digits after decimal
        //#define PRECISION 1.0E+6
        //According to freeBSD /usr/include/float.h 15 is the number of digits 
        // in a double.  We can specify all of them, because we're rounding to
        // 6 digits after the decimal and and %g removes trailing zeros.
        //#define TIME_FORMAT "%.15g"
        // annoying way of tackling sprintf rounding platform 
        // differences :
        // use round(Scheduler::instance().clock()) instead of 
        // Scheduler::instance().clock().
        //static double round (double x, double precision=PRECISION) {
        //return (double)floor(x*precision + 0.5)/precision;
        //}

        virtual void write_nam_trace(const char *s);
        void trace(TracedVar* var);
        //void namdump();
};

class DequeTrace : public Trace {
public:
        DequeTrace(int type) : Trace(type) {}
        ~DequeTrace();
        void recv(Packet* p, Handler*);

};


#endif