Delete comment that makes no sense.
[mpich.git] / src / include / mpi.h.in
1 /* -*- Mode: C; c-basic-offset:4 ; -*- */
2 /*  
3  *  (C) 2001 by Argonne National Laboratory.
4  *      See COPYRIGHT in top-level directory.
5  */
6 /* @configure_input@ */
7 #ifndef MPI_INCLUDED
8 #define MPI_INCLUDED
9
10 /* user include file for MPI programs */
11
12 /* Keep C++ compilers from getting confused */
13 #if defined(__cplusplus)
14 extern "C" {
15 #endif
16
17 @DISABLE_TAG_SUPPORT@
18 #undef MPICH_DEFINE_ATTR_TYPE_TYPES
19 #if defined(__has_attribute)
20 #  if __has_attribute(pointer_with_type_tag) && \
21       __has_attribute(type_tag_for_datatype) && \
22       !defined(NO_TAGS_WITH_MODIFIERS) &&\
23       !defined(MPICH_NO_ATTR_TYPE_TAGS)
24 #    define MPICH_DEFINE_ATTR_TYPE_TYPES 1
25 #    define MPICH_ATTR_POINTER_WITH_TYPE_TAG(buffer_idx, type_idx)  __attribute__((pointer_with_type_tag(MPI,buffer_idx,type_idx)))
26 #    define MPICH_ATTR_TYPE_TAG(type)                               __attribute__((type_tag_for_datatype(MPI,type)))
27 #    define MPICH_ATTR_TYPE_TAG_LAYOUT_COMPATIBLE(type)             __attribute__((type_tag_for_datatype(MPI,type,layout_compatible)))
28 #    define MPICH_ATTR_TYPE_TAG_MUST_BE_NULL()                      __attribute__((type_tag_for_datatype(MPI,void,must_be_null)))
29 #    include <stddef.h>
30 #  endif
31 #endif
32
33 #if !defined(MPICH_ATTR_POINTER_WITH_TYPE_TAG)
34 #  define MPICH_ATTR_POINTER_WITH_TYPE_TAG(buffer_idx, type_idx)
35 #  define MPICH_ATTR_TYPE_TAG(type)
36 #  define MPICH_ATTR_TYPE_TAG_LAYOUT_COMPATIBLE(type)
37 #  define MPICH_ATTR_TYPE_TAG_MUST_BE_NULL()
38 #endif
39
40 #if !defined(INT8_C)
41 /* stdint.h was not included, see if we can get it */
42 #  if defined(__cplusplus)
43 #    if __cplusplus >= 201103
44 #      include <cstdint>
45 #    endif
46 #  endif
47 #endif
48
49 #if !defined(INT8_C)
50 /* stdint.h was not included, see if we can get it */
51 #  if defined(__STDC_VERSION__)
52 #    if __STDC_VERSION__ >= 199901
53 #      include <stdint.h>
54 #    endif
55 #  endif
56 #endif
57
58 #if defined(INT8_C)
59 /* stdint.h was included, so we can annotate these types */
60 #  define MPICH_ATTR_TYPE_TAG_STDINT(type) MPICH_ATTR_TYPE_TAG(type)
61 #else
62 #  define MPICH_ATTR_TYPE_TAG_STDINT(type)
63 #endif
64
65 #ifdef __STDC_VERSION__ 
66 #if __STDC_VERSION__ >= 199901
67 #  define MPICH_ATTR_TYPE_TAG_C99(type) MPICH_ATTR_TYPE_TAG(type)
68 #else
69 #  define MPICH_ATTR_TYPE_TAG_C99(type)
70 #endif
71 #else 
72 #  define MPICH_ATTR_TYPE_TAG_C99(type)
73 #endif
74
75 #if defined(__cplusplus)
76 #  define MPICH_ATTR_TYPE_TAG_CXX(type) MPICH_ATTR_TYPE_TAG(type)
77 #else
78 #  define MPICH_ATTR_TYPE_TAG_CXX(type)
79 #endif
80
81
82 /* Define some null objects */
83 #define MPI_COMM_NULL      ((MPI_Comm)0x04000000)
84 #define MPI_OP_NULL        ((MPI_Op)0x18000000)
85 #define MPI_GROUP_NULL     ((MPI_Group)0x08000000)
86 #define MPI_DATATYPE_NULL  ((MPI_Datatype)0x0c000000)
87 #define MPI_REQUEST_NULL   ((MPI_Request)0x2c000000)
88 #define MPI_ERRHANDLER_NULL ((MPI_Errhandler)0x14000000)
89 #define MPI_MESSAGE_NULL   ((MPI_Message)0x2c000000)
90 #define MPI_MESSAGE_NO_PROC ((MPI_Message)0x6c000000)
91
92 /* Results of the compare operations. */
93 #define MPI_IDENT     0
94 #define MPI_CONGRUENT 1
95 #define MPI_SIMILAR   2
96 #define MPI_UNEQUAL   3
97
98 typedef int MPI_Datatype;
99 #define MPI_CHAR           ((MPI_Datatype)@MPI_CHAR@)
100 #define MPI_SIGNED_CHAR    ((MPI_Datatype)@MPI_SIGNED_CHAR@)
101 #define MPI_UNSIGNED_CHAR  ((MPI_Datatype)@MPI_UNSIGNED_CHAR@)
102 #define MPI_BYTE           ((MPI_Datatype)@MPI_BYTE@)
103 #define MPI_WCHAR          ((MPI_Datatype)@MPI_WCHAR@)
104 #define MPI_SHORT          ((MPI_Datatype)@MPI_SHORT@)
105 #define MPI_UNSIGNED_SHORT ((MPI_Datatype)@MPI_UNSIGNED_SHORT@)
106 #define MPI_INT            ((MPI_Datatype)@MPI_INT@)
107 #define MPI_UNSIGNED       ((MPI_Datatype)@MPI_UNSIGNED_INT@)
108 #define MPI_LONG           ((MPI_Datatype)@MPI_LONG@)
109 #define MPI_UNSIGNED_LONG  ((MPI_Datatype)@MPI_UNSIGNED_LONG@)
110 #define MPI_FLOAT          ((MPI_Datatype)@MPI_FLOAT@)
111 #define MPI_DOUBLE         ((MPI_Datatype)@MPI_DOUBLE@)
112 #define MPI_LONG_DOUBLE    ((MPI_Datatype)@MPI_LONG_DOUBLE@)
113 #define MPI_LONG_LONG_INT  ((MPI_Datatype)@MPI_LONG_LONG@)
114 #define MPI_UNSIGNED_LONG_LONG ((MPI_Datatype)@MPI_UNSIGNED_LONG_LONG@)
115 #define MPI_LONG_LONG      MPI_LONG_LONG_INT
116
117 #ifdef MPICH_DEFINE_ATTR_TYPE_TYPES
118 static const MPI_Datatype mpich_mpi_char               MPICH_ATTR_TYPE_TAG(char)               = MPI_CHAR;
119 static const MPI_Datatype mpich_mpi_signed_char        MPICH_ATTR_TYPE_TAG(signed char)        = MPI_SIGNED_CHAR;
120 static const MPI_Datatype mpich_mpi_unsigned_char      MPICH_ATTR_TYPE_TAG(unsigned char)      = MPI_UNSIGNED_CHAR;
121 /*static const MPI_Datatype mpich_mpi_byte               MPICH_ATTR_TYPE_TAG(char)               = MPI_BYTE;*/
122 static const MPI_Datatype mpich_mpi_wchar              MPICH_ATTR_TYPE_TAG(wchar_t)            = MPI_WCHAR;
123 static const MPI_Datatype mpich_mpi_short              MPICH_ATTR_TYPE_TAG(short)              = MPI_SHORT;
124 static const MPI_Datatype mpich_mpi_unsigned_short     MPICH_ATTR_TYPE_TAG(unsigned short)     = MPI_UNSIGNED_SHORT;
125 static const MPI_Datatype mpich_mpi_int                MPICH_ATTR_TYPE_TAG(int)                = MPI_INT;
126 static const MPI_Datatype mpich_mpi_unsigned           MPICH_ATTR_TYPE_TAG(unsigned)           = MPI_UNSIGNED;
127 static const MPI_Datatype mpich_mpi_long               MPICH_ATTR_TYPE_TAG(long)               = MPI_LONG;
128 static const MPI_Datatype mpich_mpi_unsigned_long      MPICH_ATTR_TYPE_TAG(unsigned long)      = MPI_UNSIGNED_LONG;
129 static const MPI_Datatype mpich_mpi_float              MPICH_ATTR_TYPE_TAG(float)              = MPI_FLOAT;
130 static const MPI_Datatype mpich_mpi_double             MPICH_ATTR_TYPE_TAG(double)             = MPI_DOUBLE;
131 #if @MPI_LONG_DOUBLE@ != 0x0c000000
132 static const MPI_Datatype mpich_mpi_long_double        MPICH_ATTR_TYPE_TAG(long double)        = MPI_LONG_DOUBLE;
133 #endif
134 static const MPI_Datatype mpich_mpi_long_long_int      MPICH_ATTR_TYPE_TAG(long long int)      = MPI_LONG_LONG_INT;
135 static const MPI_Datatype mpich_mpi_unsigned_long_long MPICH_ATTR_TYPE_TAG(unsigned long long) = MPI_UNSIGNED_LONG_LONG;
136 #endif
137
138 #define MPI_PACKED         ((MPI_Datatype)@MPI_PACKED@)
139 #define MPI_LB             ((MPI_Datatype)@MPI_LB@)
140 #define MPI_UB             ((MPI_Datatype)@MPI_UB@)
141
142 /* 
143    The layouts for the types MPI_DOUBLE_INT etc are simply
144    struct { 
145        double var;
146        int    loc;
147    }
148    This is documented in the man pages on the various datatypes.   
149  */
150 #define MPI_FLOAT_INT         ((MPI_Datatype)@MPI_FLOAT_INT@)
151 #define MPI_DOUBLE_INT        ((MPI_Datatype)@MPI_DOUBLE_INT@)
152 #define MPI_LONG_INT          ((MPI_Datatype)@MPI_LONG_INT@)
153 #define MPI_SHORT_INT         ((MPI_Datatype)@MPI_SHORT_INT@)
154 #define MPI_2INT              ((MPI_Datatype)@MPI_2INT@)
155 #define MPI_LONG_DOUBLE_INT   ((MPI_Datatype)@MPI_LONG_DOUBLE_INT@)
156
157 #ifdef MPICH_DEFINE_ATTR_TYPE_TYPES
158 struct mpich_struct_mpi_float_int       { float f; int i; };
159 struct mpich_struct_mpi_double_int      { double d; int i; };
160 struct mpich_struct_mpi_long_int        { long l; int i; };
161 struct mpich_struct_mpi_short_int       { short s; int i; };
162 struct mpich_struct_mpi_2int            { int i1; int i2; };
163 #if @MPI_LONG_DOUBLE_INT@ != 0x0c000000
164 struct mpich_struct_mpi_long_double_int { long double ld; int i; };
165 #endif
166
167 static const MPI_Datatype mpich_mpi_float_int       MPICH_ATTR_TYPE_TAG_LAYOUT_COMPATIBLE(struct mpich_struct_mpi_float_int)       = MPI_FLOAT_INT;
168 static const MPI_Datatype mpich_mpi_double_int      MPICH_ATTR_TYPE_TAG_LAYOUT_COMPATIBLE(struct mpich_struct_mpi_double_int)      = MPI_DOUBLE_INT;
169 static const MPI_Datatype mpich_mpi_long_int        MPICH_ATTR_TYPE_TAG_LAYOUT_COMPATIBLE(struct mpich_struct_mpi_long_int)        = MPI_LONG_INT;
170 static const MPI_Datatype mpich_mpi_short_int       MPICH_ATTR_TYPE_TAG_LAYOUT_COMPATIBLE(struct mpich_struct_mpi_short_int)       = MPI_SHORT_INT;
171
172 /*
173  * The MPI_2INT line is commented out because currently Clang 3.3 flags
174  * struct {int i1; int i2;} as different from int[2]. But actually these
175  * two types are of the same layout. Clang gives a type mismatch warning
176  * for a definitely correct code like the following:
177  *  int in[2], out[2];
178  *  MPI_Reduce(in, out, 1, MPI_2INT, MPI_MAXLOC, 0, MPI_COMM_WORLD);
179  *
180  * So, we disable type checking for MPI_2INT until Clang fixes this bug.
181  */
182
183 /* static const MPI_Datatype mpich_mpi_2int            MPICH_ATTR_TYPE_TAG_LAYOUT_COMPATIBLE(struct mpich_struct_mpi_2int)            = MPI_2INT
184  */
185
186 #if @MPI_LONG_DOUBLE_INT@ != 0x0c000000
187 static const MPI_Datatype mpich_mpi_long_double_int MPICH_ATTR_TYPE_TAG_LAYOUT_COMPATIBLE(struct mpich_struct_mpi_long_double_int) = MPI_LONG_DOUBLE_INT;
188 #endif
189 #endif
190
191 /* Fortran types */
192 #define MPI_COMPLEX           ((MPI_Datatype)@MPI_COMPLEX@)
193 #define MPI_DOUBLE_COMPLEX    ((MPI_Datatype)@MPI_DOUBLE_COMPLEX@)
194 #define MPI_LOGICAL           ((MPI_Datatype)@MPI_LOGICAL@)
195 #define MPI_REAL              ((MPI_Datatype)@MPI_REAL@)
196 #define MPI_DOUBLE_PRECISION  ((MPI_Datatype)@MPI_DOUBLE_PRECISION@)
197 #define MPI_INTEGER           ((MPI_Datatype)@MPI_INTEGER@)
198 #define MPI_2INTEGER          ((MPI_Datatype)@MPI_2INTEGER@)
199 /* 
200  * MPI_2COMPLEX and MPI_2DOUBLE_COMPLEX were defined by accident in 
201  * MPI 1.0 and removed in MPI 1.1.  
202  *
203  * This definition provides backward compatibility.  These definitions
204  * will be removed in a subsequent MPICH release
205  */
206 #ifdef MPICH_DEFINE_2COMPLEX
207 #define MPI_2COMPLEX          ((MPI_Datatype)@MPI_2COMPLEX@)
208 #define MPI_2DOUBLE_COMPLEX   ((MPI_Datatype)@MPI_2DOUBLE_COMPLEX@)
209 #endif 
210 #define MPI_2REAL             ((MPI_Datatype)@MPI_2REAL@)
211 #define MPI_2DOUBLE_PRECISION ((MPI_Datatype)@MPI_2DOUBLE_PRECISION@)
212 #define MPI_CHARACTER         ((MPI_Datatype)@MPI_CHARACTER@)
213
214 /* Size-specific types (see MPI-2, 10.2.5) */
215 #define MPI_REAL4             ((MPI_Datatype)@MPI_REAL4@)
216 #define MPI_REAL8             ((MPI_Datatype)@MPI_REAL8@)
217 #define MPI_REAL16            ((MPI_Datatype)@MPI_REAL16@)
218 #define MPI_COMPLEX8          ((MPI_Datatype)@MPI_COMPLEX8@)
219 #define MPI_COMPLEX16         ((MPI_Datatype)@MPI_COMPLEX16@)
220 #define MPI_COMPLEX32         ((MPI_Datatype)@MPI_COMPLEX32@)
221 #define MPI_INTEGER1          ((MPI_Datatype)@MPI_INTEGER1@)
222 #define MPI_INTEGER2          ((MPI_Datatype)@MPI_INTEGER2@)
223 #define MPI_INTEGER4          ((MPI_Datatype)@MPI_INTEGER4@)
224 #define MPI_INTEGER8          ((MPI_Datatype)@MPI_INTEGER8@)
225 #define MPI_INTEGER16         ((MPI_Datatype)@MPI_INTEGER16@)
226
227 /* C99 fixed-width datatypes */
228 #define MPI_INT8_T            ((MPI_Datatype)@MPI_INT8_T@)
229 #define MPI_INT16_T           ((MPI_Datatype)@MPI_INT16_T@)
230 #define MPI_INT32_T           ((MPI_Datatype)@MPI_INT32_T@)
231 #define MPI_INT64_T           ((MPI_Datatype)@MPI_INT64_T@)
232 #define MPI_UINT8_T           ((MPI_Datatype)@MPI_UINT8_T@)
233 #define MPI_UINT16_T          ((MPI_Datatype)@MPI_UINT16_T@)
234 #define MPI_UINT32_T          ((MPI_Datatype)@MPI_UINT32_T@)
235 #define MPI_UINT64_T          ((MPI_Datatype)@MPI_UINT64_T@)
236
237 #ifdef MPICH_DEFINE_ATTR_TYPE_TYPES
238 static const MPI_Datatype mpich_mpi_int8_t   MPICH_ATTR_TYPE_TAG_STDINT(int8_t)   = MPI_INT8_T;
239 static const MPI_Datatype mpich_mpi_int16_t  MPICH_ATTR_TYPE_TAG_STDINT(int16_t)  = MPI_INT16_T;
240 static const MPI_Datatype mpich_mpi_int32_t  MPICH_ATTR_TYPE_TAG_STDINT(int32_t)  = MPI_INT32_T;
241 static const MPI_Datatype mpich_mpi_int64_t  MPICH_ATTR_TYPE_TAG_STDINT(int64_t)  = MPI_INT64_T;
242 static const MPI_Datatype mpich_mpi_uint8_t  MPICH_ATTR_TYPE_TAG_STDINT(uint8_t)  = MPI_UINT8_T;
243 static const MPI_Datatype mpich_mpi_uint16_t MPICH_ATTR_TYPE_TAG_STDINT(uint16_t) = MPI_UINT16_T;
244 static const MPI_Datatype mpich_mpi_uint32_t MPICH_ATTR_TYPE_TAG_STDINT(uint32_t) = MPI_UINT32_T;
245 static const MPI_Datatype mpich_mpi_uint64_t MPICH_ATTR_TYPE_TAG_STDINT(uint64_t) = MPI_UINT64_T;
246 #endif
247
248 /* other C99 types */
249 #define MPI_C_BOOL                 ((MPI_Datatype)@MPI_C_BOOL@)
250 #define MPI_C_FLOAT_COMPLEX        ((MPI_Datatype)@MPI_C_FLOAT_COMPLEX@)
251 #define MPI_C_COMPLEX              MPI_C_FLOAT_COMPLEX
252 #define MPI_C_DOUBLE_COMPLEX       ((MPI_Datatype)@MPI_C_DOUBLE_COMPLEX@)
253 #define MPI_C_LONG_DOUBLE_COMPLEX  ((MPI_Datatype)@MPI_C_LONG_DOUBLE_COMPLEX@)
254
255 #ifdef MPICH_DEFINE_ATTR_TYPE_TYPES
256 static const MPI_Datatype mpich_mpi_c_bool                MPICH_ATTR_TYPE_TAG_C99(_Bool)           = MPI_C_BOOL;
257 static const MPI_Datatype mpich_mpi_c_float_complex       MPICH_ATTR_TYPE_TAG_C99(float _Complex)  = MPI_C_FLOAT_COMPLEX;
258 static const MPI_Datatype mpich_mpi_c_double_complex      MPICH_ATTR_TYPE_TAG_C99(double _Complex) = MPI_C_DOUBLE_COMPLEX;
259 #if @MPI_C_LONG_DOUBLE_COMPLEX@ != 0x0c000000
260 static const MPI_Datatype mpich_mpi_c_long_double_complex MPICH_ATTR_TYPE_TAG_C99(long double _Complex) = MPI_C_LONG_DOUBLE_COMPLEX;
261 #endif
262 #endif
263
264 /* address/offset types */
265 #define MPI_AINT          ((MPI_Datatype)@MPI_AINT_DATATYPE@)
266 #define MPI_OFFSET        ((MPI_Datatype)@MPI_OFFSET_DATATYPE@)
267 #define MPI_COUNT         ((MPI_Datatype)@MPI_COUNT_DATATYPE@)
268
269 /* MPI-3 C++ types */
270 #define MPI_CXX_BOOL                ((MPI_Datatype)@MPIR_CXX_BOOL@)
271 #define MPI_CXX_FLOAT_COMPLEX       ((MPI_Datatype)@MPIR_CXX_COMPLEX@)
272 #define MPI_CXX_DOUBLE_COMPLEX      ((MPI_Datatype)@MPIR_CXX_DOUBLE_COMPLEX@)
273 #define MPI_CXX_LONG_DOUBLE_COMPLEX ((MPI_Datatype)@MPIR_CXX_LONG_DOUBLE_COMPLEX@)
274
275 /* typeclasses */
276 #define MPI_TYPECLASS_REAL 1
277 #define MPI_TYPECLASS_INTEGER 2
278 #define MPI_TYPECLASS_COMPLEX 3
279
280 /* Communicators */
281 typedef int MPI_Comm;
282 #define MPI_COMM_WORLD ((MPI_Comm)0x44000000)
283 #define MPI_COMM_SELF  ((MPI_Comm)0x44000001)
284
285 /* Groups */
286 typedef int MPI_Group;
287 #define MPI_GROUP_EMPTY ((MPI_Group)0x48000000)
288
289 /* RMA and Windows */
290 typedef int MPI_Win;
291 #define MPI_WIN_NULL ((MPI_Win)0x20000000)
292
293 /* File and IO */
294 /* This define lets ROMIO know that MPI_File has been defined */
295 #define MPI_FILE_DEFINED
296 /* ROMIO uses a pointer for MPI_File objects.  This must be the same definition
297    as in src/mpi/romio/include/mpio.h.in  */
298 typedef struct ADIOI_FileD *MPI_File;
299 #define MPI_FILE_NULL ((MPI_File)0)
300
301 /* Collective operations */
302 typedef int MPI_Op;
303
304 #define MPI_MAX     (MPI_Op)(0x58000001)
305 #define MPI_MIN     (MPI_Op)(0x58000002)
306 #define MPI_SUM     (MPI_Op)(0x58000003)
307 #define MPI_PROD    (MPI_Op)(0x58000004)
308 #define MPI_LAND    (MPI_Op)(0x58000005)
309 #define MPI_BAND    (MPI_Op)(0x58000006)
310 #define MPI_LOR     (MPI_Op)(0x58000007)
311 #define MPI_BOR     (MPI_Op)(0x58000008)
312 #define MPI_LXOR    (MPI_Op)(0x58000009)
313 #define MPI_BXOR    (MPI_Op)(0x5800000a)
314 #define MPI_MINLOC  (MPI_Op)(0x5800000b)
315 #define MPI_MAXLOC  (MPI_Op)(0x5800000c)
316 #define MPI_REPLACE (MPI_Op)(0x5800000d)
317 #define MPI_NO_OP   (MPI_Op)(0x5800000e)
318
319 /* Permanent key values */
320 /* C Versions (return pointer to value),
321    Fortran Versions (return integer value).
322    Handled directly by the attribute value routine
323    
324    DO NOT CHANGE THESE.  The values encode:
325    builtin kind (0x1 in bit 30-31)
326    Keyval object (0x9 in bits 26-29)
327    for communicator (0x1 in bits 22-25)
328    
329    Fortran versions of the attributes are formed by adding one to
330    the C version.
331  */
332 #define MPI_TAG_UB           0x64400001
333 #define MPI_HOST             0x64400003
334 #define MPI_IO               0x64400005
335 #define MPI_WTIME_IS_GLOBAL  0x64400007
336 #define MPI_UNIVERSE_SIZE    0x64400009
337 #define MPI_LASTUSEDCODE     0x6440000b
338 #define MPI_APPNUM           0x6440000d
339
340 /* In addition, there are 5 predefined window attributes that are
341    defined for every window */
342 #define MPI_WIN_BASE          0x66000001
343 #define MPI_WIN_SIZE          0x66000003
344 #define MPI_WIN_DISP_UNIT     0x66000005
345 #define MPI_WIN_CREATE_FLAVOR 0x66000007
346 #define MPI_WIN_MODEL         0x66000009
347
348 #ifdef MPICH_DEFINE_ATTR_TYPE_TYPES
349 static const MPI_Datatype mpich_mpi_datatype_null MPICH_ATTR_TYPE_TAG_MUST_BE_NULL() = MPI_DATATYPE_NULL;
350 #endif
351
352 /* These are only guesses; make sure you change them in mpif.h as well */
353 #define MPI_MAX_PROCESSOR_NAME @MPI_MAX_PROCESSOR_NAME@
354 #define MPI_MAX_LIBRARY_VERSION_STRING @MPI_MAX_LIBRARY_VERSION_STRING@
355 #define MPI_MAX_ERROR_STRING   @MPI_MAX_ERROR_STRING@
356 #define MPI_MAX_PORT_NAME      256
357 #define MPI_MAX_OBJECT_NAME    128
358
359 /* Pre-defined constants */
360 #define MPI_UNDEFINED      (-32766)
361 #define MPI_KEYVAL_INVALID 0x24000000
362
363 /* MPI-3 window flavors */
364 typedef enum MPIR_Win_flavor {
365     MPI_WIN_FLAVOR_CREATE      = 1,
366     MPI_WIN_FLAVOR_ALLOCATE    = 2,
367     MPI_WIN_FLAVOR_DYNAMIC     = 3,
368     MPI_WIN_FLAVOR_SHARED      = 4
369 } MPIR_Win_flavor_t;
370
371 /* MPI-3 window consistency models */
372 typedef enum MPIR_Win_model {
373     MPI_WIN_SEPARATE   = 1,
374     MPI_WIN_UNIFIED    = 2
375 } MPIR_Win_model_t;
376
377 /* Upper bound on the overhead in bsend for each message buffer */
378 #define MPI_BSEND_OVERHEAD @BSEND_OVERHEAD@
379
380 /* Topology types */
381 typedef enum MPIR_Topo_type { MPI_GRAPH=1, MPI_CART=2, MPI_DIST_GRAPH=3 } MPIR_Topo_type;
382
383 #define MPI_BOTTOM      (void *)0
384 extern int * const MPI_UNWEIGHTED;
385 extern int * const MPI_WEIGHTS_EMPTY;
386
387 #define MPI_PROC_NULL   (-1)
388 #define MPI_ANY_SOURCE  (-2)
389 #define MPI_ROOT        (-3)
390 #define MPI_ANY_TAG     (-1)
391
392 #define MPI_LOCK_EXCLUSIVE  234
393 #define MPI_LOCK_SHARED     235
394
395 /* C functions */
396 typedef void (MPI_Handler_function) ( MPI_Comm *, int *, ... );
397 typedef int (MPI_Comm_copy_attr_function)(MPI_Comm, int, void *, void *, 
398                                           void *, int *);
399 typedef int (MPI_Comm_delete_attr_function)(MPI_Comm, int, void *, void *);
400 typedef int (MPI_Type_copy_attr_function)(MPI_Datatype, int, void *, void *, 
401                                           void *, int *);
402 typedef int (MPI_Type_delete_attr_function)(MPI_Datatype, int, void *, void *);
403 typedef int (MPI_Win_copy_attr_function)(MPI_Win, int, void *, void *, void *,
404                                          int *);
405 typedef int (MPI_Win_delete_attr_function)(MPI_Win, int, void *, void *);
406 /* added in MPI-2.2 */
407 typedef void (MPI_Comm_errhandler_function)(MPI_Comm *, int *, ...);
408 typedef void (MPI_File_errhandler_function)(MPI_File *, int *, ...);
409 typedef void (MPI_Win_errhandler_function)(MPI_Win *, int *, ...);
410 /* names that were added in MPI-2.0 and deprecated in MPI-2.2 */
411 typedef MPI_Comm_errhandler_function MPI_Comm_errhandler_fn;
412 typedef MPI_File_errhandler_function MPI_File_errhandler_fn;
413 typedef MPI_Win_errhandler_function MPI_Win_errhandler_fn;
414
415 /* Built in (0x1 in 30-31), errhandler (0x5 in bits 26-29, allkind (0
416    in 22-25), index in the low bits */
417 #define MPI_ERRORS_ARE_FATAL ((MPI_Errhandler)0x54000000)
418 #define MPI_ERRORS_RETURN    ((MPI_Errhandler)0x54000001)
419 /* MPIR_ERRORS_THROW_EXCEPTIONS is not part of the MPI standard, it is here to
420    facilitate the c++ binding which has MPI::ERRORS_THROW_EXCEPTIONS. 
421    Using the MPIR prefix preserved the MPI_ names for objects defined by
422    the standard. */
423 #define MPIR_ERRORS_THROW_EXCEPTIONS ((MPI_Errhandler)0x54000002)
424 typedef int MPI_Errhandler;
425
426 /* Make the C names for the dup function mixed case.
427    This is required for systems that use all uppercase names for Fortran 
428    externals.  */
429 /* MPI 1 names */
430 #define MPI_NULL_COPY_FN   ((MPI_Copy_function *)0)
431 #define MPI_NULL_DELETE_FN ((MPI_Delete_function *)0)
432 #define MPI_DUP_FN         MPIR_Dup_fn
433 /* MPI 2 names */
434 #define MPI_COMM_NULL_COPY_FN ((MPI_Comm_copy_attr_function*)0)
435 #define MPI_COMM_NULL_DELETE_FN ((MPI_Comm_delete_attr_function*)0)
436 #define MPI_COMM_DUP_FN  ((MPI_Comm_copy_attr_function *)MPI_DUP_FN)
437 #define MPI_WIN_NULL_COPY_FN ((MPI_Win_copy_attr_function*)0)
438 #define MPI_WIN_NULL_DELETE_FN ((MPI_Win_delete_attr_function*)0)
439 #define MPI_WIN_DUP_FN   ((MPI_Win_copy_attr_function*)MPI_DUP_FN)
440 #define MPI_TYPE_NULL_COPY_FN ((MPI_Type_copy_attr_function*)0)
441 #define MPI_TYPE_NULL_DELETE_FN ((MPI_Type_delete_attr_function*)0)
442 #define MPI_TYPE_DUP_FN ((MPI_Type_copy_attr_function*)MPI_DUP_FN)
443
444 /* MPI request opjects */
445 typedef int MPI_Request;
446
447 /* MPI message objects for Mprobe and related functions */
448 typedef int MPI_Message;
449
450 /* User combination function */
451 typedef void (MPI_User_function) ( void *, void *, int *, MPI_Datatype * ); 
452
453 /* MPI Attribute copy and delete functions */
454 typedef int (MPI_Copy_function) ( MPI_Comm, int, void *, void *, void *, int * );
455 typedef int (MPI_Delete_function) ( MPI_Comm, int, void *, void * );
456
457 #define MPI_VERSION    3
458 #define MPI_SUBVERSION 1
459 #define MPICH_NAME     3
460 #define MPICH         1
461 #define MPICH_HAS_C2F  1
462
463
464 /* MPICH_VERSION is the version string. MPICH_NUMVERSION is the
465  * numeric version that can be used in numeric comparisons.
466  *
467  * MPICH_VERSION uses the following format:
468  * Version: [MAJ].[MIN].[REV][EXT][EXT_NUMBER]
469  * Example: 1.0.7rc1 has
470  *          MAJ = 1
471  *          MIN = 0
472  *          REV = 7
473  *          EXT = rc
474  *          EXT_NUMBER = 1
475  *
476  * MPICH_NUMVERSION will convert EXT to a format number:
477  *          ALPHA (a) = 0
478  *          BETA (b)  = 1
479  *          RC (rc)   = 2
480  *          PATCH (p) = 3
481  * Regular releases are treated as patch 0
482  *
483  * Numeric version will have 1 digit for MAJ, 2 digits for MIN, 2
484  * digits for REV, 1 digit for EXT and 2 digits for EXT_NUMBER. So,
485  * 1.0.7rc1 will have the numeric version 10007201.
486  */
487 #define MPICH_VERSION "@MPICH_VERSION@"
488 #define MPICH_NUMVERSION @MPICH_NUMVERSION@
489
490 #define MPICH_RELEASE_TYPE_ALPHA  0
491 #define MPICH_RELEASE_TYPE_BETA   1
492 #define MPICH_RELEASE_TYPE_RC     2
493 #define MPICH_RELEASE_TYPE_PATCH  3
494
495 #define MPICH_CALC_VERSION(MAJOR, MINOR, REVISION, TYPE, PATCH) \
496     (((MAJOR) * 10000000) + ((MINOR) * 100000) + ((REVISION) * 1000) + ((TYPE) * 100) + (PATCH))
497
498 /* for the datatype decoders */
499 enum MPIR_Combiner_enum {
500     MPI_COMBINER_NAMED            = 1,
501     MPI_COMBINER_DUP              = 2,
502     MPI_COMBINER_CONTIGUOUS       = 3, 
503     MPI_COMBINER_VECTOR           = 4,
504     MPI_COMBINER_HVECTOR_INTEGER  = 5,
505     MPI_COMBINER_HVECTOR          = 6,
506     MPI_COMBINER_INDEXED          = 7,
507     MPI_COMBINER_HINDEXED_INTEGER = 8, 
508     MPI_COMBINER_HINDEXED         = 9, 
509     MPI_COMBINER_INDEXED_BLOCK    = 10, 
510     MPI_COMBINER_STRUCT_INTEGER   = 11,
511     MPI_COMBINER_STRUCT           = 12,
512     MPI_COMBINER_SUBARRAY         = 13,
513     MPI_COMBINER_DARRAY           = 14,
514     MPI_COMBINER_F90_REAL         = 15,
515     MPI_COMBINER_F90_COMPLEX      = 16,
516     MPI_COMBINER_F90_INTEGER      = 17,
517     MPI_COMBINER_RESIZED          = 18,
518     MPI_COMBINER_HINDEXED_BLOCK   = 19
519 };
520
521 /* for info */
522 typedef int MPI_Info;
523 #define MPI_INFO_NULL         ((MPI_Info)0x1c000000)
524 #define MPI_INFO_ENV          ((MPI_Info)0x5c000001)
525 #define MPI_MAX_INFO_KEY       255
526 #define MPI_MAX_INFO_VAL      1024
527
528 /* for subarray and darray constructors */
529 #define MPI_ORDER_C              56
530 #define MPI_ORDER_FORTRAN        57
531 #define MPI_DISTRIBUTE_BLOCK    121
532 #define MPI_DISTRIBUTE_CYCLIC   122
533 #define MPI_DISTRIBUTE_NONE     123
534 #define MPI_DISTRIBUTE_DFLT_DARG -49767
535
536 #define MPI_IN_PLACE  (void *) -1
537
538 /* asserts for one-sided communication */
539 #define MPI_MODE_NOCHECK      1024
540 #define MPI_MODE_NOSTORE      2048
541 #define MPI_MODE_NOPUT        4096
542 #define MPI_MODE_NOPRECEDE    8192
543 #define MPI_MODE_NOSUCCEED   16384 
544
545 /* predefined types for MPI_Comm_split_type */
546 #define MPI_COMM_TYPE_SHARED    1
547
548 /* Definitions that are determined by configure. */
549 typedef @MPI_AINT@ MPI_Aint;
550 typedef @MPI_FINT@ MPI_Fint;
551 typedef @MPI_COUNT@ MPI_Count;
552
553 #ifdef MPICH_DEFINE_ATTR_TYPE_TYPES
554 static const MPI_Datatype mpich_mpi_aint   MPICH_ATTR_TYPE_TAG(MPI_Aint)   = MPI_AINT;
555 #endif
556
557 /* FIXME: The following two definition are not defined by MPI and must not be
558    included in the mpi.h file, as the MPI namespace is reserved to the MPI 
559    standard */
560 #define MPI_AINT_FMT_DEC_SPEC "@MPI_AINT_FMT_DEC_SPEC@"
561 #define MPI_AINT_FMT_HEX_SPEC "@MPI_AINT_FMT_HEX_SPEC@"
562
563 /* Let ROMIO know that MPI_Offset is already defined */
564 #define HAVE_MPI_OFFSET
565 /* MPI_OFFSET_TYPEDEF is set in configure and is 
566       typedef $MPI_OFFSET MPI_Offset;
567    where $MPI_OFFSET is the correct C type */
568 @MPI_OFFSET_TYPEDEF@
569
570 #ifdef MPICH_DEFINE_ATTR_TYPE_TYPES
571 static const MPI_Datatype mpich_mpi_offset MPICH_ATTR_TYPE_TAG(MPI_Offset) = MPI_OFFSET;
572 #endif
573
574 /* The order of these elements must match that in mpif.h, mpi_f08_types.f90,
575    and mpi_c_interface_types.f90 */
576 typedef struct MPI_Status {
577     int count_lo;
578     int count_hi_and_cancelled;
579     int MPI_SOURCE;
580     int MPI_TAG;
581     int MPI_ERROR;
582 } MPI_Status;
583
584 /* types for the MPI_T_ interface */
585 struct MPIR_T_enum_s;
586 struct MPIR_T_cvar_handle_s;
587 struct MPIR_T_pvar_handle_s;
588 struct MPIR_T_pvar_session_s;
589
590 typedef struct MPIR_T_enum_s * MPI_T_enum;
591 typedef struct MPIR_T_cvar_handle_s * MPI_T_cvar_handle;
592 typedef struct MPIR_T_pvar_handle_s * MPI_T_pvar_handle;
593 typedef struct MPIR_T_pvar_session_s * MPI_T_pvar_session;
594
595 /* extra const at front would be safer, but is incompatible with MPI_T_ prototypes */
596 extern struct MPIR_T_pvar_handle_s * const MPI_T_PVAR_ALL_HANDLES;
597
598 #define MPI_T_ENUM_NULL         ((MPI_T_enum)NULL)
599 #define MPI_T_CVAR_HANDLE_NULL  ((MPI_T_cvar_handle)NULL)
600 #define MPI_T_PVAR_HANDLE_NULL  ((MPI_T_pvar_handle)NULL)
601 #define MPI_T_PVAR_SESSION_NULL ((MPI_T_pvar_session)NULL)
602
603 /* the MPI_T_ interface requires that these VERBOSITY constants occur in this
604  * relative order with increasing values */
605 typedef enum MPIR_T_verbosity_t {
606     /* don't name-shift this if/when MPI_T_ is accepted, this is an MPICH-only
607      * extension */
608     MPIX_T_VERBOSITY_INVALID = 0,
609
610     /* arbitrarily shift values to aid debugging and reduce accidental errors */
611     MPI_T_VERBOSITY_USER_BASIC = 221,
612     MPI_T_VERBOSITY_USER_DETAIL,
613     MPI_T_VERBOSITY_USER_ALL,
614
615     MPI_T_VERBOSITY_TUNER_BASIC,
616     MPI_T_VERBOSITY_TUNER_DETAIL,
617     MPI_T_VERBOSITY_TUNER_ALL,
618
619     MPI_T_VERBOSITY_MPIDEV_BASIC,
620     MPI_T_VERBOSITY_MPIDEV_DETAIL,
621     MPI_T_VERBOSITY_MPIDEV_ALL
622 } MPIR_T_verbosity_t;
623
624 typedef enum MPIR_T_bind_t {
625     /* don't name-shift this if/when MPI_T_ is accepted, this is an MPICH-only
626      * extension */
627     MPIX_T_BIND_INVALID = 0,
628
629     /* arbitrarily shift values to aid debugging and reduce accidental errors */
630     MPI_T_BIND_NO_OBJECT = 9700,
631     MPI_T_BIND_MPI_COMM,
632     MPI_T_BIND_MPI_DATATYPE,
633     MPI_T_BIND_MPI_ERRHANDLER,
634     MPI_T_BIND_MPI_FILE,
635     MPI_T_BIND_MPI_GROUP,
636     MPI_T_BIND_MPI_OP,
637     MPI_T_BIND_MPI_REQUEST,
638     MPI_T_BIND_MPI_WIN,
639     MPI_T_BIND_MPI_MESSAGE,
640     MPI_T_BIND_MPI_INFO
641 } MPIR_T_bind_t;
642
643 typedef enum MPIR_T_scope_t {
644     /* don't name-shift this if/when MPI_T_ is accepted, this is an MPICH-only
645      * extension */
646     MPIX_T_SCOPE_INVALID = 0,
647
648     /* arbitrarily shift values to aid debugging and reduce accidental errors */
649     MPI_T_SCOPE_CONSTANT = 60438,
650     MPI_T_SCOPE_READONLY,
651     MPI_T_SCOPE_LOCAL,
652     MPI_T_SCOPE_GROUP,
653     MPI_T_SCOPE_GROUP_EQ,
654     MPI_T_SCOPE_ALL,
655     MPI_T_SCOPE_ALL_EQ
656 } MPIR_T_scope_t;
657
658 typedef enum MPIR_T_pvar_class_t {
659     /* don't name-shift this if/when MPI_T_ is accepted, this is an MPICH-only
660      * extension */
661     MPIX_T_PVAR_CLASS_INVALID = 0,
662
663     /* arbitrarily shift values to aid debugging and reduce accidental errors */
664     MPIR_T_PVAR_CLASS_FIRST = 240,
665     MPI_T_PVAR_CLASS_STATE = MPIR_T_PVAR_CLASS_FIRST,
666     MPI_T_PVAR_CLASS_LEVEL,
667     MPI_T_PVAR_CLASS_SIZE,
668     MPI_T_PVAR_CLASS_PERCENTAGE,
669     MPI_T_PVAR_CLASS_HIGHWATERMARK,
670     MPI_T_PVAR_CLASS_LOWWATERMARK,
671     MPI_T_PVAR_CLASS_COUNTER,
672     MPI_T_PVAR_CLASS_AGGREGATE,
673     MPI_T_PVAR_CLASS_TIMER,
674     MPI_T_PVAR_CLASS_GENERIC,
675     MPIR_T_PVAR_CLASS_LAST,
676     MPIR_T_PVAR_CLASS_NUMBER = MPIR_T_PVAR_CLASS_LAST - MPIR_T_PVAR_CLASS_FIRST
677 } MPIR_T_pvar_class_t;
678
679 /* Handle conversion types/functions */
680
681 /* Programs that need to convert types used in MPICH should use these */
682 #define MPI_Comm_c2f(comm) (MPI_Fint)(comm)
683 #define MPI_Comm_f2c(comm) (MPI_Comm)(comm)
684 #define MPI_Type_c2f(datatype) (MPI_Fint)(datatype)
685 #define MPI_Type_f2c(datatype) (MPI_Datatype)(datatype)
686 #define MPI_Group_c2f(group) (MPI_Fint)(group)
687 #define MPI_Group_f2c(group) (MPI_Group)(group)
688 #define MPI_Info_c2f(info) (MPI_Fint)(info)
689 #define MPI_Info_f2c(info) (MPI_Info)(info)
690 #define MPI_Request_f2c(request) (MPI_Request)(request)
691 #define MPI_Request_c2f(request) (MPI_Fint)(request)
692 #define MPI_Op_c2f(op) (MPI_Fint)(op)
693 #define MPI_Op_f2c(op) (MPI_Op)(op)
694 #define MPI_Errhandler_c2f(errhandler) (MPI_Fint)(errhandler)
695 #define MPI_Errhandler_f2c(errhandler) (MPI_Errhandler)(errhandler)
696 #define MPI_Win_c2f(win)   (MPI_Fint)(win)
697 #define MPI_Win_f2c(win)   (MPI_Win)(win)
698 #define MPI_Message_c2f(msg) ((MPI_Fint)(msg))
699 #define MPI_Message_f2c(msg) ((MPI_Message)(msg))
700
701 /* PMPI versions of the handle transfer functions.  See section 4.17 */
702 #define PMPI_Comm_c2f(comm) (MPI_Fint)(comm)
703 #define PMPI_Comm_f2c(comm) (MPI_Comm)(comm)
704 #define PMPI_Type_c2f(datatype) (MPI_Fint)(datatype)
705 #define PMPI_Type_f2c(datatype) (MPI_Datatype)(datatype)
706 #define PMPI_Group_c2f(group) (MPI_Fint)(group)
707 #define PMPI_Group_f2c(group) (MPI_Group)(group)
708 #define PMPI_Info_c2f(info) (MPI_Fint)(info)
709 #define PMPI_Info_f2c(info) (MPI_Info)(info)
710 #define PMPI_Request_f2c(request) (MPI_Request)(request)
711 #define PMPI_Request_c2f(request) (MPI_Fint)(request)
712 #define PMPI_Op_c2f(op) (MPI_Fint)(op)
713 #define PMPI_Op_f2c(op) (MPI_Op)(op)
714 #define PMPI_Errhandler_c2f(errhandler) (MPI_Fint)(errhandler)
715 #define PMPI_Errhandler_f2c(errhandler) (MPI_Errhandler)(errhandler)
716 #define PMPI_Win_c2f(win)   (MPI_Fint)(win)
717 #define PMPI_Win_f2c(win)   (MPI_Win)(win)
718 #define PMPI_Message_c2f(msg) ((MPI_Fint)(msg))
719 #define PMPI_Message_f2c(msg) ((MPI_Message)(msg))
720
721 #define MPI_STATUS_IGNORE (MPI_Status *)1
722 #define MPI_STATUSES_IGNORE (MPI_Status *)1
723 #define MPI_ERRCODES_IGNORE (int *)0
724
725 /* See 4.12.5 for MPI_F_STATUS(ES)_IGNORE */
726 @MPIU_DLL_SPEC_DEF@
727 extern MPIU_DLL_SPEC MPI_Fint * MPI_F_STATUS_IGNORE;
728 extern MPIU_DLL_SPEC MPI_Fint * MPI_F_STATUSES_IGNORE;
729 /* The annotation MPIU_DLL_SPEC to the extern statements is used 
730    as a hook for systems that require C extensions to correctly construct
731    DLLs, and is defined as an empty string otherwise
732  */
733
734 /* The MPI standard requires that the ARGV_NULL values be the same as
735    NULL (see 5.3.2) */
736 #define MPI_ARGV_NULL (char **)0
737 #define MPI_ARGVS_NULL (char ***)0
738
739 /* C type for MPI_STATUS in F08.
740    The field order should match that in mpi_f08_types.f90, and mpi_c_interface_types.f90.
741  */
742 typedef struct {
743     MPI_Fint count_lo;
744     MPI_Fint count_hi_and_cancelled;
745     MPI_Fint MPI_SOURCE;
746     MPI_Fint MPI_TAG;
747     MPI_Fint MPI_ERROR;
748 } MPI_F08_Status;
749
750 extern MPI_F08_Status MPIR_F08_MPI_STATUS_IGNORE_OBJ;
751 extern MPI_F08_Status MPIR_F08_MPI_STATUSES_IGNORE_OBJ[1];
752 extern int MPIR_F08_MPI_IN_PLACE;
753 extern int MPIR_F08_MPI_BOTTOM;
754
755 /* Pointers to above objects */
756 extern MPI_F08_Status *MPI_F08_STATUS_IGNORE;
757 extern MPI_F08_Status *MPI_F08_STATUSES_IGNORE;
758
759 /* For supported thread levels */
760 #define MPI_THREAD_SINGLE 0
761 #define MPI_THREAD_FUNNELED 1
762 #define MPI_THREAD_SERIALIZED 2
763 #define MPI_THREAD_MULTIPLE 3
764
765 /* Typedefs for generalized requests */
766 typedef int (MPI_Grequest_cancel_function)(void *, int); 
767 typedef int (MPI_Grequest_free_function)(void *); 
768 typedef int (MPI_Grequest_query_function)(void *, MPI_Status *); 
769 typedef int (MPIX_Grequest_poll_function)(void *, MPI_Status *);
770 typedef int (MPIX_Grequest_wait_function)(int, void **, double, MPI_Status *);
771
772 /* MPI's error classes */
773 #define MPI_SUCCESS          0      /* Successful return code */
774 /* Communication argument parameters */
775 #define MPI_ERR_BUFFER       1      /* Invalid buffer pointer */
776 #define MPI_ERR_COUNT        2      /* Invalid count argument */
777 #define MPI_ERR_TYPE         3      /* Invalid datatype argument */
778 #define MPI_ERR_TAG          4      /* Invalid tag argument */
779 #define MPI_ERR_COMM         5      /* Invalid communicator */
780 #define MPI_ERR_RANK         6      /* Invalid rank */
781 #define MPI_ERR_ROOT         7      /* Invalid root */
782 #define MPI_ERR_TRUNCATE    14      /* Message truncated on receive */
783
784 /* MPI Objects (other than COMM) */
785 #define MPI_ERR_GROUP        8      /* Invalid group */
786 #define MPI_ERR_OP           9      /* Invalid operation */
787 #define MPI_ERR_REQUEST     19      /* Invalid mpi_request handle */
788
789 /* Special topology argument parameters */
790 #define MPI_ERR_TOPOLOGY    10      /* Invalid topology */
791 #define MPI_ERR_DIMS        11      /* Invalid dimension argument */
792
793 /* All other arguments.  This is a class with many kinds */
794 #define MPI_ERR_ARG         12      /* Invalid argument */
795
796 /* Other errors that are not simply an invalid argument */
797 #define MPI_ERR_OTHER       15      /* Other error; use Error_string */
798
799 #define MPI_ERR_UNKNOWN     13      /* Unknown error */
800 #define MPI_ERR_INTERN      16      /* Internal error code    */
801
802 /* Multiple completion has three special error classes */
803 #define MPI_ERR_IN_STATUS           17      /* Look in status for error value */
804 #define MPI_ERR_PENDING             18      /* Pending request */
805
806 /* New MPI-2 Error classes */
807 #define MPI_ERR_ACCESS      20      /* */
808 #define MPI_ERR_AMODE       21      /* */
809 #define MPI_ERR_BAD_FILE    22      /* */
810 #define MPI_ERR_CONVERSION  23      /* */
811 #define MPI_ERR_DUP_DATAREP 24      /* */
812 #define MPI_ERR_FILE_EXISTS 25      /* */
813 #define MPI_ERR_FILE_IN_USE 26      /* */
814 #define MPI_ERR_FILE        27      /* */
815 #define MPI_ERR_IO          32      /* */
816 #define MPI_ERR_NO_SPACE    36      /* */
817 #define MPI_ERR_NO_SUCH_FILE 37     /* */
818 #define MPI_ERR_READ_ONLY   40      /* */
819 #define MPI_ERR_UNSUPPORTED_DATAREP   43  /* */
820
821 /* MPI_ERR_INFO is NOT defined in the MPI-2 standard.  I believe that
822    this is an oversight */
823 #define MPI_ERR_INFO        28      /* */
824 #define MPI_ERR_INFO_KEY    29      /* */
825 #define MPI_ERR_INFO_VALUE  30      /* */
826 #define MPI_ERR_INFO_NOKEY  31      /* */
827
828 #define MPI_ERR_NAME        33      /* */
829 #define MPI_ERR_NO_MEM      34      /* Alloc_mem could not allocate memory */
830 #define MPI_ERR_NOT_SAME    35      /* */
831 #define MPI_ERR_PORT        38      /* */
832 #define MPI_ERR_QUOTA       39      /* */
833 #define MPI_ERR_SERVICE     41      /* */
834 #define MPI_ERR_SPAWN       42      /* */
835 #define MPI_ERR_UNSUPPORTED_OPERATION 44 /* */
836 #define MPI_ERR_WIN         45      /* */
837
838 #define MPI_ERR_BASE        46      /* */
839 #define MPI_ERR_LOCKTYPE    47      /* */
840 #define MPI_ERR_KEYVAL      48      /* Erroneous attribute key */
841 #define MPI_ERR_RMA_CONFLICT 49     /* */
842 #define MPI_ERR_RMA_SYNC    50      /* */ 
843 #define MPI_ERR_SIZE        51      /* */
844 #define MPI_ERR_DISP        52      /* */
845 #define MPI_ERR_ASSERT      53      /* */
846
847 #define MPI_ERR_RMA_RANGE  55       /* */
848 #define MPI_ERR_RMA_ATTACH 56       /* */
849 #define MPI_ERR_RMA_SHARED 57       /* */
850 #define MPI_ERR_RMA_FLAVOR 58       /* */
851
852 /* Return codes for functions in the MPI Tool Information Interface */
853 #define MPI_T_ERR_MEMORY            59  /* Out of memory */
854 #define MPI_T_ERR_NOT_INITIALIZED   60  /* Interface not initialized */
855 #define MPI_T_ERR_CANNOT_INIT       61  /* Interface not in the state to
856                                            be initialized */
857 #define MPI_T_ERR_INVALID_INDEX     62  /* The index is invalid or
858                                            has been deleted  */
859 #define MPI_T_ERR_INVALID_ITEM      63  /* Item index queried is out of range */
860 #define MPI_T_ERR_INVALID_HANDLE    64  /* The handle is invalid */
861 #define MPI_T_ERR_OUT_OF_HANDLES    65  /* No more handles available */
862 #define MPI_T_ERR_OUT_OF_SESSIONS   66  /* No more sessions available */
863 #define MPI_T_ERR_INVALID_SESSION   67  /* Session argument is not valid */
864 #define MPI_T_ERR_CVAR_SET_NOT_NOW  68  /* Cvar can't be set at this moment */
865 #define MPI_T_ERR_CVAR_SET_NEVER    69  /* Cvar can't be set until
866                                            end of execution */
867 #define MPI_T_ERR_PVAR_NO_STARTSTOP 70  /* Pvar can't be started or stopped */
868 #define MPI_T_ERR_PVAR_NO_WRITE     71  /* Pvar can't be written or reset */
869 #define MPI_T_ERR_PVAR_NO_ATOMIC    72  /* Pvar can't be R/W atomically */
870 #define MPI_T_ERR_INVALID_NAME      73  /* Name doesn't match */
871 #define MPI_T_ERR_INVALID           74  /* Generic error code for MPI_T added in MPI-3.1 */
872
873
874 #define MPI_ERR_LASTCODE    0x3fffffff  /* Last valid error code for a 
875                                            predefined error class */
876 /* WARNING: this is also defined in mpishared.h.  Update both locations */
877 #define MPICH_ERR_LAST_CLASS 74     /* It is also helpful to know the
878                                        last valid class */
879
880 #define MPICH_ERR_FIRST_MPIX 100 /* Define a gap here because sock is
881                                   * already using some of the values in this
882                                   * range. All MPIX error codes will be
883                                   * above this value to be ABI complaint. */
884
885 #define MPIX_ERR_PROC_FAILED          MPICH_ERR_FIRST_MPIX+1 /* Process failure */
886 #define MPIX_ERR_PROC_FAILED_PENDING  MPICH_ERR_FIRST_MPIX+2 /* A failure has caused this request
887                                                               * to be pending */
888 #define MPIX_ERR_REVOKED              MPICH_ERR_FIRST_MPIX+3 /* The communciation object has been revoked */
889
890 #define MPICH_ERR_LAST_MPIX           MPICH_ERR_FIRST_MPIX+3
891
892
893 /* End of MPI's error classes */
894
895 /* Function type defs */
896 typedef int (MPI_Datarep_conversion_function)(void *, MPI_Datatype, int, 
897              void *, MPI_Offset, void *);
898 typedef int (MPI_Datarep_extent_function)(MPI_Datatype datatype, MPI_Aint *,
899                       void *);
900 #define MPI_CONVERSION_FN_NULL ((MPI_Datarep_conversion_function *)0)
901
902 /* 
903    For systems that may need to add additional definitions to support
904    different declaration styles and options (e.g., different calling 
905    conventions or DLL import/export controls).  
906 */
907 /* --Insert Additional Definitions Here-- */
908
909 /*
910  * Normally, we provide prototypes for all MPI routines.  In a few weird
911  * cases, we need to suppress the prototypes.
912  */
913 #ifndef MPICH_SUPPRESS_PROTOTYPES
914 /* We require that the C compiler support prototypes */
915 /* Begin Prototypes */
916 int MPI_Send(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
917              MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
918 int MPI_Recv(void *buf, int count, MPI_Datatype datatype, int source, int tag,
919              MPI_Comm comm, MPI_Status *status) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
920 int MPI_Get_count(const MPI_Status *status, MPI_Datatype datatype, int *count);
921 int MPI_Bsend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
922               MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
923 int MPI_Ssend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
924               MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
925 int MPI_Rsend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
926               MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
927 int MPI_Buffer_attach(void *buffer, int size);
928 int MPI_Buffer_detach(void *buffer_addr, int *size);
929 int MPI_Isend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
930               MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
931 int MPI_Ibsend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
932                MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
933 int MPI_Issend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
934                MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
935 int MPI_Irsend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
936                MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
937 int MPI_Irecv(void *buf, int count, MPI_Datatype datatype, int source, int tag,
938               MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
939 int MPI_Wait(MPI_Request *request, MPI_Status *status);
940 int MPI_Test(MPI_Request *request, int *flag, MPI_Status *status);
941 int MPI_Request_free(MPI_Request *request);
942 int MPI_Waitany(int count, MPI_Request array_of_requests[], int *indx, MPI_Status *status);
943 int MPI_Testany(int count, MPI_Request array_of_requests[], int *indx, int *flag,
944                 MPI_Status *status);
945 int MPI_Waitall(int count, MPI_Request array_of_requests[], MPI_Status array_of_statuses[]);
946 int MPI_Testall(int count, MPI_Request array_of_requests[], int *flag,
947                 MPI_Status array_of_statuses[]);
948 int MPI_Waitsome(int incount, MPI_Request array_of_requests[], int *outcount,
949                  int array_of_indices[], MPI_Status array_of_statuses[]);
950 int MPI_Testsome(int incount, MPI_Request array_of_requests[], int *outcount,
951                  int array_of_indices[], MPI_Status array_of_statuses[]);
952 int MPI_Iprobe(int source, int tag, MPI_Comm comm, int *flag, MPI_Status *status);
953 int MPI_Probe(int source, int tag, MPI_Comm comm, MPI_Status *status);
954 int MPI_Cancel(MPI_Request *request);
955 int MPI_Test_cancelled(const MPI_Status *status, int *flag);
956 int MPI_Send_init(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
957                   MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
958 int MPI_Bsend_init(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
959                    MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
960 int MPI_Ssend_init(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
961                    MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
962 int MPI_Rsend_init(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
963                    MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
964 int MPI_Recv_init(void *buf, int count, MPI_Datatype datatype, int source, int tag,
965                   MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
966 int MPI_Start(MPI_Request *request);
967 int MPI_Startall(int count, MPI_Request array_of_requests[]);
968 int MPI_Sendrecv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, int dest,
969                  int sendtag, void *recvbuf, int recvcount, MPI_Datatype recvtype,
970                  int source, int recvtag, MPI_Comm comm, MPI_Status *status)
971                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(6,8);
972 int MPI_Sendrecv_replace(void *buf, int count, MPI_Datatype datatype, int dest,
973                          int sendtag, int source, int recvtag, MPI_Comm comm,
974                          MPI_Status *status) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
975 int MPI_Type_contiguous(int count, MPI_Datatype oldtype, MPI_Datatype *newtype);
976 int MPI_Type_vector(int count, int blocklength, int stride, MPI_Datatype oldtype,
977                     MPI_Datatype *newtype);
978 int MPI_Type_hvector(int count, int blocklength, MPI_Aint stride, MPI_Datatype oldtype,
979                      MPI_Datatype *newtype);
980 int MPI_Type_indexed(int count, const int *array_of_blocklengths,
981                      const int *array_of_displacements, MPI_Datatype oldtype,
982                      MPI_Datatype *newtype);
983 int MPI_Type_hindexed(int count, const int *array_of_blocklengths,
984                       const MPI_Aint *array_of_displacements, MPI_Datatype oldtype,
985                       MPI_Datatype *newtype);
986 int MPI_Type_struct(int count, const int *array_of_blocklengths,
987                     const MPI_Aint *array_of_displacements,
988                     const MPI_Datatype *array_of_types, MPI_Datatype *newtype);
989 int MPI_Address(const void *location, MPI_Aint *address);
990 int MPI_Type_extent(MPI_Datatype datatype, MPI_Aint *extent);
991 int MPI_Type_size(MPI_Datatype datatype, int *size);
992 int MPI_Type_lb(MPI_Datatype datatype, MPI_Aint *displacement);
993 int MPI_Type_ub(MPI_Datatype datatype, MPI_Aint *displacement);
994 int MPI_Type_commit(MPI_Datatype *datatype);
995 int MPI_Type_free(MPI_Datatype *datatype);
996 int MPI_Get_elements(const MPI_Status *status, MPI_Datatype datatype, int *count);
997 int MPI_Pack(const void *inbuf, int incount, MPI_Datatype datatype, void *outbuf,
998              int outsize, int *position, MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
999 int MPI_Unpack(const void *inbuf, int insize, int *position, void *outbuf, int outcount,
1000                MPI_Datatype datatype, MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1001 int MPI_Pack_size(int incount, MPI_Datatype datatype, MPI_Comm comm, int *size);
1002 int MPI_Barrier(MPI_Comm comm);
1003 int MPI_Bcast(void *buffer, int count, MPI_Datatype datatype, int root, MPI_Comm comm)
1004               MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1005 int MPI_Gather(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1006                int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm)
1007                MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1008 int MPI_Gatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1009                 const int *recvcounts, const int *displs, MPI_Datatype recvtype, int root,
1010                 MPI_Comm comm)
1011                 MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
1012 int MPI_Scatter(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1013                 int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm)
1014                 MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1015 int MPI_Scatterv(const void *sendbuf, const int *sendcounts, const int *displs,
1016                  MPI_Datatype sendtype, void *recvbuf, int recvcount, MPI_Datatype recvtype,
1017                  int root, MPI_Comm comm)
1018                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,7);
1019 int MPI_Allgather(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1020                   int recvcount, MPI_Datatype recvtype, MPI_Comm comm)
1021                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1022 int MPI_Allgatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1023                    const int *recvcounts, const int *displs, MPI_Datatype recvtype, MPI_Comm comm)
1024                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
1025 int MPI_Alltoall(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1026                  int recvcount, MPI_Datatype recvtype, MPI_Comm comm)
1027                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1028 int MPI_Alltoallv(const void *sendbuf, const int *sendcounts, const int *sdispls,
1029                   MPI_Datatype sendtype, void *recvbuf, const int *recvcounts,
1030                   const int *rdispls, MPI_Datatype recvtype, MPI_Comm comm)
1031                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,8);
1032 int MPI_Alltoallw(const void *sendbuf, const int sendcounts[], const int sdispls[],
1033                   const MPI_Datatype sendtypes[], void *recvbuf, const int recvcounts[],
1034                   const int rdispls[], const MPI_Datatype recvtypes[], MPI_Comm comm);
1035 int MPI_Exscan(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1036                MPI_Op op, MPI_Comm comm)
1037                MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1038 int MPI_Reduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1039                MPI_Op op, int root, MPI_Comm comm)
1040                MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1041 int MPI_Op_create(MPI_User_function *user_fn, int commute, MPI_Op *op);
1042 int MPI_Op_free(MPI_Op *op);
1043 int MPI_Allreduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1044                   MPI_Op op, MPI_Comm comm)
1045                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1046 int MPI_Reduce_scatter(const void *sendbuf, void *recvbuf, const int recvcounts[],
1047                        MPI_Datatype datatype, MPI_Op op, MPI_Comm comm)
1048                        MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1049 int MPI_Scan(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype, MPI_Op op,
1050              MPI_Comm comm)
1051              MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1052 int MPI_Group_size(MPI_Group group, int *size);
1053 int MPI_Group_rank(MPI_Group group, int *rank);
1054 int MPI_Group_translate_ranks(MPI_Group group1, int n, const int ranks1[], MPI_Group group2,
1055                               int ranks2[]);
1056 int MPI_Group_compare(MPI_Group group1, MPI_Group group2, int *result);
1057 int MPI_Comm_group(MPI_Comm comm, MPI_Group *group);
1058 int MPI_Group_union(MPI_Group group1, MPI_Group group2, MPI_Group *newgroup);
1059 int MPI_Group_intersection(MPI_Group group1, MPI_Group group2, MPI_Group *newgroup);
1060 int MPI_Group_difference(MPI_Group group1, MPI_Group group2, MPI_Group *newgroup);
1061 int MPI_Group_incl(MPI_Group group, int n, const int ranks[], MPI_Group *newgroup);
1062 int MPI_Group_excl(MPI_Group group, int n, const int ranks[], MPI_Group *newgroup);
1063 int MPI_Group_range_incl(MPI_Group group, int n, int ranges[][3], MPI_Group *newgroup);
1064 int MPI_Group_range_excl(MPI_Group group, int n, int ranges[][3], MPI_Group *newgroup);
1065 int MPI_Group_free(MPI_Group *group);
1066 int MPI_Comm_size(MPI_Comm comm, int *size);
1067 int MPI_Comm_rank(MPI_Comm comm, int *rank);
1068 int MPI_Comm_compare(MPI_Comm comm1, MPI_Comm comm2, int *result);
1069 int MPI_Comm_dup(MPI_Comm comm, MPI_Comm *newcomm);
1070 int MPI_Comm_dup_with_info(MPI_Comm comm, MPI_Info info, MPI_Comm *newcomm);
1071 int MPI_Comm_create(MPI_Comm comm, MPI_Group group, MPI_Comm *newcomm);
1072 int MPI_Comm_split(MPI_Comm comm, int color, int key, MPI_Comm *newcomm);
1073 int MPI_Comm_free(MPI_Comm *comm);
1074 int MPI_Comm_test_inter(MPI_Comm comm, int *flag);
1075 int MPI_Comm_remote_size(MPI_Comm comm, int *size);
1076 int MPI_Comm_remote_group(MPI_Comm comm, MPI_Group *group);
1077 int MPI_Intercomm_create(MPI_Comm local_comm, int local_leader, MPI_Comm peer_comm,
1078                          int remote_leader, int tag, MPI_Comm *newintercomm);
1079 int MPI_Intercomm_merge(MPI_Comm intercomm, int high, MPI_Comm *newintracomm);
1080 int MPI_Keyval_create(MPI_Copy_function *copy_fn, MPI_Delete_function *delete_fn,
1081                       int *keyval, void *extra_state);
1082 int MPI_Keyval_free(int *keyval);
1083 int MPI_Attr_put(MPI_Comm comm, int keyval, void *attribute_val);
1084 int MPI_Attr_get(MPI_Comm comm, int keyval, void *attribute_val, int *flag);
1085 int MPI_Attr_delete(MPI_Comm comm, int keyval);
1086 int MPI_Topo_test(MPI_Comm comm, int *status);
1087 int MPI_Cart_create(MPI_Comm comm_old, int ndims, const int dims[], const int periods[],
1088                     int reorder, MPI_Comm *comm_cart);
1089 int MPI_Dims_create(int nnodes, int ndims, int dims[]);
1090 int MPI_Graph_create(MPI_Comm comm_old, int nnodes, const int indx[], const int edges[],
1091                      int reorder, MPI_Comm *comm_graph);
1092 int MPI_Graphdims_get(MPI_Comm comm, int *nnodes, int *nedges);
1093 int MPI_Graph_get(MPI_Comm comm, int maxindex, int maxedges, int indx[], int edges[]);
1094 int MPI_Cartdim_get(MPI_Comm comm, int *ndims);
1095 int MPI_Cart_get(MPI_Comm comm, int maxdims, int dims[], int periods[], int coords[]);
1096 int MPI_Cart_rank(MPI_Comm comm, const int coords[], int *rank);
1097 int MPI_Cart_coords(MPI_Comm comm, int rank, int maxdims, int coords[]);
1098 int MPI_Graph_neighbors_count(MPI_Comm comm, int rank, int *nneighbors);
1099 int MPI_Graph_neighbors(MPI_Comm comm, int rank, int maxneighbors, int neighbors[]);
1100 int MPI_Cart_shift(MPI_Comm comm, int direction, int disp, int *rank_source, int *rank_dest);
1101 int MPI_Cart_sub(MPI_Comm comm, const int remain_dims[], MPI_Comm *newcomm);
1102 int MPI_Cart_map(MPI_Comm comm, int ndims, const int dims[], const int periods[], int *newrank);
1103 int MPI_Graph_map(MPI_Comm comm, int nnodes, const int indx[], const int edges[], int *newrank);
1104 int MPI_Get_processor_name(char *name, int *resultlen);
1105 int MPI_Get_version(int *version, int *subversion);
1106 int MPI_Get_library_version(char *version, int *resultlen);
1107 int MPI_Errhandler_create(MPI_Handler_function *function, MPI_Errhandler *errhandler);
1108 int MPI_Errhandler_set(MPI_Comm comm, MPI_Errhandler errhandler);
1109 int MPI_Errhandler_get(MPI_Comm comm, MPI_Errhandler *errhandler);
1110 int MPI_Errhandler_free(MPI_Errhandler *errhandler);
1111 int MPI_Error_string(int errorcode, char *string, int *resultlen);
1112 int MPI_Error_class(int errorcode, int *errorclass);
1113 double MPI_Wtime(void);
1114 double MPI_Wtick(void);
1115 int MPI_Init(int *argc, char ***argv);
1116 int MPI_Finalize(void);
1117 int MPI_Initialized(int *flag);
1118 int MPI_Abort(MPI_Comm comm, int errorcode);
1119
1120 /* Note that we may need to define a @PCONTROL_LIST@ depending on whether
1121    stdargs are supported */
1122 int MPI_Pcontrol(const int level, ...);
1123 int MPI_DUP_FN(MPI_Comm oldcomm, int keyval, void *extra_state, void *attribute_val_in,
1124                void *attribute_val_out, int *flag);
1125
1126 /* Process Creation and Management */
1127 int MPI_Close_port(const char *port_name);
1128 int MPI_Comm_accept(const char *port_name, MPI_Info info, int root, MPI_Comm comm,
1129                     MPI_Comm *newcomm);
1130 int MPI_Comm_connect(const char *port_name, MPI_Info info, int root, MPI_Comm comm,
1131                      MPI_Comm *newcomm);
1132 int MPI_Comm_disconnect(MPI_Comm *comm);
1133 int MPI_Comm_get_parent(MPI_Comm *parent);
1134 int MPI_Comm_join(int fd, MPI_Comm *intercomm);
1135 int MPI_Comm_spawn(const char *command, char *argv[], int maxprocs, MPI_Info info, int root,
1136                    MPI_Comm comm, MPI_Comm *intercomm, int array_of_errcodes[]);
1137 int MPI_Comm_spawn_multiple(int count, char *array_of_commands[], char **array_of_argv[],
1138                             const int array_of_maxprocs[], const MPI_Info array_of_info[],
1139                             int root, MPI_Comm comm, MPI_Comm *intercomm, int array_of_errcodes[]);
1140 int MPI_Lookup_name(const char *service_name, MPI_Info info, char *port_name);
1141 int MPI_Open_port(MPI_Info info, char *port_name);
1142 int MPI_Publish_name(const char *service_name, MPI_Info info, const char *port_name);
1143 int MPI_Unpublish_name(const char *service_name, MPI_Info info, const char *port_name);
1144 int MPI_Comm_set_info(MPI_Comm comm, MPI_Info info);
1145 int MPI_Comm_get_info(MPI_Comm comm, MPI_Info *info);
1146
1147 /* One-Sided Communications */
1148 int MPI_Accumulate(const void *origin_addr, int origin_count, MPI_Datatype origin_datatype,
1149                    int target_rank, MPI_Aint target_disp, int target_count,
1150                    MPI_Datatype target_datatype, MPI_Op op, MPI_Win win)
1151                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1152 int MPI_Get(void *origin_addr, int origin_count, MPI_Datatype origin_datatype,
1153             int target_rank, MPI_Aint target_disp, int target_count,
1154             MPI_Datatype target_datatype, MPI_Win win) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1155 int MPI_Put(const void *origin_addr, int origin_count, MPI_Datatype origin_datatype,
1156             int target_rank, MPI_Aint target_disp, int target_count,
1157             MPI_Datatype target_datatype, MPI_Win win) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1158 int MPI_Win_complete(MPI_Win win);
1159 int MPI_Win_create(void *base, MPI_Aint size, int disp_unit, MPI_Info info, MPI_Comm comm,
1160                    MPI_Win *win);
1161 int MPI_Win_fence(int assert, MPI_Win win);
1162 int MPI_Win_free(MPI_Win *win);
1163 int MPI_Win_get_group(MPI_Win win, MPI_Group *group);
1164 int MPI_Win_lock(int lock_type, int rank, int assert, MPI_Win win);
1165 int MPI_Win_post(MPI_Group group, int assert, MPI_Win win);
1166 int MPI_Win_start(MPI_Group group, int assert, MPI_Win win);
1167 int MPI_Win_test(MPI_Win win, int *flag);
1168 int MPI_Win_unlock(int rank, MPI_Win win);
1169 int MPI_Win_wait(MPI_Win win);
1170
1171 /* MPI-3 One-Sided Communication Routines */
1172 int MPI_Win_allocate(MPI_Aint size, int disp_unit, MPI_Info info, MPI_Comm comm, void *baseptr,
1173                      MPI_Win *win);
1174 int MPI_Win_allocate_shared(MPI_Aint size, int disp_unit, MPI_Info info, MPI_Comm comm,
1175                             void *baseptr, MPI_Win *win);
1176 int MPI_Win_shared_query(MPI_Win win, int rank, MPI_Aint *size, int *disp_unit, void *baseptr);
1177 int MPI_Win_create_dynamic(MPI_Info info, MPI_Comm comm, MPI_Win *win);
1178 int MPI_Win_attach(MPI_Win win, void *base, MPI_Aint size);
1179 int MPI_Win_detach(MPI_Win win, const void *base);
1180 int MPI_Win_get_info(MPI_Win win, MPI_Info *info_used);
1181 int MPI_Win_set_info(MPI_Win win, MPI_Info info);
1182 int MPI_Get_accumulate(const void *origin_addr, int origin_count,
1183                         MPI_Datatype origin_datatype, void *result_addr, int result_count,
1184                         MPI_Datatype result_datatype, int target_rank, MPI_Aint target_disp,
1185                         int target_count, MPI_Datatype target_datatype, MPI_Op op, MPI_Win win)
1186                         MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1187                         MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1188 int MPI_Fetch_and_op(const void *origin_addr, void *result_addr,
1189                       MPI_Datatype datatype, int target_rank, MPI_Aint target_disp,
1190                       MPI_Op op, MPI_Win win)
1191                       MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1192 int MPI_Compare_and_swap(const void *origin_addr, const void *compare_addr,
1193                           void *result_addr, MPI_Datatype datatype, int target_rank,
1194                           MPI_Aint target_disp, MPI_Win win)
1195                           MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
1196                           MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4)
1197                           MPICH_ATTR_POINTER_WITH_TYPE_TAG(3,4);
1198 int MPI_Rput(const void *origin_addr, int origin_count,
1199               MPI_Datatype origin_datatype, int target_rank, MPI_Aint target_disp,
1200               int target_count, MPI_Datatype target_datatype, MPI_Win win,
1201               MPI_Request *request)
1202               MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1203 int MPI_Rget(void *origin_addr, int origin_count,
1204               MPI_Datatype origin_datatype, int target_rank, MPI_Aint target_disp,
1205               int target_count, MPI_Datatype target_datatype, MPI_Win win,
1206               MPI_Request *request)
1207               MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1208 int MPI_Raccumulate(const void *origin_addr, int origin_count,
1209                      MPI_Datatype origin_datatype, int target_rank, MPI_Aint target_disp,
1210                      int target_count, MPI_Datatype target_datatype, MPI_Op op, MPI_Win win,
1211                      MPI_Request *request)
1212                      MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1213 int MPI_Rget_accumulate(const void *origin_addr, int origin_count,
1214                          MPI_Datatype origin_datatype, void *result_addr, int result_count,
1215                          MPI_Datatype result_datatype, int target_rank, MPI_Aint target_disp,
1216                          int target_count, MPI_Datatype target_datatype, MPI_Op op, MPI_Win win,
1217                          MPI_Request *request)
1218                          MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1219                          MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1220 int MPI_Win_lock_all(int assert, MPI_Win win);
1221 int MPI_Win_unlock_all(MPI_Win win);
1222 int MPI_Win_flush(int rank, MPI_Win win);
1223 int MPI_Win_flush_all(MPI_Win win);
1224 int MPI_Win_flush_local(int rank, MPI_Win win);
1225 int MPI_Win_flush_local_all(MPI_Win win);
1226 int MPI_Win_sync(MPI_Win win);
1227  
1228 /* External Interfaces */
1229 int MPI_Add_error_class(int *errorclass);
1230 int MPI_Add_error_code(int errorclass, int *errorcode);
1231 int MPI_Add_error_string(int errorcode, const char *string);
1232 int MPI_Comm_call_errhandler(MPI_Comm comm, int errorcode);
1233 int MPI_Comm_create_keyval(MPI_Comm_copy_attr_function *comm_copy_attr_fn,
1234                            MPI_Comm_delete_attr_function *comm_delete_attr_fn, int *comm_keyval,
1235                            void *extra_state);
1236 int MPI_Comm_delete_attr(MPI_Comm comm, int comm_keyval);
1237 int MPI_Comm_free_keyval(int *comm_keyval);
1238 int MPI_Comm_get_attr(MPI_Comm comm, int comm_keyval, void *attribute_val, int *flag);
1239 int MPI_Comm_get_name(MPI_Comm comm, char *comm_name, int *resultlen);
1240 int MPI_Comm_set_attr(MPI_Comm comm, int comm_keyval, void *attribute_val);
1241 int MPI_Comm_set_name(MPI_Comm comm, const char *comm_name);
1242 int MPI_File_call_errhandler(MPI_File fh, int errorcode);
1243 int MPI_Grequest_complete(MPI_Request request);
1244 int MPI_Grequest_start(MPI_Grequest_query_function *query_fn, MPI_Grequest_free_function *free_fn,
1245                        MPI_Grequest_cancel_function *cancel_fn, void *extra_state,
1246                        MPI_Request *request);
1247 int MPI_Init_thread(int *argc, char ***argv, int required, int *provided);
1248 int MPI_Is_thread_main(int *flag);
1249 int MPI_Query_thread(int *provided);
1250 int MPI_Status_set_cancelled(MPI_Status *status, int flag);
1251 int MPI_Status_set_elements(MPI_Status *status, MPI_Datatype datatype, int count);
1252 int MPI_Type_create_keyval(MPI_Type_copy_attr_function *type_copy_attr_fn,
1253                            MPI_Type_delete_attr_function *type_delete_attr_fn,
1254                            int *type_keyval, void *extra_state);
1255 int MPI_Type_delete_attr(MPI_Datatype datatype, int type_keyval);
1256 int MPI_Type_dup(MPI_Datatype oldtype, MPI_Datatype *newtype);
1257 int MPI_Type_free_keyval(int *type_keyval);
1258 int MPI_Type_get_attr(MPI_Datatype datatype, int type_keyval, void *attribute_val, int *flag);
1259 int MPI_Type_get_contents(MPI_Datatype datatype, int max_integers, int max_addresses,
1260                           int max_datatypes, int array_of_integers[],
1261                           MPI_Aint array_of_addresses[], MPI_Datatype array_of_datatypes[]);
1262 int MPI_Type_get_envelope(MPI_Datatype datatype, int *num_integers, int *num_addresses,
1263                           int *num_datatypes, int *combiner);
1264 int MPI_Type_get_name(MPI_Datatype datatype, char *type_name, int *resultlen);
1265 int MPI_Type_set_attr(MPI_Datatype datatype, int type_keyval, void *attribute_val);
1266 int MPI_Type_set_name(MPI_Datatype datatype, const char *type_name);
1267 int MPI_Type_match_size(int typeclass, int size, MPI_Datatype *datatype);
1268 int MPI_Win_call_errhandler(MPI_Win win, int errorcode);
1269 int MPI_Win_create_keyval(MPI_Win_copy_attr_function *win_copy_attr_fn,
1270                           MPI_Win_delete_attr_function *win_delete_attr_fn, int *win_keyval,
1271                           void *extra_state);
1272 int MPI_Win_delete_attr(MPI_Win win, int win_keyval);
1273 int MPI_Win_free_keyval(int *win_keyval);
1274 int MPI_Win_get_attr(MPI_Win win, int win_keyval, void *attribute_val, int *flag);
1275 int MPI_Win_get_name(MPI_Win win, char *win_name, int *resultlen);
1276 int MPI_Win_set_attr(MPI_Win win, int win_keyval, void *attribute_val);
1277 int MPI_Win_set_name(MPI_Win win, const char *win_name);
1278
1279 int MPI_Alloc_mem(MPI_Aint size, MPI_Info info, void *baseptr);
1280 int MPI_Comm_create_errhandler(MPI_Comm_errhandler_function *comm_errhandler_fn,
1281                                MPI_Errhandler *errhandler);
1282 int MPI_Comm_get_errhandler(MPI_Comm comm, MPI_Errhandler *errhandler);
1283 int MPI_Comm_set_errhandler(MPI_Comm comm, MPI_Errhandler errhandler);
1284 int MPI_File_create_errhandler(MPI_File_errhandler_function *file_errhandler_fn,
1285                                MPI_Errhandler *errhandler);
1286 int MPI_File_get_errhandler(MPI_File file, MPI_Errhandler *errhandler);
1287 int MPI_File_set_errhandler(MPI_File file, MPI_Errhandler errhandler);
1288 int MPI_Finalized(int *flag);
1289 int MPI_Free_mem(void *base);
1290 int MPI_Get_address(const void *location, MPI_Aint *address);
1291 int MPI_Info_create(MPI_Info *info);
1292 int MPI_Info_delete(MPI_Info info, const char *key);
1293 int MPI_Info_dup(MPI_Info info, MPI_Info *newinfo);
1294 int MPI_Info_free(MPI_Info *info);
1295 int MPI_Info_get(MPI_Info info, const char *key, int valuelen, char *value, int *flag);
1296 int MPI_Info_get_nkeys(MPI_Info info, int *nkeys);
1297 int MPI_Info_get_nthkey(MPI_Info info, int n, char *key);
1298 int MPI_Info_get_valuelen(MPI_Info info, const char *key, int *valuelen, int *flag);
1299 int MPI_Info_set(MPI_Info info, const char *key, const char *value);
1300 int MPI_Pack_external(const char datarep[], const void *inbuf, int incount,
1301                       MPI_Datatype datatype, void *outbuf, MPI_Aint outsize, MPI_Aint *position)
1302                       MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1303 int MPI_Pack_external_size(const char datarep[], int incount, MPI_Datatype datatype,
1304                            MPI_Aint *size);
1305 int MPI_Request_get_status(MPI_Request request, int *flag, MPI_Status *status);
1306 int MPI_Status_c2f(const MPI_Status *c_status, MPI_Fint *f_status);
1307 int MPI_Status_f2c(const MPI_Fint *f_status, MPI_Status *c_status);
1308 int MPI_Type_create_darray(int size, int rank, int ndims, const int array_of_gsizes[],
1309                            const int array_of_distribs[], const int array_of_dargs[],
1310                            const int array_of_psizes[], int order, MPI_Datatype oldtype,
1311                            MPI_Datatype *newtype);
1312 int MPI_Type_create_hindexed(int count, const int array_of_blocklengths[],
1313                              const MPI_Aint array_of_displacements[], MPI_Datatype oldtype,
1314                              MPI_Datatype *newtype);
1315 int MPI_Type_create_hvector(int count, int blocklength, MPI_Aint stride, MPI_Datatype oldtype,
1316                             MPI_Datatype *newtype);
1317 int MPI_Type_create_indexed_block(int count, int blocklength, const int array_of_displacements[],
1318                                   MPI_Datatype oldtype, MPI_Datatype *newtype);
1319 int MPI_Type_create_hindexed_block(int count, int blocklength,
1320                                    const MPI_Aint array_of_displacements[],
1321                                    MPI_Datatype oldtype, MPI_Datatype *newtype);
1322 int MPI_Type_create_resized(MPI_Datatype oldtype, MPI_Aint lb, MPI_Aint extent,
1323                             MPI_Datatype *newtype);
1324 int MPI_Type_create_struct(int count, const int array_of_blocklengths[],
1325                            const MPI_Aint array_of_displacements[],
1326                            const MPI_Datatype array_of_types[], MPI_Datatype *newtype);
1327 int MPI_Type_create_subarray(int ndims, const int array_of_sizes[],
1328                              const int array_of_subsizes[], const int array_of_starts[],
1329                              int order, MPI_Datatype oldtype, MPI_Datatype *newtype);
1330 int MPI_Type_get_extent(MPI_Datatype datatype, MPI_Aint *lb, MPI_Aint *extent);
1331 int MPI_Type_get_true_extent(MPI_Datatype datatype, MPI_Aint *true_lb, MPI_Aint *true_extent);
1332 int MPI_Unpack_external(const char datarep[], const void *inbuf, MPI_Aint insize,
1333                         MPI_Aint *position, void *outbuf, int outcount, MPI_Datatype datatype)
1334                         MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,7);
1335 int MPI_Win_create_errhandler(MPI_Win_errhandler_function *win_errhandler_fn,
1336                               MPI_Errhandler *errhandler);
1337 int MPI_Win_get_errhandler(MPI_Win win, MPI_Errhandler *errhandler);
1338 int MPI_Win_set_errhandler(MPI_Win win, MPI_Errhandler errhandler);
1339
1340 /* Fortran 90-related functions.  These routines are available only if
1341    Fortran 90 support is enabled 
1342 */
1343 int MPI_Type_create_f90_integer(int range, MPI_Datatype *newtype);
1344 int MPI_Type_create_f90_real(int precision, int range, MPI_Datatype *newtype);
1345 int MPI_Type_create_f90_complex(int precision, int range, MPI_Datatype *newtype);
1346
1347 int MPI_Reduce_local(const void *inbuf, void *inoutbuf, int count, MPI_Datatype datatype,
1348                      MPI_Op op)
1349                      MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1350 int MPI_Op_commutative(MPI_Op op, int *commute);
1351 int MPI_Reduce_scatter_block(const void *sendbuf, void *recvbuf, int recvcount,
1352                              MPI_Datatype datatype, MPI_Op op, MPI_Comm comm)
1353                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
1354                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1355 int MPI_Dist_graph_create_adjacent(MPI_Comm comm_old, int indegree, const int sources[],
1356                                    const int sourceweights[], int outdegree,
1357                                    const int destinations[], const int destweights[],
1358                                    MPI_Info info, int reorder, MPI_Comm *comm_dist_graph);
1359 int MPI_Dist_graph_create(MPI_Comm comm_old, int n, const int sources[], const int degrees[],
1360                           const int destinations[], const int weights[], MPI_Info info,
1361                           int reorder, MPI_Comm *comm_dist_graph);
1362 int MPI_Dist_graph_neighbors_count(MPI_Comm comm, int *indegree, int *outdegree, int *weighted);
1363 int MPI_Dist_graph_neighbors(MPI_Comm comm, int maxindegree, int sources[], int sourceweights[],
1364                              int maxoutdegree, int destinations[], int destweights[]);
1365
1366 /* Matched probe functionality */
1367 int MPI_Improbe(int source, int tag, MPI_Comm comm, int *flag, MPI_Message *message,
1368                 MPI_Status *status);
1369 int MPI_Imrecv(void *buf, int count, MPI_Datatype datatype, MPI_Message *message,
1370                MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1371 int MPI_Mprobe(int source, int tag, MPI_Comm comm, MPI_Message *message, MPI_Status *status);
1372 int MPI_Mrecv(void *buf, int count, MPI_Datatype datatype, MPI_Message *message,
1373               MPI_Status *status) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1374
1375 /* Nonblocking collectives */
1376 int MPI_Comm_idup(MPI_Comm comm, MPI_Comm *newcomm, MPI_Request *request);
1377 int MPI_Ibarrier(MPI_Comm comm, MPI_Request *request);
1378 int MPI_Ibcast(void *buffer, int count, MPI_Datatype datatype, int root, MPI_Comm comm,
1379                MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1380 int MPI_Igather(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1381                 int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm,
1382                 MPI_Request *request)
1383                 MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1384 int MPI_Igatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1385                  const int recvcounts[], const int displs[], MPI_Datatype recvtype, int root,
1386                  MPI_Comm comm, MPI_Request *request)
1387                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
1388 int MPI_Iscatter(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1389                  int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm,
1390                  MPI_Request *request)
1391                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1392 int MPI_Iscatterv(const void *sendbuf, const int sendcounts[], const int displs[],
1393                   MPI_Datatype sendtype, void *recvbuf, int recvcount, MPI_Datatype recvtype,
1394                   int root, MPI_Comm comm, MPI_Request *request)
1395                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,7);
1396 int MPI_Iallgather(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1397                    int recvcount, MPI_Datatype recvtype, MPI_Comm comm, MPI_Request *request)
1398                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1399 int MPI_Iallgatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1400                     const int recvcounts[], const int displs[], MPI_Datatype recvtype,
1401                     MPI_Comm comm, MPI_Request *request)
1402                     MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
1403 int MPI_Ialltoall(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1404                   int recvcount, MPI_Datatype recvtype, MPI_Comm comm, MPI_Request *request)
1405                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1406 int MPI_Ialltoallv(const void *sendbuf, const int sendcounts[], const int sdispls[],
1407                    MPI_Datatype sendtype, void *recvbuf, const int recvcounts[],
1408                    const int rdispls[], MPI_Datatype recvtype, MPI_Comm comm,
1409                    MPI_Request *request)
1410                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,8);
1411 int MPI_Ialltoallw(const void *sendbuf, const int sendcounts[], const int sdispls[],
1412                    const MPI_Datatype sendtypes[], void *recvbuf, const int recvcounts[],
1413                    const int rdispls[], const MPI_Datatype recvtypes[], MPI_Comm comm,
1414                    MPI_Request *request);
1415 int MPI_Ireduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1416                 MPI_Op op, int root, MPI_Comm comm, MPI_Request *request)
1417                 MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1418 int MPI_Iallreduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1419                    MPI_Op op, MPI_Comm comm, MPI_Request *request)
1420                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1421 int MPI_Ireduce_scatter(const void *sendbuf, void *recvbuf, const int recvcounts[],
1422                         MPI_Datatype datatype, MPI_Op op, MPI_Comm comm, MPI_Request *request)
1423                         MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1424 int MPI_Ireduce_scatter_block(const void *sendbuf, void *recvbuf, int recvcount,
1425                               MPI_Datatype datatype, MPI_Op op, MPI_Comm comm,
1426                               MPI_Request *request)
1427                               MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
1428                               MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1429 int MPI_Iscan(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype, MPI_Op op,
1430               MPI_Comm comm, MPI_Request *request)
1431               MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1432 int MPI_Iexscan(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1433                 MPI_Op op, MPI_Comm comm, MPI_Request *request)
1434                 MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1435
1436 /* Neighborhood collectives */
1437 int MPI_Ineighbor_allgather(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
1438                             void *recvbuf, int recvcount, MPI_Datatype recvtype,
1439                             MPI_Comm comm, MPI_Request *request)
1440                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1441                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1442 int MPI_Ineighbor_allgatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
1443                              void *recvbuf, const int recvcounts[], const int displs[],
1444                              MPI_Datatype recvtype, MPI_Comm comm, MPI_Request *request)
1445                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1446                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
1447 int MPI_Ineighbor_alltoall(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
1448                            void *recvbuf, int recvcount, MPI_Datatype recvtype, MPI_Comm comm,
1449                            MPI_Request *request)
1450                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1451                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1452 int MPI_Ineighbor_alltoallv(const void *sendbuf, const int sendcounts[], const int sdispls[],
1453                             MPI_Datatype sendtype, void *recvbuf, const int recvcounts[],
1454                             const int rdispls[], MPI_Datatype recvtype, MPI_Comm comm,
1455                             MPI_Request *request)
1456                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
1457                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,8);
1458 int MPI_Ineighbor_alltoallw(const void *sendbuf, const int sendcounts[],
1459                             const MPI_Aint sdispls[], const MPI_Datatype sendtypes[],
1460                             void *recvbuf, const int recvcounts[], const MPI_Aint rdispls[],
1461                             const MPI_Datatype recvtypes[], MPI_Comm comm, MPI_Request *request);
1462 int MPI_Neighbor_allgather(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
1463                            void *recvbuf, int recvcount, MPI_Datatype recvtype, MPI_Comm comm)
1464                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1465                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1466 int MPI_Neighbor_allgatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
1467                             void *recvbuf, const int recvcounts[], const int displs[],
1468                             MPI_Datatype recvtype, MPI_Comm comm)
1469                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1470                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
1471 int MPI_Neighbor_alltoall(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
1472                           void *recvbuf, int recvcount, MPI_Datatype recvtype, MPI_Comm comm)
1473                           MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1474                           MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1475 int MPI_Neighbor_alltoallv(const void *sendbuf, const int sendcounts[], const int sdispls[],
1476                            MPI_Datatype sendtype, void *recvbuf, const int recvcounts[],
1477                            const int rdispls[], MPI_Datatype recvtype, MPI_Comm comm)
1478                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
1479                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,8);
1480 int MPI_Neighbor_alltoallw(const void *sendbuf, const int sendcounts[], const MPI_Aint sdispls[],
1481                            const MPI_Datatype sendtypes[], void *recvbuf, const int recvcounts[],
1482                            const MPI_Aint rdispls[], const MPI_Datatype recvtypes[], MPI_Comm comm);
1483
1484 /* Shared memory */
1485 int MPI_Comm_split_type(MPI_Comm comm, int split_type, int key, MPI_Info info, MPI_Comm *newcomm);
1486
1487 /* MPI-3 "large count" routines */
1488 int MPI_Get_elements_x(const MPI_Status *status, MPI_Datatype datatype, MPI_Count *count);
1489 int MPI_Status_set_elements_x(MPI_Status *status, MPI_Datatype datatype, MPI_Count count);
1490 int MPI_Type_get_extent_x(MPI_Datatype datatype, MPI_Count *lb, MPI_Count *extent);
1491 int MPI_Type_get_true_extent_x(MPI_Datatype datatype, MPI_Count *lb, MPI_Count *extent);
1492 int MPI_Type_size_x(MPI_Datatype datatype, MPI_Count *size);
1493
1494 /* Noncollective communicator creation */
1495 int MPI_Comm_create_group(MPI_Comm comm, MPI_Group group, int tag, MPI_Comm *newcomm);
1496
1497 /* MPI_Aint addressing arithmetic */
1498 MPI_Aint MPI_Aint_add(MPI_Aint base, MPI_Aint disp);
1499 MPI_Aint MPI_Aint_diff(MPI_Aint addr1, MPI_Aint addr2);
1500
1501 /* MPI_T interface */
1502 /* The MPI_T routines are available only in C bindings - tell tools that they
1503    can skip these prototypes */
1504 /* Begin Skip Prototypes */
1505 int MPI_T_init_thread(int required, int *provided);
1506 int MPI_T_finalize(void);
1507 int MPI_T_enum_get_info(MPI_T_enum enumtype, int *num, char *name, int *name_len);
1508 int MPI_T_enum_get_item(MPI_T_enum enumtype, int indx, int *value, char *name, int *name_len);
1509 int MPI_T_cvar_get_num(int *num_cvar);
1510 int MPI_T_cvar_get_info(int cvar_index, char *name, int *name_len, int *verbosity,
1511                         MPI_Datatype *datatype, MPI_T_enum *enumtype, char *desc, int *desc_len,
1512                         int *binding, int *scope);
1513 int MPI_T_cvar_handle_alloc(int cvar_index, void *obj_handle, MPI_T_cvar_handle *handle,
1514                             int *count);
1515 int MPI_T_cvar_handle_free(MPI_T_cvar_handle *handle);
1516 int MPI_T_cvar_read(MPI_T_cvar_handle handle, void *buf);
1517 int MPI_T_cvar_write(MPI_T_cvar_handle handle, const void *buf);
1518 int MPI_T_pvar_get_num(int *num_pvar);
1519 int MPI_T_pvar_get_info(int pvar_index, char *name, int *name_len, int *verbosity, int *var_class,
1520                         MPI_Datatype *datatype, MPI_T_enum *enumtype, char *desc, int *desc_len,
1521                         int *binding, int *readonly, int *continuous, int *atomic);
1522 int MPI_T_pvar_session_create(MPI_T_pvar_session *session);
1523 int MPI_T_pvar_session_free(MPI_T_pvar_session *session);
1524 int MPI_T_pvar_handle_alloc(MPI_T_pvar_session session, int pvar_index, void *obj_handle,
1525                             MPI_T_pvar_handle *handle, int *count);
1526 int MPI_T_pvar_handle_free(MPI_T_pvar_session session, MPI_T_pvar_handle *handle);
1527 int MPI_T_pvar_start(MPI_T_pvar_session session, MPI_T_pvar_handle handle);
1528 int MPI_T_pvar_stop(MPI_T_pvar_session session, MPI_T_pvar_handle handle);
1529 int MPI_T_pvar_read(MPI_T_pvar_session session, MPI_T_pvar_handle handle, void *buf);
1530 int MPI_T_pvar_write(MPI_T_pvar_session session, MPI_T_pvar_handle handle, const void *buf);
1531 int MPI_T_pvar_reset(MPI_T_pvar_session session, MPI_T_pvar_handle handle);
1532 int MPI_T_pvar_readreset(MPI_T_pvar_session session, MPI_T_pvar_handle handle, void *buf);
1533 int MPI_T_category_get_num(int *num_cat);
1534 int MPI_T_category_get_info(int cat_index, char *name, int *name_len, char *desc, int *desc_len,
1535                             int *num_cvars, int *num_pvars, int *num_categories);
1536 int MPI_T_category_get_cvars(int cat_index, int len, int indices[]);
1537 int MPI_T_category_get_pvars(int cat_index, int len, int indices[]);
1538 int MPI_T_category_get_categories(int cat_index, int len, int indices[]);
1539 int MPI_T_category_changed(int *stamp);
1540 int MPI_T_cvar_get_index(const char *name, int *cvar_index);
1541 int MPI_T_pvar_get_index(const char *name, int var_class, int *pvar_index);
1542 int MPI_T_category_get_index(const char *name, int *cat_index);
1543 /* End Skip Prototypes */
1544
1545
1546 /* Non-standard but public extensions to MPI */
1547 /* Fault Tolerance Extensions */
1548 int MPIX_Comm_failure_ack(MPI_Comm comm);
1549 int MPIX_Comm_failure_get_acked(MPI_Comm comm, MPI_Group *failedgrp);
1550 int MPIX_Comm_revoke(MPI_Comm comm);
1551 int MPIX_Comm_shrink(MPI_Comm comm, MPI_Comm *newcomm);
1552 int MPIX_Comm_agree(MPI_Comm comm, int *flag);
1553
1554
1555 /* End Prototypes */
1556 #endif /* MPICH_SUPPRESS_PROTOTYPES */
1557
1558
1559 /* Here are the bindings of the profiling routines */
1560 #if !defined(MPI_BUILD_PROFILING)
1561 int PMPI_Send(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1562               MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1563 int PMPI_Recv(void *buf, int count, MPI_Datatype datatype, int source, int tag,
1564               MPI_Comm comm, MPI_Status *status) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1565 int PMPI_Get_count(const MPI_Status *status, MPI_Datatype datatype, int *count);
1566 int PMPI_Bsend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1567                MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1568 int PMPI_Ssend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1569                MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1570 int PMPI_Rsend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1571                MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1572 int PMPI_Buffer_attach(void *buffer, int size);
1573 int PMPI_Buffer_detach(void *buffer_addr, int *size);
1574 int PMPI_Isend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1575                MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1576 int PMPI_Ibsend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1577                 MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1578 int PMPI_Issend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1579                 MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1580 int PMPI_Irsend(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1581                 MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1582 int PMPI_Irecv(void *buf, int count, MPI_Datatype datatype, int source, int tag,
1583                MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1584 int PMPI_Wait(MPI_Request *request, MPI_Status *status);
1585 int PMPI_Test(MPI_Request *request, int *flag, MPI_Status *status);
1586 int PMPI_Request_free(MPI_Request *request);
1587 int PMPI_Waitany(int count, MPI_Request array_of_requests[], int *indx, MPI_Status *status);
1588 int PMPI_Testany(int count, MPI_Request array_of_requests[], int *indx, int *flag,
1589                  MPI_Status *status);
1590 int PMPI_Waitall(int count, MPI_Request array_of_requests[], MPI_Status array_of_statuses[]);
1591 int PMPI_Testall(int count, MPI_Request array_of_requests[], int *flag,
1592                  MPI_Status array_of_statuses[]);
1593 int PMPI_Waitsome(int incount, MPI_Request array_of_requests[], int *outcount,
1594                   int array_of_indices[], MPI_Status array_of_statuses[]);
1595 int PMPI_Testsome(int incount, MPI_Request array_of_requests[], int *outcount,
1596                   int array_of_indices[], MPI_Status array_of_statuses[]);
1597 int PMPI_Iprobe(int source, int tag, MPI_Comm comm, int *flag, MPI_Status *status);
1598 int PMPI_Probe(int source, int tag, MPI_Comm comm, MPI_Status *status);
1599 int PMPI_Cancel(MPI_Request *request);
1600 int PMPI_Test_cancelled(const MPI_Status *status, int *flag);
1601 int PMPI_Send_init(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1602                    MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1603 int PMPI_Bsend_init(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1604                     MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1605 int PMPI_Ssend_init(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1606                     MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1607 int PMPI_Rsend_init(const void *buf, int count, MPI_Datatype datatype, int dest, int tag,
1608                     MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1609 int PMPI_Recv_init(void *buf, int count, MPI_Datatype datatype, int source, int tag,
1610                    MPI_Comm comm, MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1611 int PMPI_Start(MPI_Request *request);
1612 int PMPI_Startall(int count, MPI_Request array_of_requests[]);
1613 int PMPI_Sendrecv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, int dest,
1614                   int sendtag, void *recvbuf, int recvcount, MPI_Datatype recvtype,
1615                   int source, int recvtag, MPI_Comm comm, MPI_Status *status)
1616                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1617                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(6,8);
1618 int PMPI_Sendrecv_replace(void *buf, int count, MPI_Datatype datatype, int dest,
1619                           int sendtag, int source, int recvtag, MPI_Comm comm,
1620                           MPI_Status *status) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1621 int PMPI_Type_contiguous(int count, MPI_Datatype oldtype, MPI_Datatype *newtype);
1622 int PMPI_Type_vector(int count, int blocklength, int stride, MPI_Datatype oldtype,
1623                      MPI_Datatype *newtype);
1624 int PMPI_Type_hvector(int count, int blocklength, MPI_Aint stride, MPI_Datatype oldtype,
1625                       MPI_Datatype *newtype);
1626 int PMPI_Type_indexed(int count, const int *array_of_blocklengths,
1627                       const int *array_of_displacements, MPI_Datatype oldtype,
1628                       MPI_Datatype *newtype);
1629 int PMPI_Type_hindexed(int count, const int *array_of_blocklengths,
1630                        const MPI_Aint *array_of_displacements, MPI_Datatype oldtype,
1631                        MPI_Datatype *newtype);
1632 int PMPI_Type_struct(int count, const int *array_of_blocklengths,
1633                      const MPI_Aint *array_of_displacements,
1634                      const MPI_Datatype *array_of_types, MPI_Datatype *newtype);
1635 int PMPI_Address(const void *location, MPI_Aint *address);
1636 int PMPI_Type_extent(MPI_Datatype datatype, MPI_Aint *extent);
1637 int PMPI_Type_size(MPI_Datatype datatype, int *size);
1638 int PMPI_Type_lb(MPI_Datatype datatype, MPI_Aint *displacement);
1639 int PMPI_Type_ub(MPI_Datatype datatype, MPI_Aint *displacement);
1640 int PMPI_Type_commit(MPI_Datatype *datatype);
1641 int PMPI_Type_free(MPI_Datatype *datatype);
1642 int PMPI_Get_elements(const MPI_Status *status, MPI_Datatype datatype, int *count);
1643 int PMPI_Pack(const void *inbuf, int incount, MPI_Datatype datatype, void *outbuf,
1644               int outsize, int *position, MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1645 int PMPI_Unpack(const void *inbuf, int insize, int *position, void *outbuf, int outcount,
1646                 MPI_Datatype datatype, MPI_Comm comm) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1647 int PMPI_Pack_size(int incount, MPI_Datatype datatype, MPI_Comm comm, int *size);
1648 int PMPI_Barrier(MPI_Comm comm);
1649 int PMPI_Bcast(void *buffer, int count, MPI_Datatype datatype, int root, MPI_Comm comm)
1650                MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1651 int PMPI_Gather(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1652                 int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm)
1653                 MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1654 int PMPI_Gatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1655                  const int *recvcounts, const int *displs, MPI_Datatype recvtype, int root,
1656                  MPI_Comm comm)
1657                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
1658 int PMPI_Scatter(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1659                  int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm)
1660                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1661 int PMPI_Scatterv(const void *sendbuf, const int *sendcounts, const int *displs,
1662                   MPI_Datatype sendtype, void *recvbuf, int recvcount, MPI_Datatype recvtype,
1663                   int root, MPI_Comm comm)
1664                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,7);
1665 int PMPI_Allgather(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1666                    int recvcount, MPI_Datatype recvtype, MPI_Comm comm)
1667                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1668 int PMPI_Allgatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1669                     const int *recvcounts, const int *displs, MPI_Datatype recvtype, MPI_Comm comm)
1670                     MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
1671 int PMPI_Alltoall(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
1672                   int recvcount, MPI_Datatype recvtype, MPI_Comm comm)
1673                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1674 int PMPI_Alltoallv(const void *sendbuf, const int *sendcounts, const int *sdispls,
1675                    MPI_Datatype sendtype, void *recvbuf, const int *recvcounts,
1676                    const int *rdispls, MPI_Datatype recvtype, MPI_Comm comm)
1677                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,8);
1678 int PMPI_Alltoallw(const void *sendbuf, const int sendcounts[], const int sdispls[],
1679                    const MPI_Datatype sendtypes[], void *recvbuf, const int recvcounts[],
1680                    const int rdispls[], const MPI_Datatype recvtypes[], MPI_Comm comm);
1681 int PMPI_Exscan(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1682                 MPI_Op op, MPI_Comm comm)
1683                 MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1684 int PMPI_Reduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1685                 MPI_Op op, int root, MPI_Comm comm)
1686                 MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1687 int PMPI_Op_create(MPI_User_function *user_fn, int commute, MPI_Op *op);
1688 int PMPI_Op_free(MPI_Op *op);
1689 int PMPI_Allreduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
1690                    MPI_Op op, MPI_Comm comm)
1691                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1692 int PMPI_Reduce_scatter(const void *sendbuf, void *recvbuf, const int recvcounts[],
1693                         MPI_Datatype datatype, MPI_Op op, MPI_Comm comm)
1694                         MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1695 int PMPI_Scan(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype, MPI_Op op,
1696               MPI_Comm comm)
1697               MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1698 int PMPI_Group_size(MPI_Group group, int *size);
1699 int PMPI_Group_rank(MPI_Group group, int *rank);
1700 int PMPI_Group_translate_ranks(MPI_Group group1, int n, const int ranks1[], MPI_Group group2,
1701                                int ranks2[]);
1702 int PMPI_Group_compare(MPI_Group group1, MPI_Group group2, int *result);
1703 int PMPI_Comm_group(MPI_Comm comm, MPI_Group *group);
1704 int PMPI_Group_union(MPI_Group group1, MPI_Group group2, MPI_Group *newgroup);
1705 int PMPI_Group_intersection(MPI_Group group1, MPI_Group group2, MPI_Group *newgroup);
1706 int PMPI_Group_difference(MPI_Group group1, MPI_Group group2, MPI_Group *newgroup);
1707 int PMPI_Group_incl(MPI_Group group, int n, const int ranks[], MPI_Group *newgroup);
1708 int PMPI_Group_excl(MPI_Group group, int n, const int ranks[], MPI_Group *newgroup);
1709 int PMPI_Group_range_incl(MPI_Group group, int n, int ranges[][3], MPI_Group *newgroup);
1710 int PMPI_Group_range_excl(MPI_Group group, int n, int ranges[][3], MPI_Group *newgroup);
1711 int PMPI_Group_free(MPI_Group *group);
1712 int PMPI_Comm_size(MPI_Comm comm, int *size);
1713 int PMPI_Comm_rank(MPI_Comm comm, int *rank);
1714 int PMPI_Comm_compare(MPI_Comm comm1, MPI_Comm comm2, int *result);
1715 int PMPI_Comm_dup(MPI_Comm comm, MPI_Comm *newcomm);
1716 int PMPI_Comm_dup_with_info(MPI_Comm comm, MPI_Info info, MPI_Comm *newcomm);
1717 int PMPI_Comm_create(MPI_Comm comm, MPI_Group group, MPI_Comm *newcomm);
1718 int PMPI_Comm_split(MPI_Comm comm, int color, int key, MPI_Comm *newcomm);
1719 int PMPI_Comm_free(MPI_Comm *comm);
1720 int PMPI_Comm_test_inter(MPI_Comm comm, int *flag);
1721 int PMPI_Comm_remote_size(MPI_Comm comm, int *size);
1722 int PMPI_Comm_remote_group(MPI_Comm comm, MPI_Group *group);
1723 int PMPI_Intercomm_create(MPI_Comm local_comm, int local_leader, MPI_Comm peer_comm,
1724                           int remote_leader, int tag, MPI_Comm *newintercomm);
1725 int PMPI_Intercomm_merge(MPI_Comm intercomm, int high, MPI_Comm *newintracomm);
1726 int PMPI_Keyval_create(MPI_Copy_function *copy_fn, MPI_Delete_function *delete_fn,
1727                        int *keyval, void *extra_state);
1728 int PMPI_Keyval_free(int *keyval);
1729 int PMPI_Attr_put(MPI_Comm comm, int keyval, void *attribute_val);
1730 int PMPI_Attr_get(MPI_Comm comm, int keyval, void *attribute_val, int *flag);
1731 int PMPI_Attr_delete(MPI_Comm comm, int keyval);
1732 int PMPI_Topo_test(MPI_Comm comm, int *status);
1733 int PMPI_Cart_create(MPI_Comm comm_old, int ndims, const int dims[], const int periods[],
1734                      int reorder, MPI_Comm *comm_cart);
1735 int PMPI_Dims_create(int nnodes, int ndims, int dims[]);
1736 int PMPI_Graph_create(MPI_Comm comm_old, int nnodes, const int indx[], const int edges[],
1737                       int reorder, MPI_Comm *comm_graph);
1738 int PMPI_Graphdims_get(MPI_Comm comm, int *nnodes, int *nedges);
1739 int PMPI_Graph_get(MPI_Comm comm, int maxindex, int maxedges, int indx[], int edges[]);
1740 int PMPI_Cartdim_get(MPI_Comm comm, int *ndims);
1741 int PMPI_Cart_get(MPI_Comm comm, int maxdims, int dims[], int periods[], int coords[]);
1742 int PMPI_Cart_rank(MPI_Comm comm, const int coords[], int *rank);
1743 int PMPI_Cart_coords(MPI_Comm comm, int rank, int maxdims, int coords[]);
1744 int PMPI_Graph_neighbors_count(MPI_Comm comm, int rank, int *nneighbors);
1745 int PMPI_Graph_neighbors(MPI_Comm comm, int rank, int maxneighbors, int neighbors[]);
1746 int PMPI_Cart_shift(MPI_Comm comm, int direction, int disp, int *rank_source, int *rank_dest);
1747 int PMPI_Cart_sub(MPI_Comm comm, const int remain_dims[], MPI_Comm *newcomm);
1748 int PMPI_Cart_map(MPI_Comm comm, int ndims, const int dims[], const int periods[], int *newrank);
1749 int PMPI_Graph_map(MPI_Comm comm, int nnodes, const int indx[], const int edges[], int *newrank);
1750 int PMPI_Get_processor_name(char *name, int *resultlen);
1751 int PMPI_Get_version(int *version, int *subversion);
1752 int PMPI_Get_library_version(char *version, int *resultlen);
1753 int PMPI_Errhandler_create(MPI_Handler_function *function, MPI_Errhandler *errhandler);
1754 int PMPI_Errhandler_set(MPI_Comm comm, MPI_Errhandler errhandler);
1755 int PMPI_Errhandler_get(MPI_Comm comm, MPI_Errhandler *errhandler);
1756 int PMPI_Errhandler_free(MPI_Errhandler *errhandler);
1757 int PMPI_Error_string(int errorcode, char *string, int *resultlen);
1758 int PMPI_Error_class(int errorcode, int *errorclass);
1759 double PMPI_Wtime(void);
1760 double PMPI_Wtick(void);
1761 int PMPI_Init(int *argc, char ***argv);
1762 int PMPI_Finalize(void);
1763 int PMPI_Initialized(int *flag);
1764 int PMPI_Abort(MPI_Comm comm, int errorcode);
1765
1766 /* Note that we may need to define a @PCONTROL_LIST@ depending on whether
1767    stdargs are supported */
1768 int PMPI_Pcontrol(const int level, ...);
1769
1770 /* Process Creation and Management */
1771 int PMPI_Close_port(const char *port_name);
1772 int PMPI_Comm_accept(const char *port_name, MPI_Info info, int root, MPI_Comm comm,
1773                      MPI_Comm *newcomm);
1774 int PMPI_Comm_connect(const char *port_name, MPI_Info info, int root, MPI_Comm comm,
1775                       MPI_Comm *newcomm);
1776 int PMPI_Comm_disconnect(MPI_Comm *comm);
1777 int PMPI_Comm_get_parent(MPI_Comm *parent);
1778 int PMPI_Comm_join(int fd, MPI_Comm *intercomm);
1779 int PMPI_Comm_spawn(const char *command, char *argv[], int maxprocs, MPI_Info info, int root,
1780                     MPI_Comm comm, MPI_Comm *intercomm, int array_of_errcodes[]);
1781 int PMPI_Comm_spawn_multiple(int count, char *array_of_commands[], char **array_of_argv[],
1782                              const int array_of_maxprocs[], const MPI_Info array_of_info[],
1783                              int root, MPI_Comm comm, MPI_Comm *intercomm, int array_of_errcodes[]);
1784 int PMPI_Lookup_name(const char *service_name, MPI_Info info, char *port_name);
1785 int PMPI_Open_port(MPI_Info info, char *port_name);
1786 int PMPI_Publish_name(const char *service_name, MPI_Info info, const char *port_name);
1787 int PMPI_Unpublish_name(const char *service_name, MPI_Info info, const char *port_name);
1788 int PMPI_Comm_set_info(MPI_Comm comm, MPI_Info info);
1789 int PMPI_Comm_get_info(MPI_Comm comm, MPI_Info *info);
1790
1791 /* One-Sided Communications */
1792 int PMPI_Accumulate(const void *origin_addr, int origin_count, MPI_Datatype origin_datatype,
1793                     int target_rank, MPI_Aint target_disp, int target_count,
1794                     MPI_Datatype target_datatype, MPI_Op op, MPI_Win win)
1795                     MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1796 int PMPI_Get(void *origin_addr, int origin_count, MPI_Datatype origin_datatype,
1797              int target_rank, MPI_Aint target_disp, int target_count,
1798              MPI_Datatype target_datatype, MPI_Win win) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1799 int PMPI_Put(const void *origin_addr, int origin_count, MPI_Datatype origin_datatype,
1800              int target_rank, MPI_Aint target_disp, int target_count,
1801              MPI_Datatype target_datatype, MPI_Win win) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1802 int PMPI_Win_complete(MPI_Win win);
1803 int PMPI_Win_create(void *base, MPI_Aint size, int disp_unit, MPI_Info info, MPI_Comm comm,
1804                     MPI_Win *win);
1805 int PMPI_Win_fence(int assert, MPI_Win win);
1806 int PMPI_Win_free(MPI_Win *win);
1807 int PMPI_Win_get_group(MPI_Win win, MPI_Group *group);
1808 int PMPI_Win_lock(int lock_type, int rank, int assert, MPI_Win win);
1809 int PMPI_Win_post(MPI_Group group, int assert, MPI_Win win);
1810 int PMPI_Win_start(MPI_Group group, int assert, MPI_Win win);
1811 int PMPI_Win_test(MPI_Win win, int *flag);
1812 int PMPI_Win_unlock(int rank, MPI_Win win);
1813 int PMPI_Win_wait(MPI_Win win);
1814
1815 /* MPI-3 One-Sided Communication Routines */
1816 int PMPI_Win_allocate(MPI_Aint size, int disp_unit, MPI_Info info, MPI_Comm comm, void *baseptr,
1817                       MPI_Win *win);
1818 int PMPI_Win_allocate_shared(MPI_Aint size, int disp_unit, MPI_Info info, MPI_Comm comm,
1819                              void *baseptr, MPI_Win *win);
1820 int PMPI_Win_shared_query(MPI_Win win, int rank, MPI_Aint *size, int *disp_unit, void *baseptr);
1821 int PMPI_Win_create_dynamic(MPI_Info info, MPI_Comm comm, MPI_Win *win);
1822 int PMPI_Win_attach(MPI_Win win, void *base, MPI_Aint size);
1823 int PMPI_Win_detach(MPI_Win win, const void *base);
1824 int PMPI_Win_get_info(MPI_Win win, MPI_Info *info_used);
1825 int PMPI_Win_set_info(MPI_Win win, MPI_Info info);
1826 int PMPI_Get_accumulate(const void *origin_addr, int origin_count,
1827                          MPI_Datatype origin_datatype, void *result_addr, int result_count,
1828                          MPI_Datatype result_datatype, int target_rank, MPI_Aint target_disp,
1829                          int target_count, MPI_Datatype target_datatype, MPI_Op op, MPI_Win win)
1830                          MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1831                          MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1832 int PMPI_Fetch_and_op(const void *origin_addr, void *result_addr,
1833                        MPI_Datatype datatype, int target_rank, MPI_Aint target_disp,
1834                        MPI_Op op, MPI_Win win)
1835                        MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1836 int PMPI_Compare_and_swap(const void *origin_addr, const void *compare_addr,
1837                            void *result_addr, MPI_Datatype datatype, int target_rank,
1838                            MPI_Aint target_disp, MPI_Win win)
1839                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
1840                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4)
1841                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(3,4);
1842 int PMPI_Rput(const void *origin_addr, int origin_count,
1843                MPI_Datatype origin_datatype, int target_rank, MPI_Aint target_disp,
1844                int target_count, MPI_Datatype target_datatype, MPI_Win win,
1845                MPI_Request *request)
1846                MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1847 int PMPI_Rget(void *origin_addr, int origin_count,
1848                MPI_Datatype origin_datatype, int target_rank, MPI_Aint target_disp,
1849                int target_count, MPI_Datatype target_datatype, MPI_Win win,
1850                MPI_Request *request)
1851                MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1852 int PMPI_Raccumulate(const void *origin_addr, int origin_count,
1853                       MPI_Datatype origin_datatype, int target_rank, MPI_Aint target_disp,
1854                       int target_count, MPI_Datatype target_datatype, MPI_Op op, MPI_Win win,
1855                       MPI_Request *request)
1856                       MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
1857 int PMPI_Rget_accumulate(const void *origin_addr, int origin_count,
1858                           MPI_Datatype origin_datatype, void *result_addr, int result_count,
1859                           MPI_Datatype result_datatype, int target_rank, MPI_Aint target_disp,
1860                           int target_count, MPI_Datatype target_datatype, MPI_Op op, MPI_Win win,
1861                           MPI_Request *request)
1862                           MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
1863                           MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
1864 int PMPI_Win_lock_all(int assert, MPI_Win win);
1865 int PMPI_Win_unlock_all(MPI_Win win);
1866 int PMPI_Win_flush(int rank, MPI_Win win);
1867 int PMPI_Win_flush_all(MPI_Win win);
1868 int PMPI_Win_flush_local(int rank, MPI_Win win);
1869 int PMPI_Win_flush_local_all(MPI_Win win);
1870 int PMPI_Win_sync(MPI_Win win);
1871  
1872 /* External Interfaces */
1873 int PMPI_Add_error_class(int *errorclass);
1874 int PMPI_Add_error_code(int errorclass, int *errorcode);
1875 int PMPI_Add_error_string(int errorcode, const char *string);
1876 int PMPI_Comm_call_errhandler(MPI_Comm comm, int errorcode);
1877 int PMPI_Comm_create_keyval(MPI_Comm_copy_attr_function *comm_copy_attr_fn,
1878                             MPI_Comm_delete_attr_function *comm_delete_attr_fn, int *comm_keyval,
1879                             void *extra_state);
1880 int PMPI_Comm_delete_attr(MPI_Comm comm, int comm_keyval);
1881 int PMPI_Comm_free_keyval(int *comm_keyval);
1882 int PMPI_Comm_get_attr(MPI_Comm comm, int comm_keyval, void *attribute_val, int *flag);
1883 int PMPI_Comm_get_name(MPI_Comm comm, char *comm_name, int *resultlen);
1884 int PMPI_Comm_set_attr(MPI_Comm comm, int comm_keyval, void *attribute_val);
1885 int PMPI_Comm_set_name(MPI_Comm comm, const char *comm_name);
1886 int PMPI_File_call_errhandler(MPI_File fh, int errorcode);
1887 int PMPI_Grequest_complete(MPI_Request request);
1888 int PMPI_Grequest_start(MPI_Grequest_query_function *query_fn, MPI_Grequest_free_function *free_fn,
1889                         MPI_Grequest_cancel_function *cancel_fn, void *extra_state,
1890                         MPI_Request *request);
1891 int PMPI_Init_thread(int *argc, char ***argv, int required, int *provided);
1892 int PMPI_Is_thread_main(int *flag);
1893 int PMPI_Query_thread(int *provided);
1894 int PMPI_Status_set_cancelled(MPI_Status *status, int flag);
1895 int PMPI_Status_set_elements(MPI_Status *status, MPI_Datatype datatype, int count);
1896 int PMPI_Type_create_keyval(MPI_Type_copy_attr_function *type_copy_attr_fn,
1897                             MPI_Type_delete_attr_function *type_delete_attr_fn,
1898                             int *type_keyval, void *extra_state);
1899 int PMPI_Type_delete_attr(MPI_Datatype datatype, int type_keyval);
1900 int PMPI_Type_dup(MPI_Datatype oldtype, MPI_Datatype *newtype);
1901 int PMPI_Type_free_keyval(int *type_keyval);
1902 int PMPI_Type_get_attr(MPI_Datatype datatype, int type_keyval, void *attribute_val, int *flag);
1903 int PMPI_Type_get_contents(MPI_Datatype datatype, int max_integers, int max_addresses,
1904                            int max_datatypes, int array_of_integers[],
1905                            MPI_Aint array_of_addresses[], MPI_Datatype array_of_datatypes[]);
1906 int PMPI_Type_get_envelope(MPI_Datatype datatype, int *num_integers, int *num_addresses,
1907                            int *num_datatypes, int *combiner);
1908 int PMPI_Type_get_name(MPI_Datatype datatype, char *type_name, int *resultlen);
1909 int PMPI_Type_set_attr(MPI_Datatype datatype, int type_keyval, void *attribute_val);
1910 int PMPI_Type_set_name(MPI_Datatype datatype, const char *type_name);
1911 int PMPI_Type_match_size(int typeclass, int size, MPI_Datatype *datatype);
1912 int PMPI_Win_call_errhandler(MPI_Win win, int errorcode);
1913 int PMPI_Win_create_keyval(MPI_Win_copy_attr_function *win_copy_attr_fn,
1914                            MPI_Win_delete_attr_function *win_delete_attr_fn, int *win_keyval,
1915                            void *extra_state);
1916 int PMPI_Win_delete_attr(MPI_Win win, int win_keyval);
1917 int PMPI_Win_free_keyval(int *win_keyval);
1918 int PMPI_Win_get_attr(MPI_Win win, int win_keyval, void *attribute_val, int *flag);
1919 int PMPI_Win_get_name(MPI_Win win, char *win_name, int *resultlen);
1920 int PMPI_Win_set_attr(MPI_Win win, int win_keyval, void *attribute_val);
1921 int PMPI_Win_set_name(MPI_Win win, const char *win_name);
1922
1923 int PMPI_Alloc_mem(MPI_Aint size, MPI_Info info, void *baseptr);
1924 int PMPI_Comm_create_errhandler(MPI_Comm_errhandler_function *comm_errhandler_fn,
1925                                 MPI_Errhandler *errhandler);
1926 int PMPI_Comm_get_errhandler(MPI_Comm comm, MPI_Errhandler *errhandler);
1927 int PMPI_Comm_set_errhandler(MPI_Comm comm, MPI_Errhandler errhandler);
1928 int PMPI_File_create_errhandler(MPI_File_errhandler_function *file_errhandler_fn,
1929                                 MPI_Errhandler *errhandler);
1930 int PMPI_File_get_errhandler(MPI_File file, MPI_Errhandler *errhandler);
1931 int PMPI_File_set_errhandler(MPI_File file, MPI_Errhandler errhandler);
1932 int PMPI_Finalized(int *flag);
1933 int PMPI_Free_mem(void *base);
1934 int PMPI_Get_address(const void *location, MPI_Aint *address);
1935 int PMPI_Info_create(MPI_Info *info);
1936 int PMPI_Info_delete(MPI_Info info, const char *key);
1937 int PMPI_Info_dup(MPI_Info info, MPI_Info *newinfo);
1938 int PMPI_Info_free(MPI_Info *info);
1939 int PMPI_Info_get(MPI_Info info, const char *key, int valuelen, char *value, int *flag);
1940 int PMPI_Info_get_nkeys(MPI_Info info, int *nkeys);
1941 int PMPI_Info_get_nthkey(MPI_Info info, int n, char *key);
1942 int PMPI_Info_get_valuelen(MPI_Info info, const char *key, int *valuelen, int *flag);
1943 int PMPI_Info_set(MPI_Info info, const char *key, const char *value);
1944 int PMPI_Pack_external(const char datarep[], const void *inbuf, int incount,
1945                        MPI_Datatype datatype, void *outbuf, MPI_Aint outsize, MPI_Aint *position)
1946                        MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1947 int PMPI_Pack_external_size(const char datarep[], int incount, MPI_Datatype datatype,
1948                             MPI_Aint *size);
1949 int PMPI_Request_get_status(MPI_Request request, int *flag, MPI_Status *status);
1950 int PMPI_Status_c2f(const MPI_Status *c_status, MPI_Fint *f_status);
1951 int PMPI_Status_f2c(const MPI_Fint *f_status, MPI_Status *c_status);
1952 int PMPI_Type_create_darray(int size, int rank, int ndims, const int array_of_gsizes[],
1953                             const int array_of_distribs[], const int array_of_dargs[],
1954                             const int array_of_psizes[], int order, MPI_Datatype oldtype,
1955                             MPI_Datatype *newtype);
1956 int PMPI_Type_create_hindexed(int count, const int array_of_blocklengths[],
1957                               const MPI_Aint array_of_displacements[], MPI_Datatype oldtype,
1958                               MPI_Datatype *newtype);
1959 int PMPI_Type_create_hvector(int count, int blocklength, MPI_Aint stride, MPI_Datatype oldtype,
1960                              MPI_Datatype *newtype);
1961 int PMPI_Type_create_indexed_block(int count, int blocklength, const int array_of_displacements[],
1962                                    MPI_Datatype oldtype, MPI_Datatype *newtype);
1963 int PMPI_Type_create_hindexed_block(int count, int blocklength,
1964                                     const MPI_Aint array_of_displacements[],
1965                                     MPI_Datatype oldtype, MPI_Datatype *newtype);
1966 int PMPI_Type_create_resized(MPI_Datatype oldtype, MPI_Aint lb, MPI_Aint extent,
1967                              MPI_Datatype *newtype);
1968 int PMPI_Type_create_struct(int count, const int array_of_blocklengths[],
1969                             const MPI_Aint array_of_displacements[],
1970                             const MPI_Datatype array_of_types[], MPI_Datatype *newtype);
1971 int PMPI_Type_create_subarray(int ndims, const int array_of_sizes[],
1972                               const int array_of_subsizes[], const int array_of_starts[],
1973                               int order, MPI_Datatype oldtype, MPI_Datatype *newtype);
1974 int PMPI_Type_get_extent(MPI_Datatype datatype, MPI_Aint *lb, MPI_Aint *extent);
1975 int PMPI_Type_get_true_extent(MPI_Datatype datatype, MPI_Aint *true_lb, MPI_Aint *true_extent);
1976 int PMPI_Unpack_external(const char datarep[], const void *inbuf, MPI_Aint insize,
1977                          MPI_Aint *position, void *outbuf, int outcount, MPI_Datatype datatype)
1978                          MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,7);
1979 int PMPI_Win_create_errhandler(MPI_Win_errhandler_function *win_errhandler_fn,
1980                                MPI_Errhandler *errhandler);
1981 int PMPI_Win_get_errhandler(MPI_Win win, MPI_Errhandler *errhandler);
1982 int PMPI_Win_set_errhandler(MPI_Win win, MPI_Errhandler errhandler);
1983
1984 /* Fortran 90-related functions.  These routines are available only if
1985    Fortran 90 support is enabled 
1986 */
1987 int PMPI_Type_create_f90_integer(int r, MPI_Datatype *newtype);
1988 int PMPI_Type_create_f90_real(int p, int r, MPI_Datatype *newtype);
1989 int PMPI_Type_create_f90_complex(int p, int r, MPI_Datatype *newtype);
1990
1991 int PMPI_Reduce_local(const void *inbuf, void *inoutbuf, int count, MPI_Datatype datatype,
1992                       MPI_Op op)
1993                       MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1994 int PMPI_Op_commutative(MPI_Op op, int *commute);
1995 int PMPI_Reduce_scatter_block(const void *sendbuf, void *recvbuf, int recvcount,
1996                               MPI_Datatype datatype, MPI_Op op, MPI_Comm comm)
1997                               MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
1998                               MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
1999 int PMPI_Dist_graph_create_adjacent(MPI_Comm comm_old, int indegree, const int sources[],
2000                                     const int sourceweights[], int outdegree,
2001                                     const int destinations[], const int destweights[],
2002                                     MPI_Info info, int reorder, MPI_Comm *comm_dist_graph);
2003 int PMPI_Dist_graph_create(MPI_Comm comm_old, int n, const int sources[], const int degrees[],
2004                            const int destinations[], const int weights[], MPI_Info info,
2005                            int reorder, MPI_Comm *comm_dist_graph);
2006 int PMPI_Dist_graph_neighbors_count(MPI_Comm comm, int *indegree, int *outdegree, int *weighted);
2007 int PMPI_Dist_graph_neighbors(MPI_Comm comm, int maxindegree, int sources[], int sourceweights[],
2008                               int maxoutdegree, int destinations[], int destweights[]);
2009
2010 /* Matched probe functionality */
2011 int PMPI_Improbe(int source, int tag, MPI_Comm comm, int *flag, MPI_Message *message,
2012                  MPI_Status *status);
2013 int PMPI_Imrecv(void *buf, int count, MPI_Datatype datatype, MPI_Message *message,
2014                 MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
2015 int PMPI_Mprobe(int source, int tag, MPI_Comm comm, MPI_Message *message, MPI_Status *status);
2016 int PMPI_Mrecv(void *buf, int count, MPI_Datatype datatype, MPI_Message *message,
2017                MPI_Status *status) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
2018
2019 /* Nonblocking collectives */
2020 int PMPI_Comm_idup(MPI_Comm comm, MPI_Comm *newcomm, MPI_Request *request);
2021 int PMPI_Ibarrier(MPI_Comm comm, MPI_Request *request);
2022 int PMPI_Ibcast(void *buffer, int count, MPI_Datatype datatype, int root, MPI_Comm comm,
2023                 MPI_Request *request) MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3);
2024 int PMPI_Igather(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
2025                  int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm,
2026                  MPI_Request *request)
2027                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
2028 int PMPI_Igatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
2029                   const int recvcounts[], const int displs[], MPI_Datatype recvtype, int root,
2030                   MPI_Comm comm, MPI_Request *request)
2031                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
2032 int PMPI_Iscatter(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
2033                   int recvcount, MPI_Datatype recvtype, int root, MPI_Comm comm,
2034                   MPI_Request *request)
2035                   MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
2036 int PMPI_Iscatterv(const void *sendbuf, const int sendcounts[], const int displs[],
2037                    MPI_Datatype sendtype, void *recvbuf, int recvcount, MPI_Datatype recvtype,
2038                    int root, MPI_Comm comm, MPI_Request *request)
2039                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,7);
2040 int PMPI_Iallgather(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
2041                     int recvcount, MPI_Datatype recvtype, MPI_Comm comm, MPI_Request *request)
2042                     MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
2043 int PMPI_Iallgatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
2044                      const int recvcounts[], const int displs[], MPI_Datatype recvtype,
2045                      MPI_Comm comm, MPI_Request *request)
2046                      MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
2047 int PMPI_Ialltoall(const void *sendbuf, int sendcount, MPI_Datatype sendtype, void *recvbuf,
2048                    int recvcount, MPI_Datatype recvtype, MPI_Comm comm, MPI_Request *request)
2049                    MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3) MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
2050 int PMPI_Ialltoallv(const void *sendbuf, const int sendcounts[], const int sdispls[],
2051                     MPI_Datatype sendtype, void *recvbuf, const int recvcounts[],
2052                     const int rdispls[], MPI_Datatype recvtype, MPI_Comm comm,
2053                     MPI_Request *request)
2054                     MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,8);
2055 int PMPI_Ialltoallw(const void *sendbuf, const int sendcounts[], const int sdispls[],
2056                     const MPI_Datatype sendtypes[], void *recvbuf, const int recvcounts[],
2057                     const int rdispls[], const MPI_Datatype recvtypes[], MPI_Comm comm,
2058                     MPI_Request *request);
2059 int PMPI_Ireduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
2060                  MPI_Op op, int root, MPI_Comm comm, MPI_Request *request)
2061                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
2062 int PMPI_Iallreduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
2063                     MPI_Op op, MPI_Comm comm, MPI_Request *request)
2064                     MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
2065 int PMPI_Ireduce_scatter(const void *sendbuf, void *recvbuf, const int recvcounts[],
2066                          MPI_Datatype datatype, MPI_Op op, MPI_Comm comm, MPI_Request *request)
2067                          MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
2068                          MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
2069 int PMPI_Ireduce_scatter_block(const void *sendbuf, void *recvbuf, int recvcount,
2070                                MPI_Datatype datatype, MPI_Op op, MPI_Comm comm,
2071                                MPI_Request *request)
2072                                MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
2073                                MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
2074 int PMPI_Iscan(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype, MPI_Op op,
2075                MPI_Comm comm, MPI_Request *request)
2076                MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
2077 int PMPI_Iexscan(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
2078                  MPI_Op op, MPI_Comm comm, MPI_Request *request)
2079                  MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4) MPICH_ATTR_POINTER_WITH_TYPE_TAG(2,4);
2080
2081 /* Neighborhood collectives */
2082 int PMPI_Ineighbor_allgather(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
2083                              void *recvbuf, int recvcount, MPI_Datatype recvtype,
2084                              MPI_Comm comm, MPI_Request *request)
2085                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
2086                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
2087 int PMPI_Ineighbor_allgatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
2088                               void *recvbuf, const int recvcounts[], const int displs[],
2089                               MPI_Datatype recvtype, MPI_Comm comm, MPI_Request *request)
2090                               MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
2091                               MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
2092 int PMPI_Ineighbor_alltoall(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
2093                             void *recvbuf, int recvcount, MPI_Datatype recvtype, MPI_Comm comm,
2094                             MPI_Request *request)
2095                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
2096                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
2097 int PMPI_Ineighbor_alltoallv(const void *sendbuf, const int sendcounts[], const int sdispls[],
2098                              MPI_Datatype sendtype, void *recvbuf, const int recvcounts[],
2099                              const int rdispls[], MPI_Datatype recvtype, MPI_Comm comm,
2100                              MPI_Request *request)
2101                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
2102                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,8);
2103 int PMPI_Ineighbor_alltoallw(const void *sendbuf, const int sendcounts[],
2104                              const MPI_Aint sdispls[], const MPI_Datatype sendtypes[],
2105                              void *recvbuf, const int recvcounts[], const MPI_Aint rdispls[],
2106                              const MPI_Datatype recvtypes[], MPI_Comm comm, MPI_Request *request);
2107 int PMPI_Neighbor_allgather(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
2108                             void *recvbuf, int recvcount, MPI_Datatype recvtype, MPI_Comm comm)
2109                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
2110                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
2111 int PMPI_Neighbor_allgatherv(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
2112                              void *recvbuf, const int recvcounts[], const int displs[],
2113                              MPI_Datatype recvtype, MPI_Comm comm)
2114                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
2115                              MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,7);
2116 int PMPI_Neighbor_alltoall(const void *sendbuf, int sendcount, MPI_Datatype sendtype,
2117                            void *recvbuf, int recvcount, MPI_Datatype recvtype, MPI_Comm comm)
2118                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,3)
2119                            MPICH_ATTR_POINTER_WITH_TYPE_TAG(4,6);
2120 int PMPI_Neighbor_alltoallv(const void *sendbuf, const int sendcounts[], const int sdispls[],
2121                             MPI_Datatype sendtype, void *recvbuf, const int recvcounts[],
2122                             const int rdispls[], MPI_Datatype recvtype, MPI_Comm comm)
2123                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(1,4)
2124                             MPICH_ATTR_POINTER_WITH_TYPE_TAG(5,8);
2125 int PMPI_Neighbor_alltoallw(const void *sendbuf, const int sendcounts[], const MPI_Aint sdispls[],
2126                             const MPI_Datatype sendtypes[], void *recvbuf, const int recvcounts[],
2127                             const MPI_Aint rdispls[], const MPI_Datatype recvtypes[],
2128                             MPI_Comm comm);
2129
2130 /* Shared memory */
2131 int PMPI_Comm_split_type(MPI_Comm comm, int split_type, int key, MPI_Info info, MPI_Comm *newcomm);
2132
2133 /* Noncollective communicator creation */
2134 int PMPI_Comm_create_group(MPI_Comm comm, MPI_Group group, int tag, MPI_Comm *newcomm);
2135
2136 /* MPI-3 "large count" routines */
2137 int PMPI_Get_elements_x(const MPI_Status *status, MPI_Datatype datatype, MPI_Count *count);
2138 int PMPI_Status_set_elements_x(MPI_Status *status, MPI_Datatype datatype, MPI_Count count);
2139 int PMPI_Type_get_extent_x(MPI_Datatype datatype, MPI_Count *lb, MPI_Count *extent);
2140 int PMPI_Type_get_true_extent_x(MPI_Datatype datatype, MPI_Count *lb, MPI_Count *extent);
2141 int PMPI_Type_size_x(MPI_Datatype datatype, MPI_Count *size);
2142
2143 /* MPI_Aint addressing arithmetic */
2144 MPI_Aint PMPI_Aint_add(MPI_Aint base, MPI_Aint disp);
2145 MPI_Aint PMPI_Aint_diff(MPI_Aint addr1, MPI_Aint addr2);
2146
2147 /* MPI_T interface */
2148 /* The MPI_T routines are available only in C bindings - tell tools that they
2149    can skip these prototypes */
2150 /* Begin Skip Prototypes */
2151 int PMPI_T_init_thread(int required, int *provided);
2152 int PMPI_T_finalize(void);
2153 int PMPI_T_enum_get_info(MPI_T_enum enumtype, int *num, char *name, int *name_len);
2154 int PMPI_T_enum_get_item(MPI_T_enum enumtype, int indx, int *value, char *name, int *name_len);
2155 int PMPI_T_cvar_get_num(int *num_cvar);
2156 int PMPI_T_cvar_get_info(int cvar_index, char *name, int *name_len, int *verbosity,
2157                          MPI_Datatype *datatype, MPI_T_enum *enumtype, char *desc, int *desc_len,
2158                          int *binding, int *scope);
2159 int PMPI_T_cvar_handle_alloc(int cvar_index, void *obj_handle, MPI_T_cvar_handle *handle,
2160                              int *count);
2161 int PMPI_T_cvar_handle_free(MPI_T_cvar_handle *handle);
2162 int PMPI_T_cvar_read(MPI_T_cvar_handle handle, void *buf);
2163 int PMPI_T_cvar_write(MPI_T_cvar_handle handle, const void *buf);
2164 int PMPI_T_pvar_get_num(int *num_pvar);
2165 int PMPI_T_pvar_get_info(int pvar_index, char *name, int *name_len, int *verbosity, int *var_class,
2166                          MPI_Datatype *datatype, MPI_T_enum *enumtype, char *desc, int *desc_len,
2167                          int *binding, int *readonly, int *continuous, int *atomic);
2168 int PMPI_T_pvar_session_create(MPI_T_pvar_session *session);
2169 int PMPI_T_pvar_session_free(MPI_T_pvar_session *session);
2170 int PMPI_T_pvar_handle_alloc(MPI_T_pvar_session session, int pvar_index, void *obj_handle,
2171                              MPI_T_pvar_handle *handle, int *count);
2172 int PMPI_T_pvar_handle_free(MPI_T_pvar_session session, MPI_T_pvar_handle *handle);
2173 int PMPI_T_pvar_start(MPI_T_pvar_session session, MPI_T_pvar_handle handle);
2174 int PMPI_T_pvar_stop(MPI_T_pvar_session session, MPI_T_pvar_handle handle);
2175 int PMPI_T_pvar_read(MPI_T_pvar_session session, MPI_T_pvar_handle handle, void *buf);
2176 int PMPI_T_pvar_write(MPI_T_pvar_session session, MPI_T_pvar_handle handle, const void *buf);
2177 int PMPI_T_pvar_reset(MPI_T_pvar_session session, MPI_T_pvar_handle handle);
2178 int PMPI_T_pvar_readreset(MPI_T_pvar_session session, MPI_T_pvar_handle handle, void *buf);
2179 int PMPI_T_category_get_num(int *num_cat);
2180 int PMPI_T_category_get_info(int cat_index, char *name, int *name_len, char *desc, int *desc_len,
2181                              int *num_cvars, int *num_pvars, int *num_categories);
2182 int PMPI_T_category_get_cvars(int cat_index, int len, int indices[]);
2183 int PMPI_T_category_get_pvars(int cat_index, int len, int indices[]);
2184 int PMPI_T_category_get_categories(int cat_index, int len, int indices[]);
2185 int PMPI_T_category_changed(int *stamp);
2186 int PMPI_T_cvar_get_index(const char *name, int *cvar_index);
2187 int PMPI_T_pvar_get_index(const char *name, int var_class, int *pvar_index);
2188 int PMPI_T_category_get_index(const char *name, int *cat_index);
2189 /* End Skip Prototypes */
2190
2191
2192 /* Non-standard but public extensions to MPI */
2193 /* Fault Tolerance Extensions */
2194 int PMPIX_Comm_failure_ack(MPI_Comm comm);
2195 int PMPIX_Comm_failure_get_acked(MPI_Comm comm, MPI_Group *failedgrp);
2196 int PMPIX_Comm_revoke(MPI_Comm comm);
2197 int PMPIX_Comm_shrink(MPI_Comm comm, MPI_Comm *newcomm);
2198 int PMPIX_Comm_agree(MPI_Comm comm, int *flag);
2199
2200 #endif  /* MPI_BUILD_PROFILING */
2201 /* End of MPI bindings */
2202
2203 /* feature advertisement */
2204 #define MPIIMPL_ADVERTISES_FEATURES 1
2205 #define MPIIMPL_HAVE_MPI_INFO 1                                                 
2206 #define MPIIMPL_HAVE_MPI_COMBINER_DARRAY 1                                      
2207 #define MPIIMPL_HAVE_MPI_TYPE_CREATE_DARRAY 1
2208 #define MPIIMPL_HAVE_MPI_COMBINER_SUBARRAY 1                                    
2209 #define MPIIMPL_HAVE_MPI_TYPE_CREATE_DARRAY 1
2210 #define MPIIMPL_HAVE_MPI_COMBINER_DUP 1                                         
2211 #define MPIIMPL_HAVE_MPI_GREQUEST 1      
2212 #define MPIIMPL_HAVE_STATUS_SET_BYTES 1
2213 #define MPIIMPL_HAVE_STATUS_SET_INFO 1
2214
2215 @HAVE_ROMIO@
2216
2217 #if defined(__cplusplus)
2218 }
2219 /* Add the C++ bindings */
2220 /* 
2221    If MPICH_SKIP_MPICXX is defined, the mpicxx.h file will *not* be included.
2222    This is necessary, for example, when building the C++ interfaces.  It
2223    can also be used when you want to use a C++ compiler to compile C code,
2224    and do not want to load the C++ bindings.  These definitions can
2225    be made by the C++ compilation script
2226  */
2227 #if !defined(MPICH_SKIP_MPICXX)
2228 /* mpicxx.h contains the MPI C++ binding.  In the mpi.h.in file, this 
2229    include is in an autoconf variable in case the compiler is a C++ 
2230    compiler but MPI was built without the C++ bindings */
2231 @INCLUDE_MPICXX_H@
2232 #endif 
2233 #endif
2234
2235
2236 /* Generalized requests extensions */
2237 typedef int MPIX_Grequest_class;
2238 int MPIX_Grequest_class_create(MPI_Grequest_query_function *query_fn,
2239                                MPI_Grequest_free_function *free_fn,
2240                                MPI_Grequest_cancel_function *cancel_fn,
2241                                MPIX_Grequest_poll_function *poll_fn,
2242                                MPIX_Grequest_wait_function *wait_fn,
2243                                MPIX_Grequest_class *greq_class);
2244 int MPIX_Grequest_class_allocate(MPIX_Grequest_class greq_class, void *extra_state,
2245                                  MPI_Request *request);
2246 int MPIX_Grequest_start(MPI_Grequest_query_function *query_fn,
2247                         MPI_Grequest_free_function *free_fn,
2248                         MPI_Grequest_cancel_function *cancel_fn,
2249                         MPIX_Grequest_poll_function *poll_fn,
2250                         MPIX_Grequest_wait_function *wait_fn, void *extra_state,
2251                         MPI_Request *request);
2252
2253 /* RMA Mutexes Extensions */
2254 struct mpixi_mutex_s;
2255 typedef struct mpixi_mutex_s * MPIX_Mutex;
2256 int MPIX_Mutex_create(int count, MPI_Comm comm, MPIX_Mutex *hdl);
2257 int MPIX_Mutex_free(MPIX_Mutex *hdl);
2258 int MPIX_Mutex_lock(MPIX_Mutex hdl, int mutex, int proc);
2259 int MPIX_Mutex_unlock(MPIX_Mutex hdl, int mutex, int proc);
2260
2261
2262 #if !defined(MPI_BUILD_PROFILING)
2263 /* Generalized requests extensions */
2264 int PMPIX_Grequest_class_create(MPI_Grequest_query_function *query_fn,
2265                                 MPI_Grequest_free_function *free_fn,
2266                                 MPI_Grequest_cancel_function *cancel_fn,
2267                                 MPIX_Grequest_poll_function *poll_fn,
2268                                 MPIX_Grequest_wait_function *wait_fn,
2269                                 MPIX_Grequest_class *greq_class);
2270 int PMPIX_Grequest_class_allocate(MPIX_Grequest_class greq_class, void *extra_state,
2271                                   MPI_Request *request);
2272 int PMPIX_Grequest_start(MPI_Grequest_query_function *query_fn,
2273                          MPI_Grequest_free_function *free_fn,
2274                          MPI_Grequest_cancel_function *cancel_fn,
2275                          MPIX_Grequest_poll_function *poll_fn,
2276                          MPIX_Grequest_wait_function *wait_fn, void *extra_state,
2277                          MPI_Request *request);
2278
2279 /* RMA Mutexes Extensions */
2280 int PMPIX_Mutex_create(int count, MPI_Comm comm, MPIX_Mutex *hdl);
2281 int PMPIX_Mutex_free(MPIX_Mutex *hdl);
2282 int PMPIX_Mutex_lock(MPIX_Mutex hdl, int mutex, int proc);
2283 int PMPIX_Mutex_unlock(MPIX_Mutex hdl, int mutex, int proc);
2284 #endif /* MPI_BUILD_PROFILING */
2285
2286 #endif