1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
/*
* Copyright (c) 2001-2002 The Trustees of Indiana University.
* All rights reserved.
* Copyright (c) 1998-2001 University of Notre Dame.
* All rights reserved.
* Copyright (c) 1994-1998 The Ohio State University.
* All rights reserved.
*
* This file is part of the LAM/MPI software package. For license
* information, see the LICENSE file in the top level directory of the
* LAM/MPI source distribution.
*
* $HEADER$
*
* $Id: bsendinit.c,v 6.16 2003/02/20 19:57:13 jsquyres Exp $
*
* Function: - create a buffered send request
* Accepts: - buffer
* - count
* - datatype
* - destination
* - tag
* - communicator
* - request (returned)
* Returns: - MPI_SUCCESS or error code
*/
#include <blktype.h>
#include <mpi.h>
#include <mpisys.h>
#include <rpisys.h>
#if LAM_WANT_IMPI
#include <impi.h>
#include <lamdebug.h>
#endif
/*
* external functions
*/
extern int lam_errfunc();
extern void lam_initerr();
extern void lam_resetfunc();
extern void lam_setfunc();
extern int _mpi_req_build();
/*@
MPI_Bsend_init - Builds a handle for a buffered send
Input Parameters:
+ buf - initial address of send buffer (choice)
. count - number of elements sent (integer)
. dtype - type of each element (handle)
. dest - rank of destination (integer)
. tag - message tag (integer)
- comm - communicator (handle)
Output Parameter:
. req - communication request (handle)
Notes:
It is generally a bad idea to use the 'MPI_Bsend_init' function, as it
guarantees that the entire message will suffer the overhead of an
additional memory copy. For large messages, or when shared memory
message transports are being used, this overhead can be quite
expensive.
The communication initialized by this function will not be started
until 'req' is given to 'MPI_Start' or 'MPI_Startall'.
The communication is then not guaranteed to progress or complete until
'req' has been given to one of the test or wait functions ('MPI_Test',
'MPI_Testall', 'MPI_Testany', 'MPI_Testsome', 'MPI_Wait',
'MPI_Waitall', 'MPI_Waitany', 'MPI_Waitsome').
Once any of the test or wait functions indicate that the communication
has finished, the communication cycle can be started again with
'MPI_Start' or 'MPI_Startall'.
However, once the communication has finished and it is no longer going
to be used, 'req' should be freed with 'MPI_Request_free'.
.N fortran
.N Errors
.N MPI_SUCCESS
.N MPI_ERR_COMM
.N MPI_ERR_COUNT
.N MPI_ERR_TYPE
.N MPI_ERR_RANK
.N MPI_ERR_TAG
.seealso MPI_Buffer_attach, MPI_Buffer_detach, MPI_Bsend, MPI_Start, MPI_Startall, MPI_Test, MPI_Testall, MPI_Testany, MPI_Testsome, MPI_Wait, MPI_Waitall, MPI_Waitany, MPI_Waitsome
.N ACK
@*/
int MPI_Bsend_init(void *buf, int count, MPI_Datatype dtype,
int dest, int tag, MPI_Comm comm,
MPI_Request *req)
{
int err; /* error code */
#if LAM_WANT_IMPI
MPI_Request lreq;
#endif
lam_initerr_m();
lam_setfunc_m(BLKMPIBSINIT);
if (tag < 0 || tag > lam_mpi_max_tag) {
return(lam_errfunc(comm, BLKMPIBSINIT,
lam_mkerr(MPI_ERR_TAG, EINVAL)));
}
if (dest == MPI_ANY_SOURCE) {
return(lam_errfunc(comm, BLKMPIBSINIT,
lam_mkerr(MPI_ERR_RANK, EINVAL)));
}
#if LAM_WANT_IMPI
/* If IMPI_Isend_lamgiappe returns != MPI_REQUEST_NULL, this
is an IMPI proxy send. Need to re-route to the impid. */
IMPI_Isend_lamgiappe_init(LAM_RQISEND, count, dtype, dest, tag,
comm, &lreq);
if (lreq != MPI_REQUEST_NULL) {
dest = impid_comm->c_group->g_nprocs - 1;
tag = IMPI_MESSAGE_TAG;
comm = impid_comm;
}
#endif
/*
* Create the fake user request.
*/
*req = MPI_REQUEST_NULL;
err = _mpi_req_build(buf, count, dtype, dest, tag, comm,
LAM_RQIFAKE, req);
if (err != MPI_SUCCESS) {
return(lam_errfunc(comm, BLKMPIBSINIT, err));
}
(*req)->rq_marks |= (LAM_RQFPERSIST | LAM_RQFMAND);
(*req)->rq_status.MPI_ERROR = MPI_SUCCESS;
(*req)->rq_status.MPI_TAG = MPI_UNDEFINED;
(*req)->rq_status.MPI_SOURCE = MPI_PROC_NULL;
#if LAM_WANT_IMPI
(*req)->rq_shadow = lreq;
#endif
lam_resetfunc_m(BLKMPIBSINIT);
return(MPI_SUCCESS);
}
|
