From 462f18c7b25fe3e467f837647d07ab0a78aa8d2b Mon Sep 17 00:00:00 2001 From: marha Date: Sun, 22 Feb 2015 21:39:56 +0100 Subject: Merged origin/release (checked in because wanted to merge new stuff) --- openssl/MacOS/GetHTTPS.src/MacSocket.h | 107 +++++++++++++++++---------------- 1 file changed, 54 insertions(+), 53 deletions(-) (limited to 'openssl/MacOS/GetHTTPS.src') diff --git a/openssl/MacOS/GetHTTPS.src/MacSocket.h b/openssl/MacOS/GetHTTPS.src/MacSocket.h index ad59dc9e4..155d40d20 100644 --- a/openssl/MacOS/GetHTTPS.src/MacSocket.h +++ b/openssl/MacOS/GetHTTPS.src/MacSocket.h @@ -5,97 +5,98 @@ extern "C" { #endif - - -enum -{ - kMacSocket_TimeoutErr = -2 +enum { + kMacSocket_TimeoutErr = -2 }; +// Since MacSocket does busy waiting, I do a callback while waiting -// Since MacSocket does busy waiting, I do a callback while waiting - -typedef OSErr (*MacSocket_IdleWaitCallback)(void *); +typedef OSErr(*MacSocket_IdleWaitCallback) (void *); - -// Call this before anything else! +// Call this before anything else! OSErr MacSocket_Startup(void); - -// Call this to cleanup before quitting +// 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 -// 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); +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 -// 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_connect(const int inSocketNum, char *inTargetAddressAndPort); -OSErr MacSocket_listen(const int inSocketNum,const int inPortNum); +// 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 +// 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 -// 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); -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); -// 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 +// 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() +// 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 +// 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 -// 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_SetUserRefPtr(const int inSocketNum, void *inNewRefPtr); -void MacSocket_GetLocalIPAndPort(const int inSocketNum,char *outIPAndPort,const int inIPAndPortLength); -void MacSocket_GetRemoteIPAndPort(const int inSocketNum,char *outIPAndPort,const int inIPAndPortLength); +// 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 +// Call this to get error info from a socket -void MacSocket_GetSocketErrorInfo(const int inSocketNum,int *outSocketErrCode,char *outSocketErrString,const int inSocketErrStringMaxLength); +void MacSocket_GetSocketErrorInfo(const int inSocketNum, + int *outSocketErrCode, + char *outSocketErrString, + const int inSocketErrStringMaxLength); #ifdef __cplusplus -- cgit v1.2.3