Weevil Workload Generation Library C++ API documentation (v. 1.0.1)

---

weevil.h

// -*- C++ -*-
//
//  This file is part of WEEVIL.
//
//  Authors: See the file AUTHORS for full details.
//
//  Copyright (C) 2002-2004 University of Colorado
//
//  This program is free software; you can redistribute it and/or
//  modify it under the terms of the GNU General Public License
//  as published by the Free Software Foundation; either version 2
//  of the License, or (at your option) any later version.
//
//  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, or send email to [email protected].
//
// $Id: weevil.h,v 1.1.1.1 2004/11/02 23:36:43 ywang Exp $
//
#ifndef WEEVIL_WEEVIL_H
#define WEEVIL_WEEVIL_H

#include <iostream>
#include <map>
#include <set>
#include <siena/ssim.h>
#include <siena/tprocess.h>
#include <string>

namespace weevil
{
  class WeevilGen : public ssim::Sim
  {
    static std::map<std::string,ssim::ProcessId> m_id2pid;
    static std::map<ssim::ProcessId,std::string> m_pid2id;    

  public:
    // Adds process to the internal maps of processes.
    //
    static void add_process( const std::string& id, ssim::ProcessId pid )
    {
      m_id2pid.insert( make_pair( id, pid ) );
      m_pid2id.insert( make_pair( pid, id ) );
    }

    static void broadcast_event( const ssim::Event* event, ssim::Time lag = 0 );

    // Static method to return the ProcessId given a
    // particular identifier.
    //
    static ssim::ProcessId id2pid( const std::string& id );

    // returns the id of the process that has
    // number pid.
    //
    static const std::string& pid2id( ssim::ProcessId pid );

    static void self_signal_event( const ssim::Event* event, ssim::Time lag = 0 );

    static void signal_event( const std::string& id, const ssim::Event* event, ssim::Time lag = 0 );
  };

  class WeevilActor
  {
    std::string         m_id;
    ssim::ProcessId     m_pid;

  public:
    // Sets the id of the process.
    //
    void id( const std::string& id )
    { m_id = id; }

    // Returns the id of the process.
    //
    const std::string& id() const
    { return m_id; }

    // Sets the processes processid.
    //
    void pid( ssim::ProcessId pid )
    { m_pid = pid; }

    // Returns the pid of the process.
    //
    ssim::ProcessId pid() const
    { return m_pid; }

    void workload_output( const char* body ) const
    { std::cout << "event(" << ssim::Sim::clock() << "," << m_id << "," << body << ")" << std::endl; }
  };

  class WeevilProcess : public ssim::Process, public weevil::WeevilActor
  {
  public:
    // Constructor chains to superclass.
    //
    WeevilProcess() : Process() {}
  };

  class WeevilTProcess : public ssim::TProcess, public weevil::WeevilActor
  {
  public:
    // Constructor chains to superclass.
    //
    WeevilTProcess() : TProcess() {}
  
    static const ssim::Event * wait_for_event(ssim::Time timeout = ssim::INIT_TIME)
    {
      return ssim::TProcess::wait_for_event(timeout);
    }
  };

  class KillerProcess : public ssim::Process
    {
    private:
      unsigned int m_delay;
    public:
      KillerProcess( unsigned int delay )
        : m_delay( delay ) {}
      
      void init()
      {
        ssim::Sim::set_stop_time( m_delay );
      }
  };
};

#endif

---

Copyright © 2002-2004 University of Colorado.
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License". This documentation is authored and maintained by Yanyan Wang