mv_ipc.h

/*
   This file is part of memview, a real-time memory trace visualization
   application.

   Copyright (C) 2013 Andrew Clinton

   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.

   The GNU General Public License is contained in the file COPYING.
*/

#ifndef MV_IPC_H
#define MV_IPC_H

//
// The unidirectional (tool to memview) pipe communication protocol is
// simple.  First a message header is sent, followed by the data.  The size
// of the data is specified in the header.
//

// Message types
typedef enum {
    MV_BLOCK,
    MV_STACKTRACE,
    MV_MMAP
} MV_MessageType;

#define MV_STR_BUFSIZE 4096

typedef struct __attribute__((__packed__)) {
    unsigned long long  myAddr;
    unsigned int        myType;
} MV_TraceAddr;

typedef struct {
    MV_TraceAddr        myAddr;
    int                 mySize;
} MV_StackInfo;

typedef enum {
    MV_CODE,
    MV_DATA,
    MV_HEAP,
    MV_STACK,
    MV_SHM,
    MV_UNMAP
} MV_MMapType;

typedef struct {
    unsigned long long        myStart;
    unsigned long long        myEnd;
    MV_MMapType               myType;
    int                       myThread;
    int                       mySize;
} MV_MMapInfo;

typedef struct {
    MV_MessageType  myType;
    union {
        MV_StackInfo       myStack;
        MV_MMapInfo        myMMap;
    };
} MV_Header;

#define MV_BlockSize        (1024*32)

#define MV_MASK(BITS, SHIFT) (((1u << BITS)-1) << SHIFT)

// Thread, type and data are stored consecutively since during updates
// these don't need to be separated (and so are treated as a single 16-bit
// quantity).

#define MV_ThreadBits 10
#define MV_ThreadShift 14
#define MV_ThreadMask MV_MASK(MV_ThreadBits, MV_ThreadShift)

#define MV_TypeBits 3
#define MV_TypeShift 11
#define MV_TypeMask MV_MASK(MV_TypeBits, MV_TypeShift)

#define MV_DataBits 3
#define MV_DataShift 8
#define MV_DataMask MV_MASK(MV_DataBits, MV_DataShift)

#define MV_SizeBits 8
#define MV_SizeShift 0
#define MV_SizeMask MV_MASK(MV_SizeBits, MV_SizeShift)

// Order is important here - we use a max() for downsampling, which will
// cause reads to be preferred over writes when MV_ event time matches.  If
// you update these values, you will also need to update MV_ shader.frag
// code.
#define MV_TypeAlloc  0
#define MV_TypeInstr  1
#define MV_TypeWrite  2
#define MV_TypeRead   3
#define MV_TypeFree   4

#define MV_ShiftedAlloc  ((unsigned int)MV_TypeAlloc << MV_TypeShift)
#define MV_ShiftedInstr  ((unsigned int)MV_TypeInstr << MV_TypeShift)
#define MV_ShiftedWrite  ((unsigned int)MV_TypeWrite << MV_TypeShift)
#define MV_ShiftedRead   ((unsigned int)MV_TypeRead << MV_TypeShift)
#define MV_ShiftedFree   ((unsigned int)MV_TypeFree << MV_TypeShift)

#define MV_DataInt32      0
#define MV_DataInt64      1
#define MV_DataFlt32      2
#define MV_DataFlt64      3
#define MV_DataChar8      4
#define MV_DataVec        5

typedef struct {
    MV_TraceAddr        myAddr[MV_BlockSize];
    unsigned int        myEntries;
} MV_TraceBlock;

#define MV_BufCount 4

typedef struct {
    MV_TraceBlock   myData[MV_BufCount];
} MV_SharedData;

#endif