diff options
Diffstat (limited to 'openssl/MacOS/GetHTTPS.src/MacSocket.h')
-rw-r--r-- | openssl/MacOS/GetHTTPS.src/MacSocket.h | 104 |
1 files changed, 104 insertions, 0 deletions
diff --git a/openssl/MacOS/GetHTTPS.src/MacSocket.h b/openssl/MacOS/GetHTTPS.src/MacSocket.h new file mode 100644 index 0000000..155d40d --- /dev/null +++ b/openssl/MacOS/GetHTTPS.src/MacSocket.h @@ -0,0 +1,104 @@ +#pragma once + + +#ifdef __cplusplus +extern "C" { +#endif + +enum { + kMacSocket_TimeoutErr = -2 +}; + +// Since MacSocket does busy waiting, I do a callback while waiting + +typedef OSErr(*MacSocket_IdleWaitCallback) (void *); + +// Call this before anything else! + +OSErr MacSocket_Startup(void); + +// Call this to cleanup before quitting + +OSErr MacSocket_Shutdown(void); + +// Call this to allocate a "socket" (reference number is returned in +// outSocketNum) +// Note that inDoThreadSwitching is pretty much irrelevant right now, since I +// ignore it +// The inTimeoutTicks parameter is applied during reads/writes of data +// The inIdleWaitCallback parameter specifies a callback which is called +// during busy-waiting periods +// The inUserRefPtr parameter is passed back to the idle-wait callback + +OSErr MacSocket_socket(int *outSocketNum, const Boolean inDoThreadSwitching, + const long inTimeoutTicks, + MacSocket_IdleWaitCallback inIdleWaitCallback, + void *inUserRefPtr); + +// Call this to connect to an IP/DNS address +// Note that inTargetAddressAndPort is in "IP:port" format-- e.g. +// 10.1.1.1:123 + +OSErr MacSocket_connect(const int inSocketNum, char *inTargetAddressAndPort); + +// Call this to listen on a port +// Since this a low-performance implementation, I allow a maximum of 1 (one!) +// incoming request when I listen + +OSErr MacSocket_listen(const int inSocketNum, const int inPortNum); + +// Call this to close a socket + +OSErr MacSocket_close(const int inSocketNum); + +// Call this to receive data on a socket +// Most parameters' purpose are obvious-- except maybe "inBlock" which +// controls whether I wait for data or return immediately + +int MacSocket_recv(const int inSocketNum, void *outBuff, int outBuffLength, + const Boolean inBlock); + +// Call this to send data on a socket + +int MacSocket_send(const int inSocketNum, const void *inBuff, + int inBuffLength); + +// If zero bytes were read in a call to MacSocket_recv(), it may be that the +// remote end has done a half-close +// This function will let you check whether that's true or not + +Boolean MacSocket_RemoteEndIsClosing(const int inSocketNum); + +// Call this to see if the listen has completed after a call to +// MacSocket_listen() + +Boolean MacSocket_ListenCompleted(const int inSocketNum); + +// These really aren't very useful anymore + +Boolean MacSocket_LocalEndIsOpen(const int inSocketNum); +Boolean MacSocket_RemoteEndIsOpen(const int inSocketNum); + +// You may wish to change the userRefPtr for a socket callback-- use this to +// do it + +void MacSocket_SetUserRefPtr(const int inSocketNum, void *inNewRefPtr); + +// Call these to get the socket's IP:port descriptor + +void MacSocket_GetLocalIPAndPort(const int inSocketNum, char *outIPAndPort, + const int inIPAndPortLength); +void MacSocket_GetRemoteIPAndPort(const int inSocketNum, char *outIPAndPort, + const int inIPAndPortLength); + +// Call this to get error info from a socket + +void MacSocket_GetSocketErrorInfo(const int inSocketNum, + int *outSocketErrCode, + char *outSocketErrString, + const int inSocketErrStringMaxLength); + + +#ifdef __cplusplus +} +#endif |