OpenCores
URL https://opencores.org/ocsvn/funbase_ip_library/funbase_ip_library/trunk

Subversion Repositories funbase_ip_library

[/] [funbase_ip_library/] [trunk/] [TUT/] [ip.swp.api/] [openmcapi/] [1.0/] [libmcapi/] [mcapi/] [mcapi_sclchan_snd_close_i.c] - Blame information for rev 145

Details | Compare with Previous | View Log

Line No. Rev Author Line
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_send_close_i
39
*
40
*   DESCRIPTION
41
*
42
*       Non-blocking API routine to close the send side of a scalar
43
*       channel.  Close calls are required on both the send and receive
44
*       side to properly close the channel.  Pending scalars at the
45
*       receiver are not discarded until the receive side is closed.
46
*       Attempts to transmit more data from a closed send side will
47
*       elicit an error.
48
*
49
*   INPUTS
50
*
51
*       send_handle             The local send handle identifier for
52
*                               the send side of the connection being
53
*                               closed.
54
*       *request                A pointer to memory that will be filled in
55
*                               with data relevant to the operation, so the
56
*                               status of the operation can later be checked.
57
*       *mcapi_status           A pointer to memory that will be filled in
58
*                               with the status of the call.
59
*
60
*   OUTPUTS
61
*
62
*       None.
63
*
64
*************************************************************************/
65
void mcapi_sclchan_send_close_i(mcapi_sclchan_send_hndl_t send_handle,
66
                                mcapi_request_t *request,
67
                                mcapi_status_t *mcapi_status)
68
{
69
    MCAPI_GLOBAL_DATA   *node_data;
70
    mcapi_port_t        port_id;
71
    mcapi_node_t        node_id;
72
    MCAPI_ENDPOINT      *endp_ptr;
73
 
74
    /* Ensure the status pointer is valid. */
75
    if (mcapi_status)
76
    {
77
        /* Get the lock. */
78
        mcapi_lock_node_data();
79
 
80
        /* Get a pointer to the global node list. */
81
        node_data = mcapi_get_node_data();
82
 
83
        /* Get a pointer to the endpoint. */
84
        endp_ptr = mcapi_decode_local_endpoint(node_data, &node_id, &port_id,
85
                                               send_handle, mcapi_status);
86
 
87
        if (endp_ptr)
88
        {
89
            /* Close the receive side of the connection. */
90
            mcapi_close(endp_ptr, MCAPI_CHAN_SCAL_TYPE, request,
91
                        MCAPI_ENDP_TX, mcapi_status);
92
        }
93
 
94
        else if (*mcapi_status == MCAPI_ERR_ENDP_INVALID)
95
        {
96
            *mcapi_status = MCAPI_ERR_CHAN_INVALID;
97
        }
98
 
99
        /* Release the lock. */
100
        mcapi_unlock_node_data();
101
    }
102
 
103
}

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.