/* -*- Mode: C; c-basic-offset:4 ; indent-tabs-mode:nil ; -*- */

/*  

 *  (C) 2007 by Argonne National Laboratory.

 *      See COPYRIGHT in top-level directory.

 */

/*

 * Prototype of the MPI2 debugger interface

 */

/* Basic types */

typedef void *MPI2DD_ADDR_T;

typedef int32_t MPI2DD_INT32_T;

typedef uint32_t MPI2DD_UINT32_T;

typedef unsigned char MPI2DD_BYTE_T;

/* Values for debug_state */

#define MPI2DD_DEBUG_START                     1

#define MPI2DD_DEBUG_SPAWN                     2

#define MPI2DD_DEBUG_CONNECT                   3

#define MPI2DD_DEBUG_ACCEPT                    4

#define MPI2DD_DEBUG_JOIN                      5

#define MPI2DD_DEBUG_DIRECTORY_CHANGED         6

#define MPI2DD_DEBUG_METADIRECTORY_CHANGED     7

#define MPI2DD_DEBUG_ABORT                     8

/* Values for debugger_flags */

#define MPI2DD_FLAG_GATE    0x01

#define MPI2DD_FLAG_BEING_DEBUGGED    0x02

#define MPI2DD_FLAG_REQUEST_DIRECTORY_EVENTS 0x04

/* Values for mpi_flags */

#define MPI2DD_MPIFLAG_I_AM_METADIR      0x01

#define MPI2DD_MPIFLAG_I_AM_DIR          0x02

#define MPI2DD_MPIFLAG_I_AM_STARTER      0x04

#define MPI2DD_MPIFLAG_FORCE_TO_MAIN     0x08

#define MPI2DD_MPIFLAG_IGNORE_QUEUE      0x10

#define MPI2DD_MPIFLAG_ACQUIRED_PRE_MAIN 0x20

#define MPI2DD_MPIFLAG_PARTIAL_ATTACH_OK 0x40

/* These structures are defined so that the debugger can find items

   easily, even in the absense of detailed symbol table information, 

   since the layout is fixed. */

typedef struct MPI2DD_PROCDESC {

    MPI2DD_ADDR_T host_name;       /* ASCII name of IP address where debugger

				      server can run */

    MPI2DD_ADDR_T executable_name; /* ASCII name of executable */

    MPI2DD_ADDR_T spawn_desc;      /* null if MPI-1, otherwise points to

				      MPI2DD_SPAWNDESC structure */

    MPI2DD_ADDR_T comm_world_id;   /* Unique ID for this COMM_WORLD */

    MPI2DD_INT32_T pid;            /* Process ID */

    MPI2DD_INT32_T rank;           /* Rank of process in COMM_WORLD */

} MPI2DD_PROCDESC;

typedef struct MPI2DD_SPAWNDESC {

    MPI2DD_ADDR_T parent_comm_world_id;  /* unique id of parent world */

    MPI2DD_INT32_T parent_rank;          /* rank of parent in that comm */

    MPI2DD_INT32_T sequence;             /* ordinal of this spawn in the

					    spawns of the parent */

} MPI2DD_SPAWNDESC;

typedef struct MPI2DD_INFO {

    MPI2DD_BYTE_T magic[5];             /* the string M P I 2 0x7f */

    MPI2DD_BYTE_T version;              /* 1 for now */

    MPI2DD_BYTE_T variant;              /* 1 for now */

    MPI2DD_BYTE_T debug_state;          /* See defines for MPI2DD_DEBUG_xxx */

    MPI2DD_UINT32_T debugger_flags;     /* See defines under debugger flags */

    MPI2DD_UINT32_T mpi_flags;          /* See defines under mpi flags */

    MPI2DD_ADDR_T   dll_name_32;        /* path to msg queue debug lib for 

					   32-bit executables */

    MPI2DD_ADDR_T   dll_name_64;        /* as above, for 64-bit executables */

    MPI2DD_ADDR_T   meta_host_name;     /* network name for metadirectory 

					   process */

    MPIDDD_ADDR_T   meta_executable_name;      /* Name of the meta directory

						  executable */

    MPI2DD_ADDR_T   abort_string;       /* Use this string when 

					   breakpoint is triggered and

					   debug state is ABORT */

    MPI2DD_ADDR_T   proctable;          /* Null unless directory 

					   process, then address of

					   array of proctable entries */

    MPI2DD_ADDR_T   directory_table;    /* Null unless metatdirectory 

					   process, then address of

					   array of directory entries */

    MPI2DD_ADDR_T   metadirectory_table;/* As above, for directory

					   entries of metadirectory

					   servers */

    MPI2DD_INT32_T  proctable_size;     /* size of proctable array */

    MPI2DD_INT32_T  directory_size;     /* size of directory array */

    MPI2DD_INT32_T  metadirctory_size;  /* size of metadirectory array */

    MPI2DD_INT32_T  meta_pid;           /* pid of meta directory process */

    MPI2DD_INT32_T  padding[8];         /* for future extensions */

} MPI2DD_INFO;