FreeCalypso > hg > fc-selenite
diff src/g23m-fad/tcpip/rnet/rnet_rt/rnet_rt_api_close.c @ 1:d393cd9bb723
src/g23m-*: initial import from Magnetite
author | Mychaela Falconia <falcon@freecalypso.org> |
---|---|
date | Sun, 15 Jul 2018 04:40:46 +0000 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/src/g23m-fad/tcpip/rnet/rnet_rt/rnet_rt_api_close.c Sun Jul 15 04:40:46 2018 +0000 @@ -0,0 +1,71 @@ +/** + * @file rnet_rt_api_close.c + * + * RNET_RT API + * + * @author Regis Feneon + * @version 0.1 + */ + +/* + * $Id: rnet_rt_api_close.c,v 1.3 2002/10/30 15:23:34 rf Exp $ + * $Name: ti_20021030 $ + * + * History: + * + * Date Author Modification + * -------------------------------------------------- + * 3/22/2002 Regis Feneon Create + * + * (C) Copyright 2002 by TI, All Rights Reserved + * + */ + +#include "rnet_cfg.h" + +#ifdef RNET_CFG_REAL_TRANSPORT + +#include "rnet_rt_i.h" +#include "rnet_rt_env.h" + +/** + * Closes the connection. + * + * Use it to release the connection ID so further references to it will fail with + * the error RNET_INVALID_PARAMETER. + * + * An application should always have a matching call to rnet_close for each successful + * call to rnet_new to return any resources to the system. + * + * The function may return RNET_MEMORY_ERR if no memory + * was available for closing the connection. If so, the application + * should wait and try again either by using the error message + * or the polling functionality. + * If the close succeeds, the function returns RNET_OK. + * + * The connection ID is deallocated after a call to rnet_close(). + * + * @param desc Connection identifier. + * @return RNET_MEMORY_ERR Not enough memory is available + * RNET_NOT_INITIALIZED NET subsystem not initialized (internal error). + * RNET_INTERNAL_ERR Network subsystem failed. + * RNET_INVALID_PARAMETER The connection ID is invalid. + * RNET_NOT_READY Still processing a callback function. + * RNET_OK Socket closed. + */ + +T_RNET_RET rnet_rt_close (T_RNET_DESC * desc) +{ + int err; + + /* remove callback and close socket */ + rvf_lock_mutex( &rnet_rt_env_ctrl_blk_p->mutex); + ngSAIOSetCallback( (NGsock *) desc, NULL, NULL); + err = ngSAIOClose( (NGsock *) desc, 1); + rvf_unlock_mutex( &rnet_rt_env_ctrl_blk_p->mutex); + + return( rnet_rt_ngip_error( err)); +} + +#endif /* ifdef RNET_CFG_REAL_TRANSPORT */ +