tcp

package
v0.35.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 20, 2024 License: BSD-3-Clause Imports: 6 Imported by: 0

Documentation

Overview

Package tcp represents the imported interface "wasi:sockets/tcp@0.2.0".

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Duration added in v0.34.0 

type Duration = monotonicclock.Duration

Duration represents the type alias "wasi:sockets/tcp@0.2.0#duration".

See monotonicclock.Duration for more information.

type ErrorCode added in v0.34.0 

type ErrorCode = network.ErrorCode

ErrorCode represents the type alias "wasi:sockets/tcp@0.2.0#error-code".

See network.ErrorCode for more information.

type IPAddressFamily added in v0.34.0 

type IPAddressFamily = network.IPAddressFamily

IPAddressFamily represents the type alias "wasi:sockets/tcp@0.2.0#ip-address-family".

See network.IPAddressFamily for more information.

type IPSocketAddress added in v0.34.0 

type IPSocketAddress = network.IPSocketAddress

IPSocketAddress represents the type alias "wasi:sockets/tcp@0.2.0#ip-socket-address".

See network.IPSocketAddress for more information.

type IPSocketAddressShape 

type IPSocketAddressShape struct {
	// contains filtered or unexported fields
}

IPSocketAddressShape is used for storage in variant or result types.

type InputStream added in v0.34.0 

type InputStream = streams.InputStream

InputStream represents the imported type alias "wasi:sockets/tcp@0.2.0#input-stream".

See streams.InputStream for more information.

type Network added in v0.34.0 

type Network = network.Network

Network represents the imported type alias "wasi:sockets/tcp@0.2.0#network".

See network.Network for more information.

type OutputStream added in v0.34.0 

type OutputStream = streams.OutputStream

OutputStream represents the imported type alias "wasi:sockets/tcp@0.2.0#output-stream".

See streams.OutputStream for more information.

type Pollable added in v0.34.0 

type Pollable = poll.Pollable

Pollable represents the imported type alias "wasi:sockets/tcp@0.2.0#pollable".

See poll.Pollable for more information.

type ShutdownType 

type ShutdownType uint8

ShutdownType represents the enum "wasi:sockets/tcp@0.2.0#shutdown-type". 

enum shutdown-type {
	receive,
	send,
	both
}

const (
	// Similar to `SHUT_RD` in POSIX.
	ShutdownTypeReceive ShutdownType = iota

	// Similar to `SHUT_WR` in POSIX.
	ShutdownTypeSend

	// Similar to `SHUT_RDWR` in POSIX.
	ShutdownTypeBoth
)

func (ShutdownType) String 

func (e ShutdownType) String() string

String implements fmt.Stringer, returning the enum case name of e.

type TCPSocket 

type TCPSocket cm.Resource

TCPSocket represents the imported resource "wasi:sockets/tcp@0.2.0#tcp-socket".

A TCP socket resource.

The socket can be in one of the following states: - `unbound` - `bind-in-progress` - `bound` (See note below) - `listen-in-progress` - `listening` - `connect-in-progress` - `connected` - `closed` See <https://github.com/WebAssembly/wasi-sockets/TcpSocketOperationalSemantics.md> for a more information.

Note: Except where explicitly mentioned, whenever this documentation uses the term "bound" without backticks it actually means: in the `bound` state *or higher*. (i.e. `bound`, `listen-in-progress`, `listening`, `connect-in-progress` or `connected`)

In addition to the general error codes documented on the `network::error-code` type, TCP socket methods may always return `error(invalid-state)` when in the `closed` state. 

resource tcp-socket

func (TCPSocket) Accept 

func (self TCPSocket) Accept() (result cm.Result[TupleTCPSocketInputStreamOutputStreamShape, cm.Tuple3[TCPSocket, InputStream, OutputStream], ErrorCode])

Accept represents the imported method "accept".

Accept a new client socket.

The returned socket is bound and in the `connected` state. The following properties are inherited from the listener socket: - `address-family` - `keep-alive-enabled` - `keep-alive-idle-time` - `keep-alive-interval` - `keep-alive-count` - `hop-limit` - `receive-buffer-size` - `send-buffer-size`

On success, this function returns the newly accepted client socket along with a pair of streams that can be used to read & write to the connection.

# Typical errors - `invalid-state`: Socket is not in the `listening` state. (EINVAL) - `would-block`: No pending connections at the moment. (EWOULDBLOCK, EAGAIN) - `connection-aborted`: An incoming connection was pending, but was terminated by the client before this listener could accept it. (ECONNABORTED) - `new-socket-limit`: The new socket resource could not be created because of a system limit. (EMFILE, ENFILE)

# References - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/accept.html> - <https://man7.org/linux/man-pages/man2/accept.2.html> - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-accept> - <https://man.freebsd.org/cgi/man.cgi?query=accept&sektion=2> 

accept: func() -> result<tuple<tcp-socket, input-stream, output-stream>, error-code>

func (TCPSocket) AddressFamily 

func (self TCPSocket) AddressFamily() (result IPAddressFamily)

AddressFamily represents the imported method "address-family".

Whether this is a IPv4 or IPv6 socket.

Equivalent to the SO_DOMAIN socket option. 

address-family: func() -> ip-address-family

func (TCPSocket) FinishBind 

func (self TCPSocket) FinishBind() (result cm.Result[ErrorCode, struct{}, ErrorCode])

FinishBind represents the imported method "finish-bind". 

finish-bind: func() -> result<_, error-code>

func (TCPSocket) FinishConnect 

func (self TCPSocket) FinishConnect() (result cm.Result[TupleInputStreamOutputStreamShape, cm.Tuple[InputStream, OutputStream], ErrorCode])

FinishConnect represents the imported method "finish-connect". 

finish-connect: func() -> result<tuple<input-stream, output-stream>, error-code>

func (TCPSocket) FinishListen 

func (self TCPSocket) FinishListen() (result cm.Result[ErrorCode, struct{}, ErrorCode])

FinishListen represents the imported method "finish-listen". 

finish-listen: func() -> result<_, error-code>

func (TCPSocket) HopLimit 

func (self TCPSocket) HopLimit() (result cm.Result[uint8, uint8, ErrorCode])

HopLimit represents the imported method "hop-limit".

Equivalent to the IP_TTL & IPV6_UNICAST_HOPS socket options.

If the provided value is 0, an `invalid-argument` error is returned.

# Typical errors - `invalid-argument`: (set) The TTL value must be 1 or higher. 

hop-limit: func() -> result<u8, error-code>

func (TCPSocket) IsListening 

func (self TCPSocket) IsListening() (result bool)

IsListening represents the imported method "is-listening".

Whether the socket is in the `listening` state.

Equivalent to the SO_ACCEPTCONN socket option. 

is-listening: func() -> bool

func (TCPSocket) KeepAliveCount 

func (self TCPSocket) KeepAliveCount() (result cm.Result[uint32, uint32, ErrorCode])

KeepAliveCount represents the imported method "keep-alive-count".

The maximum amount of keepalive packets TCP should send before aborting the connection.

If the provided value is 0, an `invalid-argument` error is returned. Any other value will never cause an error, but it might be silently clamped and/or rounded. I.e. after setting a value, reading the same setting back may return a different value.

Equivalent to the TCP_KEEPCNT socket option.

# Typical errors - `invalid-argument`: (set) The provided value was 0. 

keep-alive-count: func() -> result<u32, error-code>

func (TCPSocket) KeepAliveEnabled 

func (self TCPSocket) KeepAliveEnabled() (result cm.Result[bool, bool, ErrorCode])

KeepAliveEnabled represents the imported method "keep-alive-enabled".

Enables or disables keepalive.

The keepalive behavior can be adjusted using: - `keep-alive-idle-time` - `keep-alive-interval` - `keep-alive-count` These properties can be configured while `keep-alive-enabled` is false, but only come into effect when `keep-alive-enabled` is true.

Equivalent to the SO_KEEPALIVE socket option. 

keep-alive-enabled: func() -> result<bool, error-code>

func (TCPSocket) KeepAliveIdleTime 

func (self TCPSocket) KeepAliveIdleTime() (result cm.Result[uint64, Duration, ErrorCode])

KeepAliveIdleTime represents the imported method "keep-alive-idle-time".

Amount of time the connection has to be idle before TCP starts sending keepalive packets.

If the provided value is 0, an `invalid-argument` error is returned. Any other value will never cause an error, but it might be silently clamped and/or rounded. I.e. after setting a value, reading the same setting back may return a different value.

Equivalent to the TCP_KEEPIDLE socket option. (TCP_KEEPALIVE on MacOS)

# Typical errors - `invalid-argument`: (set) The provided value was 0. 

keep-alive-idle-time: func() -> result<duration, error-code>

func (TCPSocket) KeepAliveInterval 

func (self TCPSocket) KeepAliveInterval() (result cm.Result[uint64, Duration, ErrorCode])

KeepAliveInterval represents the imported method "keep-alive-interval".

The time between keepalive packets.

If the provided value is 0, an `invalid-argument` error is returned. Any other value will never cause an error, but it might be silently clamped and/or rounded. I.e. after setting a value, reading the same setting back may return a different value.

Equivalent to the TCP_KEEPINTVL socket option.

# Typical errors - `invalid-argument`: (set) The provided value was 0. 

keep-alive-interval: func() -> result<duration, error-code>

func (TCPSocket) LocalAddress 

func (self TCPSocket) LocalAddress() (result cm.Result[IPSocketAddressShape, IPSocketAddress, ErrorCode])

LocalAddress represents the imported method "local-address".

Get the bound local address.

POSIX mentions: > If the socket has not been bound to a local name, the value > stored in the object pointed to by `address` is unspecified.

WASI is stricter and requires `local-address` to return `invalid-state` when the socket hasn't been bound yet.

# Typical errors - `invalid-state`: The socket is not bound to any local address.

# References - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getsockname.html> - <https://man7.org/linux/man-pages/man2/getsockname.2.html> - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-getsockname> - <https://man.freebsd.org/cgi/man.cgi?getsockname> 

local-address: func() -> result<ip-socket-address, error-code>

func (TCPSocket) ReceiveBufferSize 

func (self TCPSocket) ReceiveBufferSize() (result cm.Result[uint64, uint64, ErrorCode])

ReceiveBufferSize represents the imported method "receive-buffer-size".

The kernel buffer space reserved for sends/receives on this socket.

If the provided value is 0, an `invalid-argument` error is returned. Any other value will never cause an error, but it might be silently clamped and/or rounded. I.e. after setting a value, reading the same setting back may return a different value.

Equivalent to the SO_RCVBUF and SO_SNDBUF socket options.

# Typical errors - `invalid-argument`: (set) The provided value was 0. 

receive-buffer-size: func() -> result<u64, error-code>

func (TCPSocket) RemoteAddress 

func (self TCPSocket) RemoteAddress() (result cm.Result[IPSocketAddressShape, IPSocketAddress, ErrorCode])

RemoteAddress represents the imported method "remote-address".

Get the remote address.

# Typical errors - `invalid-state`: The socket is not connected to a remote address. (ENOTCONN)

# References - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/getpeername.html> - <https://man7.org/linux/man-pages/man2/getpeername.2.html> - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-getpeername> - <https://man.freebsd.org/cgi/man.cgi?query=getpeername&sektion=2&n=1> 

remote-address: func() -> result<ip-socket-address, error-code>

func (TCPSocket) ResourceDrop 

func (self TCPSocket) ResourceDrop()

ResourceDrop represents the imported resource-drop for resource "tcp-socket".

Drops a resource handle.

func (TCPSocket) SendBufferSize 

func (self TCPSocket) SendBufferSize() (result cm.Result[uint64, uint64, ErrorCode])

SendBufferSize represents the imported method "send-buffer-size". 

send-buffer-size: func() -> result<u64, error-code>

func (TCPSocket) SetHopLimit 

func (self TCPSocket) SetHopLimit(value uint8) (result cm.Result[ErrorCode, struct{}, ErrorCode])

SetHopLimit represents the imported method "set-hop-limit". 

set-hop-limit: func(value: u8) -> result<_, error-code>

func (TCPSocket) SetKeepAliveCount 

func (self TCPSocket) SetKeepAliveCount(value uint32) (result cm.Result[ErrorCode, struct{}, ErrorCode])

SetKeepAliveCount represents the imported method "set-keep-alive-count". 

set-keep-alive-count: func(value: u32) -> result<_, error-code>

func (TCPSocket) SetKeepAliveEnabled 

func (self TCPSocket) SetKeepAliveEnabled(value bool) (result cm.Result[ErrorCode, struct{}, ErrorCode])

SetKeepAliveEnabled represents the imported method "set-keep-alive-enabled". 

set-keep-alive-enabled: func(value: bool) -> result<_, error-code>

func (TCPSocket) SetKeepAliveIdleTime 

func (self TCPSocket) SetKeepAliveIdleTime(value Duration) (result cm.Result[ErrorCode, struct{}, ErrorCode])

SetKeepAliveIdleTime represents the imported method "set-keep-alive-idle-time". 

set-keep-alive-idle-time: func(value: duration) -> result<_, error-code>

func (TCPSocket) SetKeepAliveInterval 

func (self TCPSocket) SetKeepAliveInterval(value Duration) (result cm.Result[ErrorCode, struct{}, ErrorCode])

SetKeepAliveInterval represents the imported method "set-keep-alive-interval". 

set-keep-alive-interval: func(value: duration) -> result<_, error-code>

func (TCPSocket) SetListenBacklogSize 

func (self TCPSocket) SetListenBacklogSize(value uint64) (result cm.Result[ErrorCode, struct{}, ErrorCode])

SetListenBacklogSize represents the imported method "set-listen-backlog-size".

Hints the desired listen queue size. Implementations are free to ignore this.

If the provided value is 0, an `invalid-argument` error is returned. Any other value will never cause an error, but it might be silently clamped and/or rounded.

# Typical errors - `not-supported`: (set) The platform does not support changing the backlog size after the initial listen. - `invalid-argument`: (set) The provided value was 0. - `invalid-state`: (set) The socket is in the `connect-in-progress` or `connected` state. 

set-listen-backlog-size: func(value: u64) -> result<_, error-code>

func (TCPSocket) SetReceiveBufferSize 

func (self TCPSocket) SetReceiveBufferSize(value uint64) (result cm.Result[ErrorCode, struct{}, ErrorCode])

SetReceiveBufferSize represents the imported method "set-receive-buffer-size". 

set-receive-buffer-size: func(value: u64) -> result<_, error-code>

func (TCPSocket) SetSendBufferSize 

func (self TCPSocket) SetSendBufferSize(value uint64) (result cm.Result[ErrorCode, struct{}, ErrorCode])

SetSendBufferSize represents the imported method "set-send-buffer-size". 

set-send-buffer-size: func(value: u64) -> result<_, error-code>

func (TCPSocket) Shutdown 

func (self TCPSocket) Shutdown(shutdownType ShutdownType) (result cm.Result[ErrorCode, struct{}, ErrorCode])

Shutdown represents the imported method "shutdown".

Initiate a graceful shutdown.

- `receive`: The socket is not expecting to receive any data from the peer. The `input-stream` associated with this socket will be closed. Any data still in the receive queue at time of calling this method will be discarded. - `send`: The socket has no more data to send to the peer. The `output-stream` associated with this socket will be closed and a FIN packet will be sent. - `both`: Same effect as `receive` & `send` combined.

This function is idempotent. Shutting a down a direction more than once has no effect and returns `ok`.

The shutdown function does not close (drop) the socket.

# Typical errors - `invalid-state`: The socket is not in the `connected` state. (ENOTCONN)

# References - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/shutdown.html> - <https://man7.org/linux/man-pages/man2/shutdown.2.html> - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-shutdown> - <https://man.freebsd.org/cgi/man.cgi?query=shutdown&sektion=2> 

shutdown: func(shutdown-type: shutdown-type) -> result<_, error-code>

func (TCPSocket) StartBind 

func (self TCPSocket) StartBind(network_ Network, localAddress IPSocketAddress) (result cm.Result[ErrorCode, struct{}, ErrorCode])

StartBind represents the imported method "start-bind".

Bind the socket to a specific network on the provided IP address and port.

If the IP address is zero (`0.0.0.0` in IPv4, `::` in IPv6), it is left to the implementation to decide which network interface(s) to bind to. If the TCP/UDP port is zero, the socket will be bound to a random free port.

Bind can be attempted multiple times on the same socket, even with different arguments on each iteration. But never concurrently and only as long as the previous bind failed. Once a bind succeeds, the binding can't be changed anymore.

# Typical errors - `invalid-argument`: The `local-address` has the wrong address family. (EAFNOSUPPORT, EFAULT on Windows) - `invalid-argument`: `local-address` is not a unicast address. (EINVAL) - `invalid-argument`: `local-address` is an IPv4-mapped IPv6 address. (EINVAL) - `invalid-state`: The socket is already bound. (EINVAL) - `address-in-use`: No ephemeral ports available. (EADDRINUSE, ENOBUFS on Windows) - `address-in-use`: Address is already in use. (EADDRINUSE) - `address-not-bindable`: `local-address` is not an address that the `network` can bind to. (EADDRNOTAVAIL) - `not-in-progress`: A `bind` operation is not in progress. - `would-block`: Can't finish the operation, it is still in progress. (EWOULDBLOCK, EAGAIN)

# Implementors note When binding to a non-zero port, this bind operation shouldn't be affected by the TIME_WAIT state of a recently closed socket on the same local address. In practice this means that the SO_REUSEADDR socket option should be set implicitly on all platforms, except on Windows where this is the default behavior and SO_REUSEADDR performs something different entirely.

Unlike in POSIX, in WASI the bind operation is async. This enables interactive WASI hosts to inject permission prompts. Runtimes that don't want to make use of this ability can simply call the native `bind` as part of either `start-bind` or `finish-bind`.

# References - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/bind.html> - <https://man7.org/linux/man-pages/man2/bind.2.html> - <https://learn.microsoft.com/en-us/windows/win32/api/winsock/nf-winsock-bind> - <https://man.freebsd.org/cgi/man.cgi?query=bind&sektion=2&format=html> 

start-bind: func(network: borrow<network>, local-address: ip-socket-address) ->
result<_, error-code>

func (TCPSocket) StartConnect 

func (self TCPSocket) StartConnect(network_ Network, remoteAddress IPSocketAddress) (result cm.Result[ErrorCode, struct{}, ErrorCode])

StartConnect represents the imported method "start-connect".

Connect to a remote endpoint.

On success: - the socket is transitioned into the `connection` state. - a pair of streams is returned that can be used to read & write to the connection

After a failed connection attempt, the socket will be in the `closed` state and the only valid action left is to `drop` the socket. A single socket can not be used to connect more than once.

# Typical errors - `invalid-argument`: The `remote-address` has the wrong address family. (EAFNOSUPPORT) - `invalid-argument`: `remote-address` is not a unicast address. (EINVAL, ENETUNREACH on Linux, EAFNOSUPPORT on MacOS) - `invalid-argument`: `remote-address` is an IPv4-mapped IPv6 address. (EINVAL, EADDRNOTAVAIL on Illumos) - `invalid-argument`: The IP address in `remote-address` is set to INADDR_ANY (`0.0.0.0` / `::`). (EADDRNOTAVAIL on Windows) - `invalid-argument`: The port in `remote-address` is set to 0. (EADDRNOTAVAIL on Windows) - `invalid-argument`: The socket is already attached to a different network. The `network` passed to `connect` must be identical to the one passed to `bind`. - `invalid-state`: The socket is already in the `connected` state. (EISCONN) - `invalid-state`: The socket is already in the `listening` state. (EOPNOTSUPP, EINVAL on Windows) - `timeout`: Connection timed out. (ETIMEDOUT) - `connection-refused`: The connection was forcefully rejected. (ECONNREFUSED) - `connection-reset`: The connection was reset. (ECONNRESET) - `connection-aborted`: The connection was aborted. (ECONNABORTED) - `remote-unreachable`: The remote address is not reachable. (EHOSTUNREACH, EHOSTDOWN, ENETUNREACH, ENETDOWN, ENONET) - `address-in-use`: Tried to perform an implicit bind, but there were no ephemeral ports available. (EADDRINUSE, EADDRNOTAVAIL on Linux, EAGAIN on BSD) - `not-in-progress`: A connect operation is not in progress. - `would-block`: Can't finish the operation, it is still in progress. (EWOULDBLOCK, EAGAIN)

# Implementors note The POSIX equivalent of `start-connect` is the regular `connect` syscall. Because all WASI sockets are non-blocking this is expected to return EINPROGRESS, which should be translated to `ok()` in WASI.

The POSIX equivalent of `finish-connect` is a `poll` for event `POLLOUT` with a timeout of 0 on the socket descriptor. Followed by a check for the `SO_ERROR` socket option, in case the poll signaled readiness.

# References - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/connect.html> - <https://man7.org/linux/man-pages/man2/connect.2.html> - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-connect> - <https://man.freebsd.org/cgi/man.cgi?connect> 

start-connect: func(network: borrow<network>, remote-address: ip-socket-address)
-> result<_, error-code>

func (TCPSocket) StartListen 

func (self TCPSocket) StartListen() (result cm.Result[ErrorCode, struct{}, ErrorCode])

StartListen represents the imported method "start-listen".

Start listening for new connections.

Transitions the socket into the `listening` state.

Unlike POSIX, the socket must already be explicitly bound.

# Typical errors - `invalid-state`: The socket is not bound to any local address. (EDESTADDRREQ) - `invalid-state`: The socket is already in the `connected` state. (EISCONN, EINVAL on BSD) - `invalid-state`: The socket is already in the `listening` state. - `address-in-use`: Tried to perform an implicit bind, but there were no ephemeral ports available. (EADDRINUSE) - `not-in-progress`: A listen operation is not in progress. - `would-block`: Can't finish the operation, it is still in progress. (EWOULDBLOCK, EAGAIN)

# Implementors note Unlike in POSIX, in WASI the listen operation is async. This enables interactive WASI hosts to inject permission prompts. Runtimes that don't want to make use of this ability can simply call the native `listen` as part of either `start-listen` or `finish-listen`.

# References - <https://pubs.opengroup.org/onlinepubs/9699919799/functions/listen.html> - <https://man7.org/linux/man-pages/man2/listen.2.html> - <https://learn.microsoft.com/en-us/windows/win32/api/winsock2/nf-winsock2-listen> - <https://man.freebsd.org/cgi/man.cgi?query=listen&sektion=2> 

start-listen: func() -> result<_, error-code>

func (TCPSocket) Subscribe 

func (self TCPSocket) Subscribe() (result Pollable)

Subscribe represents the imported method "subscribe".

Create a `pollable` which can be used to poll for, or block on, completion of any of the asynchronous operations of this socket.

When `finish-bind`, `finish-listen`, `finish-connect` or `accept` return `error(would-block)`, this pollable can be used to wait for their success or failure, after which the method can be retried.

The pollable is not limited to the async operation that happens to be in progress at the time of calling `subscribe` (if any). Theoretically, `subscribe` only has to be called once per socket and can then be (re)used for the remainder of the socket's lifetime.

See <https://github.com/WebAssembly/wasi-sockets/TcpSocketOperationalSemantics.md#Pollable-readiness> for a more information.

Note: this function is here for WASI Preview2 only. It's planned to be removed when `future` is natively supported in Preview3. 

subscribe: func() -> pollable

type TupleInputStreamOutputStreamShape 

type TupleInputStreamOutputStreamShape struct {
	// contains filtered or unexported fields
}

TupleInputStreamOutputStreamShape is used for storage in variant or result types.

type TupleTCPSocketInputStreamOutputStreamShape 

type TupleTCPSocketInputStreamOutputStreamShape struct {
	// contains filtered or unexported fields
}

TupleTCPSocketInputStreamOutputStreamShape is used for storage in variant or result types.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.