src/sim/eventq_impl.hh

   1 /*
   2  * Copyright (c) 2012 The Regents of The University of Michigan
   3  * Copyright (c) 2012-2013 Mark D. Hill and David A. Wood
   4  * Copyright (c) 2013 Advanced Micro Devices, Inc.
   5  * All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or without
   8  * modification, are permitted provided that the following conditions are
   9  * met: redistributions of source code must retain the above copyright
  10  * notice, this list of conditions and the following disclaimer;
  11  * redistributions in binary form must reproduce the above copyright
  12  * notice, this list of conditions and the following disclaimer in the
  13  * documentation and/or other materials provided with the distribution;
  14  * neither the name of the copyright holders nor the names of its
  15  * contributors may be used to endorse or promote products derived from
  16  * this software without specific prior written permission.
  17  *
  18  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  19  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  20  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  21  * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  22  * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  23  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  24  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  25  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  26  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  27  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  28  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  29  *
  30  * Authors: Steve Reinhardt
  31  *          Nathan Binkert
  32  *          Nilay Vaish
  33  */
  34
  35 #ifndef __SIM_EVENTQ_IMPL_HH__
  36 #define __SIM_EVENTQ_IMPL_HH__
  37
  38 #include "base/trace.hh"
  39 #include "sim/eventq.hh"
  40
  41 inline void
  42 EventQueue::schedule(Event *event, Tick when, bool global)
  43 {
  44     assert(when >= getCurTick());
  45     assert(!event->scheduled());
  46     assert(event->initialized());
  47
  48     event->setWhen(when, this);
  49
  50     // The check below is to make sure of two things
  51     // a. a thread schedules local events on other queues through the asyncq
  52     // b. a thread schedules global events on the asyncq, whether or not
  53     //    this event belongs to this eventq. This is required to maintain
  54     //    a total order amongst the global events. See global_event.{cc,hh}
  55     //    for more explanation.
  56     if (inParallelMode && (this != curEventQueue() || global)) {
  57         asyncInsert(event);
  58     } else {
  59         insert(event);
  60     }
  61     event->flags.set(Event::Scheduled);
  62     event->acquire();
  63
  64     if (DTRACE(Event))
  65         event->trace("scheduled");
  66 }
  67
  68 inline void
  69 EventQueue::deschedule(Event *event)
  70 {
  71     assert(event->scheduled());
  72     assert(event->initialized());
  73     assert(!inParallelMode || this == curEventQueue());
  74
  75     remove(event);
  76
  77     event->flags.clear(Event::Squashed);
  78     event->flags.clear(Event::Scheduled);
  79
  80     if (DTRACE(Event))
  81         event->trace("descheduled");
  82
  83     event->release();
  84 }
  85
  86 inline void
  87 EventQueue::reschedule(Event *event, Tick when, bool always)
  88 {
  89     assert(when >= getCurTick());
  90     assert(always || event->scheduled());
  91     assert(event->initialized());
  92     assert(!inParallelMode || this == curEventQueue());
  93
  94     if (event->scheduled()) {
  95         remove(event);
  96     } else {
  97         event->acquire();
  98     }
  99
 100     event->setWhen(when, this);
 101     insert(event);
 102     event->flags.clear(Event::Squashed);
 103     event->flags.set(Event::Scheduled);
 104
 105     if (DTRACE(Event))
 106         event->trace("rescheduled");
 107 }
 108
 109 #endif // __SIM_EVENTQ_IMPL_HH__