You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
104 lines
3.2 KiB
104 lines
3.2 KiB
#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
|
|
|