1 |
145 |
lanttu |
/*
|
2 |
|
|
* Copyright (c) 2010, Mentor Graphics Corporation
|
3 |
|
|
* All rights reserved.
|
4 |
|
|
*
|
5 |
|
|
* Redistribution and use in source and binary forms, with or without
|
6 |
|
|
* modification, are permitted provided that the following conditions are met:
|
7 |
|
|
*
|
8 |
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
9 |
|
|
* this list of conditions and the following disclaimer.
|
10 |
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
11 |
|
|
* this list of conditions and the following disclaimer in the documentation
|
12 |
|
|
* and/or other materials provided with the distribution.
|
13 |
|
|
* 3. Neither the name of the <ORGANIZATION> nor the names of its contributors
|
14 |
|
|
* may be used to endorse or promote products derived from this software
|
15 |
|
|
* without specific prior written permission.
|
16 |
|
|
*
|
17 |
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
18 |
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
19 |
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
20 |
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
|
21 |
|
|
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
|
22 |
|
|
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
|
23 |
|
|
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
24 |
|
|
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
|
25 |
|
|
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
26 |
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
|
27 |
|
|
* POSSIBILITY OF SUCH DAMAGE.
|
28 |
|
|
*/
|
29 |
|
|
|
30 |
|
|
|
31 |
|
|
|
32 |
|
|
#include <openmcapi.h>
|
33 |
|
|
|
34 |
|
|
/*************************************************************************
|
35 |
|
|
*
|
36 |
|
|
* FUNCTION
|
37 |
|
|
*
|
38 |
|
|
* mcapi_sclchan_recv_close_i
|
39 |
|
|
*
|
40 |
|
|
* DESCRIPTION
|
41 |
|
|
*
|
42 |
|
|
* Non-blocking API routine to close the receive side of a scalar
|
43 |
|
|
* channel. Close calls are required on both the send and receive
|
44 |
|
|
* side to properly close the channel. All pending scalars are
|
45 |
|
|
* discarded from the endpoint.
|
46 |
|
|
*
|
47 |
|
|
* INPUTS
|
48 |
|
|
*
|
49 |
|
|
* receive_handle The local receive handle identifier for
|
50 |
|
|
* the receive side of the connection being
|
51 |
|
|
* closed.
|
52 |
|
|
* *request A pointer to memory that will be filled in
|
53 |
|
|
* with data relevant to the operation, so the
|
54 |
|
|
* status of the operation can later be checked.
|
55 |
|
|
* *mcapi_status A pointer to memory that will be filled in
|
56 |
|
|
* with the status of the call.
|
57 |
|
|
*
|
58 |
|
|
* OUTPUTS
|
59 |
|
|
*
|
60 |
|
|
* None.
|
61 |
|
|
*
|
62 |
|
|
*************************************************************************/
|
63 |
|
|
void mcapi_sclchan_recv_close_i(mcapi_sclchan_recv_hndl_t receive_handle,
|
64 |
|
|
mcapi_request_t *request,
|
65 |
|
|
mcapi_status_t *mcapi_status)
|
66 |
|
|
{
|
67 |
|
|
MCAPI_GLOBAL_DATA *node_data;
|
68 |
|
|
mcapi_node_t node_id;
|
69 |
|
|
mcapi_port_t port_id;
|
70 |
|
|
MCAPI_ENDPOINT *endp_ptr;
|
71 |
|
|
|
72 |
|
|
/* Ensure the status pointer is valid. */
|
73 |
|
|
if (mcapi_status)
|
74 |
|
|
{
|
75 |
|
|
/* Get the lock. */
|
76 |
|
|
mcapi_lock_node_data();
|
77 |
|
|
|
78 |
|
|
/* Get a pointer to the global node list. */
|
79 |
|
|
node_data = mcapi_get_node_data();
|
80 |
|
|
|
81 |
|
|
/* Get a pointer to the endpoint. */
|
82 |
|
|
endp_ptr = mcapi_decode_local_endpoint(node_data, &node_id, &port_id,
|
83 |
|
|
receive_handle, mcapi_status);
|
84 |
|
|
|
85 |
|
|
if (endp_ptr)
|
86 |
|
|
{
|
87 |
|
|
/* Close the receive side of the connection. */
|
88 |
|
|
mcapi_close(endp_ptr, MCAPI_CHAN_SCAL_TYPE, request,
|
89 |
|
|
MCAPI_ENDP_RX, mcapi_status);
|
90 |
|
|
}
|
91 |
|
|
|
92 |
|
|
/* The receive handle is invalid. */
|
93 |
|
|
else if (*mcapi_status == MCAPI_ERR_ENDP_INVALID)
|
94 |
|
|
{
|
95 |
|
|
*mcapi_status = MCAPI_ERR_CHAN_INVALID;
|
96 |
|
|
}
|
97 |
|
|
|
98 |
|
|
/* Release the lock. */
|
99 |
|
|
mcapi_unlock_node_data();
|
100 |
|
|
}
|
101 |
|
|
|
102 |
|
|
}
|