memamsg.h

//
// memamsg.h
//
// Copyright (C) 1996 Limit Point Systems, Inc.
//
// Author: Curtis Janssen <cljanss@limitpt.com>
// Maintainer: LPS
//
// This file is part of the SC Toolkit.
//
// The SC Toolkit is free software; you can redistribute it and/or modify
// it under the terms of the GNU Library General Public License as published by
// the Free Software Foundation; either version 2, or (at your option)
// any later version.
//
// The SC Toolkit 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 Library General Public License for more details.
//
// You should have received a copy of the GNU Library General Public License
// along with the SC Toolkit; see the file COPYING.LIB.  If not, write to
// the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
//
// The U.S. Government is granted a limited license as per AL 91-7.
//
 
#ifndef _util_group_memamsg_h
#define _util_group_memamsg_h
 
#include <iostream>
 
#include <util/group/memmsg.h>
 
namespace sc {
    
class MemoryDataRequest {
  public:
    enum Request { Deactivate, Sync, Retrieve, Replace, DoubleSum };
  private:
    struct {
        long offset;
        long size;
        Request request;
        int node;
        int serial_number;
        int lock;
    } data_;
  public:
    MemoryDataRequest() {}
    MemoryDataRequest(Request r, int node = 0, long offset = 0, long size = 0,
                      int lock = 0, int serial = 0);
    void assign(Request r, int node, long offset, long size,
                int lock, int serial);
    void *data() const { return (void *) &data_; }
    int nbytes() const { return sizeof(data_); }
 
    const char *request_string() const;
 
    MemoryDataRequest::Request request() const { return data_.request; }
    int node() const { return data_.node; }
    long offset() const { return data_.offset; }
    long size() const { return data_.size; }
    int serial_number() const { return data_.serial_number; }
    int lock() const { return data_.lock; }
 
    int touches_data() const {return request()!=Deactivate&&request()!=Sync;}
 
    // Sync messages only define one datum besides type and node
    int reactivate() const { return data_.offset; }
 
    void operator =(const MemoryDataRequest &r);
 
    void print(const char* msg = 0, std::ostream & o = ExEnv::out0()) const;
};
 
class MemoryDataRequestQueue {
  public:
    enum { MaxDepth = 1024 };
  private:
    MemoryDataRequest q_[MaxDepth];
    int n_;
  public:
    MemoryDataRequestQueue(): n_(0) {}
    int n() const { return n_; }
    void push(MemoryDataRequest&);
    void pop(MemoryDataRequest&);
 
    MemoryDataRequest& operator[](int i) { return q_[i]; }
    void clear() { n_ = 0; }
};
 
class ActiveMsgMemoryGrp : public MsgMemoryGrp {
  protected:
    char *data_;
 
    virtual void retrieve_data(void *, int node, long offset, long size,
                               int lock) = 0;
    virtual void replace_data(void *, int node, long offset, long size,
                              int unlock) = 0;
    virtual void sum_data(double *data, int node, long doffset, long dsize) = 0;
  public:
    ActiveMsgMemoryGrp(const Ref<MessageGrp>& msg);
    ActiveMsgMemoryGrp(const Ref<KeyVal>&);
    ~ActiveMsgMemoryGrp();
 
    void set_localsize(size_t);
    void *localdata();
 
    void *obtain_writeonly(distsize_t offset, size_t size);
    void *obtain_readwrite(distsize_t offset, size_t size);
    void *obtain_readonly(distsize_t offset, size_t size);
    void release_readonly(void *data, distsize_t offset, size_t size);
    void release_writeonly(void *data, distsize_t offset, size_t size);
    void release_readwrite(void *data, distsize_t offset, size_t size);
    void write(const void* data, distsize_t offset, size_t size);
 
    void sum_reduction(double *data, distsize_t doffset, size_t dsize);
    void sum_reduction_on_node(double *data, size_t doffset, size_t dsize,
                               int node = -1);
 
    void print(std::ostream &o = ExEnv::out0()) const;
};
 
}
 
#endif
 
// Local Variables:
// mode: c++
// c-file-style: "CLJ"
// End: