RAWSocketMBS.Accept(byref RemoteAddress as String, byref RemotePort as Integer, NewSocket as RAWSocketMBS) as RAWSocketMBS

Lasterror is set.

RAWSocketMBS.Bind(DestAddr as Ptr, DestAddrByteSize as Integer) as Boolean

Set ReuseAddress to bind to an address which already a socket is bound to.
Lasterror is set.
Returns true on success and false on failure.
Please specify with port and IP in destAddress where to bind against.
Structure of DestAddress is OS and address family dependent.

See also:

• Bind(Port as Integer, IP as string = "")

RAWSocketMBS.Bind(Port as Integer, IP as string = "")

If IP is not empty, you can bind the socket to only the given network interface with that IPv4.
Set ReuseAddress to bind to an address which already a socket is bound to.
Lasterror is set.

See also:

• Bind(DestAddr as Ptr, DestAddrByteSize as Integer) as Boolean

RAWSocketMBS.Close

Same as destructor.

RAWSocketMBS.Connect(Address as String, Port as Integer, byref ErrorMessage as String) as Boolean

Will parse IPv4/IPv6 or query DNS server for IP and connect.
Returns true on success.

See also:

• Connect(DestAddr as Ptr, DestAddrByteSize as Integer) as Boolean

RAWSocketMBS.Connect(DestAddr as Ptr, DestAddrByteSize as Integer) as Boolean

lasterror is set.
Returns true on success and false on failure.
Please specify with port and IP in destAddress where package is sent to.
Structure of DestAddress is OS and address family dependent.

See also:

• Connect(Address as String, Port as Integer, byref ErrorMessage as String) as Boolean

RAWSocketMBS.Constructor(AddressFamily as Integer, SocketType as Integer, Protocol as Integer)

dim sock as RAWSocketMBS

// create UDP socket
sock = new RAWSocketMBS(RAWSocketMBS.AddressFamilyINet, RAWSocketMBS.SocketTypeDatagram, RAWSocketMBS.ProtocolUDP)

Please pass valid combination of OS supported sockets.
Raises exception if creation is not possible.
Raw socket requires root access.

RAWSocketMBS.Destructor

Closes the socket.

RAWSocketMBS.Listen(BackLog as Integer = 2)

Sockets uses the accept function to enable incoming connection attempts on a socket.
RemoteAddress and RemotePort are set to address of remote peer.

If you like to pass in your own subclass object for NewSocket, we can use that socket object. Otherwise, we make a new RAWSocketMBS object.

Lasterror is set.

RAWSocketMBS.Poll

Calls events if needed.
This is called automatically via timer by the plugin.

RAWSocketMBS.Read(ByteSize as Integer, peek as boolean = false) as MemoryBlock

Pass true for peek if data should not be removed from receiving buffer.
Lasterror is set.

Be aware that you may not get whole packages here, so data may come in several chunks.
For that, please collect the data and look for whether your package is complete or a required end mark arrived.

RAWSocketMBS.ReadAll(peek as boolean = false) as MemoryBlock

dim sock as RAWSocketMBS
dim data as MemoryBlock = sock.ReadAll
if data = nil then
  // nothing read
else
  
end if

Pass true for peek if data should not be removed from receiving buffer.
Lasterror is set.

Be aware that you may not get whole packages here, so data may come in several chunks.
For that, please collect the data and look for whether your package is complete or a required end mark arrived.

RAWSocketMBS.ReadDatagram(peek as boolean = false) as DatagramMBS

If peek is true, the data is not removed from read buffer.
On error returns nil.

Some examples using this method:

• /Network/Raw Socket/Raw Socket for UDP Protocol
• /Network/Raw Socket/Unix Socket doing UDP

RAWSocketMBS.Send(Data as Ptr, DataByteSize as Integer, Flags as Integer = 0) as Integer

Data is sent to address passed with Connect method.
Returns number of bytes sent.
Lasterror is set.

For TCP sockets and similar, which have a stream of data.

RAWSocketMBS.SendMessage(Data as DatagramMBS) as Integer

Please specify with port and address of datagram where package is sent to.
Returns number of bytes sent.
Lasterror is set.

For UDP sockets and similar.

See also:

• SendMessage(Data as MemoryBlock, IP as String, Port as Integer) as Integer
• SendMessage(Data as string, IP as String, Port as Integer) as Integer

RAWSocketMBS.SendMessage(Data as MemoryBlock, IP as String, Port as Integer) as Integer

Please specify with port and IP where package is sent to.
Returns number of bytes sent.
Lasterror is set.

For UDP sockets and similar.

See also:

• SendMessage(Data as DatagramMBS) as Integer
• SendMessage(Data as string, IP as String, Port as Integer) as Integer

RAWSocketMBS.SendMessage(Data as string, IP as String, Port as Integer) as Integer

Please specify with port and IP where package is sent to.
Returns number of bytes sent.
Lasterror is set.

For UDP sockets and similar.

See also:

• SendMessage(Data as DatagramMBS) as Integer
• SendMessage(Data as MemoryBlock, IP as String, Port as Integer) as Integer

RAWSocketMBS.SendTo(Data as Ptr, DataByteSize as Integer, Flags as Integer, DestAddr as Ptr, DestAddrByteSize as Integer) as Integer

dim sock as RawSocketMBS
dim Flags as integer
dim r as Integer

// port
dim port as integer = val(iPort.Text)
if port <= 0 or port >= 65535 then
  break
  MsgBox "Wrong port: "+iPort.Text
  Return
end if

// dest address

'/*
'* Socket address, internet style. C declaration for Mac
'*/
'struct sockaddr_in {
'__uint8_t    sin_len;          // 1 byte, Mac only
'sa_family_t  sin_family;       // 1 byte
'in_port_t    sin_port;         // 2 byte in Network byte order
'struct       in_addr sin_addr; // 4 byte
'char         sin_zero[8];      // 8 bytes filler

'};

// convert IPv4 from text to numeric value
dim IP as Uint32 = RAWSocketMBS.inet_addr(iIP.Text)

// create destination address. This is for Mac! Windows and Linux have different structures
dim dest as new MemoryBlock(16)
dest.UInt8Value(0) = dest.size
dest.UInt8Value(1) = RAWSocketMBS.AddressFamilyINet
dest.UInt16Value(2) = RAWSocketMBS.htons(port)
dest.UInt32Value(4) = IP

// message
dim m as string = ConvertEncoding(iMessage.Text, encodings.UTF8)
dim data as MemoryBlock = m

// send
r = sock.SendTo(data, data.size, Flags, dest, dest.size)

Please specify with port and IP in destAddress where package is sent to.
Returns number of bytes sent. Structure of DestAddress is OS and address family dependent.
Lasterror is set.

For UDP sockets and similar.

Some examples using this method:

• /Network/Raw Socket/Raw Socket for UDP Protocol
• /Network/Raw Socket/Unix Socket doing UDP