osiSock.h

Go to the documentation of this file.

/*************************************************************************\
* Copyright (c) 2002 The University of Chicago, as Operator of Argonne
* National Laboratory.
* Copyright (c) 2002 The Regents of the University of California, as
* Operator of Los Alamos National Laboratory.
* SPDX-License-Identifier: EPICS
* EPICS BASE is distributed subject to a Software License Agreement found
* in file LICENSE that is included with this distribution.
\*************************************************************************/

/* Author: joh 1997-07-01 */

#ifndef osiSockh
#define osiSockh

#include "libComAPI.h"
#include "osdSock.h"
#include "ellLib.h"

#ifdef __cplusplus
extern "C" {
#endif

struct sockaddr;
struct sockaddr_in;
struct in_addr;

LIBCOM_API SOCKET epicsStdCall epicsSocketCreate ( 
 int domain, int type, int protocol );

LIBCOM_API SOCKET epicsStdCall epicsSocketAccept (
 SOCKET sock, struct sockaddr * pAddr, osiSocklen_t * addrlen );
LIBCOM_API void epicsStdCall epicsSocketDestroy ( 
 SOCKET );
LIBCOM_API void epicsStdCall 
 epicsSocketEnableAddressReuseDuringTimeWaitState ( SOCKET s );
LIBCOM_API void epicsStdCall 
 epicsSocketEnableAddressUseForDatagramFanout ( SOCKET s );

enum epicsSocketSystemCallInterruptMechanismQueryInfo {
 esscimqi_socketCloseRequired,

 esscimqi_socketBothShutdownRequired,

 esscimqi_socketSigAlarmRequired
};

LIBCOM_API enum epicsSocketSystemCallInterruptMechanismQueryInfo 
 epicsSocketSystemCallInterruptMechanismQuery ();

#ifdef EPICS_PRIVATE_API

LIBCOM_API int epicsSocketUnsentCount(SOCKET sock);
#endif

LIBCOM_API unsigned epicsStdCall sockAddrToA (
 const struct sockaddr * paddr, char * pBuf, unsigned bufSize );

LIBCOM_API unsigned epicsStdCall ipAddrToA (
 const struct sockaddr_in * pInetAddr, char * pBuf, unsigned bufSize );

LIBCOM_API unsigned epicsStdCall sockAddrToDottedIP ( 
 const struct sockaddr * paddr, char * pBuf, unsigned bufSize );

LIBCOM_API unsigned epicsStdCall ipAddrToDottedIP ( 
 const struct sockaddr_in * paddr, char * pBuf, unsigned bufSize );

LIBCOM_API unsigned epicsStdCall ipAddrToHostName (
 const struct in_addr * pAddr, char * pBuf, unsigned bufSize );

LIBCOM_API int epicsStdCall aToIPAddr
 ( const char * pAddrString, unsigned short defaultPort, struct sockaddr_in * pIP);

LIBCOM_API int epicsStdCall hostToIPAddr 
 (const char *pHostName, struct in_addr *pIPA);
LIBCOM_API int epicsStdCall osiSockAttach (void); /* returns T if success, else F */

LIBCOM_API void epicsStdCall osiSockRelease (void);

LIBCOM_API void epicsSocketConvertErrorToString (
 char * pBuf, unsigned bufSize, int error );

LIBCOM_API void epicsSocketConvertErrnoToString (
 char * pBuf, unsigned bufSize );

typedef union osiSockAddr {
 struct sockaddr_in ia;
 struct sockaddr sa;
} osiSockAddr;

typedef struct osiSockAddrNode {
 ELLNODE node;
 osiSockAddr addr;
} osiSockAddrNode;

LIBCOM_API int epicsStdCall sockAddrAreIdentical 
 ( const osiSockAddr * plhs, const osiSockAddr * prhs );

LIBCOM_API void epicsStdCall osiSockDiscoverBroadcastAddresses
 (ELLLIST *pList, SOCKET socket, const osiSockAddr *pMatchAddr);

LIBCOM_API osiSockAddr epicsStdCall osiLocalAddr (SOCKET socket);

#ifdef __cplusplus
}
#endif

#endif /* ifndef osiSockh */