Definition:

#include <aIO.h>
object code: aIO shared library



aLIBRETURN aStream_CreateSocket(

aIOLib ioRef, const unsigned long address, const unsigned short port, const aBool bServer, aStreamRef* pStreamRef, aErr* pErr);

Parameters:

ioRef	-	A reference to the aIO library used to create the stream.
address	-	The internet address in network byte order.
port	-	The TCP/IP port for the socket.
bServer	-	This boolean is true if the socket is to be the server for the connection, false if it is to be a client.
pStreamRef	-	A pointer to a stream reference that is set to the newly created file stream.  Socket streams are readable and writeable.
pErr	-	A pointer to an aErr variable that receives the error code on exit from this routine.

Return Value:

This library routine returns zero for no errors, and non-zero for errors.

Description:

This routine builds an aStreamRef stream reference object for a specified TCP/IP port on the given address.  Server and client sockets can both be created.  The socket settings are for no Nagle byte coelescing algorithm and also no delay on destroy. error occurs.  Socket streams are readable and writeable.  As bytes arrive at the socket, they are buffered.  When using socket streams, it is your responsibility to keep this buffer from over-running.  Reading from the stream until there are no more bytes available will clear the buffer.

Related:

aStream_Create, aStream_CreateFileInput, aStream_CreateFileOutput, aStream_CreateSerial, aStream_Destroy, aStem_SetStream