aboutsummaryrefslogtreecommitdiff
path: root/core/net/socket.odin
diff options
context:
space:
mode:
authorJeroen van Rijn <Kelimion@users.noreply.github.com>2023-03-03 15:21:40 +0100
committerJeroen van Rijn <Kelimion@users.noreply.github.com>2023-03-03 15:21:40 +0100
commit798932523e5bc63e473a6a768a47cff6e920cdff (patch)
treefdd7e3786f435f6334ada978d3c4d21b9938656d /core/net/socket.odin
parent5267a864db5717d61465d6bb73ee8005f3568c9f (diff)
Coalesce socket_windows
Diffstat (limited to 'core/net/socket.odin')
-rw-r--r--core/net/socket.odin110
1 files changed, 100 insertions, 10 deletions
diff --git a/core/net/socket.odin b/core/net/socket.odin
index 96985d173..1b73fcf53 100644
--- a/core/net/socket.odin
+++ b/core/net/socket.odin
@@ -1,7 +1,7 @@
/*
- Copyright 2022 Tetralux <tetraluxonpc@gmail.com>
- Copyright 2022 Colin Davidson <colrdavidson@gmail.com>
- Copyright 2022 Jeroen van Rijn <nom@duclavier.com>.
+ Copyright 2022-2023 Tetralux <tetraluxonpc@gmail.com>
+ Copyright 2022-2023 Colin Davidson <colrdavidson@gmail.com>
+ Copyright 2022-2023 Jeroen van Rijn <nom@duclavier.com>.
Made available under Odin's BSD-3 license.
List of contributors:
@@ -16,12 +16,12 @@
*/
package net
-// TODO(tetra): Bluetooth, Raw
-any_socket_to_socket :: proc(any_socket: Any_Socket) -> Socket {
- switch s in any_socket {
+any_socket_to_socket :: proc(socket: Any_Socket) -> Socket {
+ switch s in socket {
case TCP_Socket: return Socket(s)
case UDP_Socket: return Socket(s)
case:
+ // TODO(tetra): Bluetooth, Raw
return Socket({})
}
}
@@ -32,7 +32,7 @@ any_socket_to_socket :: proc(any_socket: Any_Socket) -> Socket {
Calls `parse_hostname_or_endpoint` and `resolve`, then `dial_tcp_from_endpoint`.
*/
-dial_tcp_from_hostname_and_port_string :: proc(hostname_and_port: string, options := default_tcp_options) -> (skt: TCP_Socket, err: Network_Error) {
+dial_tcp_from_hostname_and_port_string :: proc(hostname_and_port: string, options := default_tcp_options) -> (socket: TCP_Socket, err: Network_Error) {
target := parse_hostname_or_endpoint(hostname_and_port) or_return
switch t in target {
case Endpoint:
@@ -55,7 +55,7 @@ dial_tcp_from_hostname_and_port_string :: proc(hostname_and_port: string, option
If a `hostname` of form `a.host.name:9999` is given, the port will be ignored in favor of the explicit `port` param.
*/
-dial_tcp_from_hostname_string_and_explicit_port :: proc(hostname: string, port: int, options := default_tcp_options) -> (skt: TCP_Socket, err: Network_Error) {
+dial_tcp_from_hostname_with_port_override :: proc(hostname: string, port: int, options := default_tcp_options) -> (socket: TCP_Socket, err: Network_Error) {
target := parse_hostname_or_endpoint(hostname) or_return
switch t in target {
case Endpoint:
@@ -72,13 +72,103 @@ dial_tcp_from_hostname_string_and_explicit_port :: proc(hostname: string, port:
unreachable()
}
-dial_tcp_from_address_and_port :: proc(address: Address, port: int, options := default_tcp_options) -> (skt: TCP_Socket, err: Network_Error) {
+// Dial from an Address
+dial_tcp_from_address_and_port :: proc(address: Address, port: int, options := default_tcp_options) -> (socket: TCP_Socket, err: Network_Error) {
return dial_tcp_from_endpoint({address, port}, options)
}
+dial_tcp_from_endpoint :: proc(endpoint: Endpoint, options := default_tcp_options) -> (socket: TCP_Socket, err: Network_Error) {
+ return _dial_tcp_from_endpoint(endpoint, options)
+}
+
dial_tcp :: proc{
dial_tcp_from_endpoint,
dial_tcp_from_address_and_port,
dial_tcp_from_hostname_and_port_string,
- dial_tcp_from_hostname_string_and_explicit_port,
+ dial_tcp_from_hostname_with_port_override,
+}
+
+create_socket :: proc(family: Address_Family, protocol: Socket_Protocol) -> (socket: Any_Socket, err: Network_Error) {
+ return _create_socket(family, protocol)
+}
+
+bind :: proc(socket: Any_Socket, ep: Endpoint) -> (err: Network_Error) {
+ return _bind(socket, ep)
+}
+
+/*
+ This type of socket becomes bound when you try to send data.
+ It is likely what you want if you want to send data unsolicited.
+
+ This is like a client TCP socket, except that it can send data to any remote endpoint without needing to establish a connection first.
+*/
+make_unbound_udp_socket :: proc(family: Address_Family) -> (socket: UDP_Socket, err: Network_Error) {
+ sock := create_socket(family, .UDP) or_return
+ socket = sock.(UDP_Socket)
+ return
+}
+
+/*
+ This type of socket is bound immediately, which enables it to receive data on the port.
+ Since it's UDP, it's also able to send data without receiving any first.
+
+ This is like a listening TCP socket, except that data packets can be sent and received without needing to establish a connection first.
+ The `bound_address` is the address of the network interface that you want to use, or a loopback address if you don't care which to use.
+*/
+make_bound_udp_socket :: proc(bound_address: Address, port: int) -> (socket: UDP_Socket, err: Network_Error) {
+ socket = make_unbound_udp_socket(family_from_address(bound_address)) or_return
+ bind(socket, {bound_address, port}) or_return
+ return
+}
+
+listen_tcp :: proc(interface_endpoint: Endpoint, backlog := 1000) -> (socket: TCP_Socket, err: Network_Error) {
+ assert(backlog > 0 && backlog < int(max(i32)))
+
+ return _listen_tcp(interface_endpoint, backlog)
+}
+
+accept_tcp :: proc(socket: TCP_Socket, options := default_tcp_options) -> (client: TCP_Socket, source: Endpoint, err: Network_Error) {
+ return _accept_tcp(socket, options)
+}
+
+close :: proc(socket: Any_Socket) {
+ _close(socket)
+}
+
+recv_tcp :: proc(socket: TCP_Socket, buf: []byte) -> (bytes_read: int, err: Network_Error) {
+ return _recv_tcp(socket, buf)
+}
+
+recv_udp :: proc(socket: UDP_Socket, buf: []byte) -> (bytes_read: int, remote_endpoint: Endpoint, err: Network_Error) {
+ return _recv_udp(socket, buf)
+}
+
+recv :: proc{recv_tcp, recv_udp}
+
+/*
+ Repeatedly sends data until the entire buffer is sent.
+ If a send fails before all data is sent, returns the amount sent up to that point.
+*/
+send_tcp :: proc(socket: TCP_Socket, buf: []byte) -> (bytes_written: int, err: Network_Error) {
+ return _send_tcp(socket, buf)
+}
+
+/*
+ Sends a single UDP datagram packet.
+
+ Datagrams are limited in size; attempting to send more than this limit at once will result in a Message_Too_Long error.
+ UDP packets are not guarenteed to be received in order.
+*/
+send_udp :: proc(socket: UDP_Socket, buf: []byte, to: Endpoint) -> (bytes_written: int, err: Network_Error) {
+ return _send_udp(socket, buf, to)
+}
+
+send :: proc{send_tcp, send_udp}
+
+shutdown :: proc(socket: Any_Socket, manner: Shutdown_Manner) -> (err: Network_Error) {
+ return _shutdown(socket, manner)
+}
+
+set_option :: proc(socket: Any_Socket, option: Socket_Option, value: any, loc := #caller_location) -> Network_Error {
+ return _set_option(socket, option, value, loc)
} \ No newline at end of file