moonbitstack/moonnet/tcp does not have a README file
Refused
Conn
type ConnOne TCP connection, in the clear or under TLS 1.3. It reads and writes through @io.Reader and
@io.Writer either way, so a protocol driver serves both with the same code.
One task may read while another writes. Writes are serialised, so two tasks writing at once
put whole messages on the wire, one after the other, and TLS records stay in sequence.
Conn::_direct_read
Conn::_get_internal_buffer
#deprecated("`Conn::_get_internal_buffer` is deprecated, use `@moonbitlang/async/io.Reader::_get_internal_buffer` instead.")
fn Conn::_get_internal_buffer(self : Conn) -> ReaderBufferConn::alpn
The application protocol ALPN settled on (RFC 7301). None in the clear.
Conn::client
The client side of a TLS connection to host, returned once the handshake is done and the
server's chain has been judged under config. now, in seconds since the epoch, is the time
the chain is judged at; the system clock when not given.
Conn::close
Close the socket. Call shutdown first for a clean end under TLS.
Conn::opens_tls
Whether the peer's stream opens with a TLS handshake record (RFC 8446 §5.1, content type 22),
without consuming it. No HTTP/1.1 method or HTTP/2 preface starts with that octet.
Conn::peer
The certificate chain the peer presented, DER, leaf first. Empty in the clear.
Conn::read
Conn::secure
Run the server side of a TLS handshake on a connection that is still in the clear, starting
from what a sniff has already read ahead, and return the TLS connection once it is done. This
is how one port serves TLS and the clear: look with opens_tls, then secure the ones that do.
A connection that is already TLS raises Refused::Secured.
Conn::server
The server side of a TLS connection, returned once the handshake is done. A handshake the
client fails raises the alert, after it has been sent. now, in seconds since the epoch, is
what tickets are issued and judged at and a client's certificate is judged at; the system clock
when not given.
Conn::server_name
The host name the client asked for (RFC 6066 §3). None in the clear.
Conn::shutdown
End the stream: under TLS a close_notify (RFC 8446 §6.1), so the peer can tell the end from a
truncation. The peer may still send; read on until the end of its stream. In the clear there
is nothing to send.
Conn::starts_with
Whether the peer's stream opens with prefix, without consuming it. Reads only as far as the
first byte that differs, so a message shorter than prefix that is not it is not waited on —
which is what telling an HTTP/2 preface from an HTTP/1.1 request needs.
Ask before reading anything else: what a read has already taken is not looked at again.
Conn::tls
The TLS connection underneath, for what the accessors here do not say: the suite, the key
update, the refusal reason. None in the clear.
Conn::upgrade
Run the client side of a TLS handshake on a connection that is still in the clear, and
return the TLS connection once it is done: the STARTTLS of SMTP, IMAP and POP3, after the
server agreed. Octets already read ahead in the clear are dropped, since nothing protected
them (RFC 3207 §4.2, from the client's side). now is as for client.
A connection that is already TLS raises Refused::Secured.
Conn::write_once
Listener
type ListenerA bound, listening socket. Connections queue from the moment listen returns, so a caller
can connect to it, or hand its port out, without racing the server.
Listener::accept
The next connection and its peer's address, after the TLS handshake when there is TLS. A
handshake that fails or runs out of time raises, with the socket closed.
Listener::addr
The address listened on; with port 0 asked for, the port the system chose.
Listener::serve
Run handler on each connection with the peer's address. When the handler returns, a TLS
connection is shut down with a close_notify. A connection whose handshake fails, or whose
handler raises, is closed without stopping the server. Runs until cancelled, then closes the
listener.
limit caps the connections served at once; the rest wait in the listen queue.
dial
Connect to host:port, under TLS when tls is given, and return once the handshake is done.
The host is resolved, then names the server for SNI and for checking its certificate.
handshake
let handshake : IntHow long a TLS handshake may take, in milliseconds: asyncio's and hypercorn's 60 seconds. A
peer that connects and never finishes holds a connection slot until then.
host
let host : StringThe address a server listens on when none is given: loopback only, as uvicorn and Starlette
default to, so a development server is not reachable from the network by accident.
listen
Bind host:port and listen, for TLS connections when tls is given. Port 0 asks the system
for a free one; addr says which. reuse_addr lets a restarted server bind while the old
socket lingers in TIME_WAIT, as uvicorn does. handshake bounds each TLS handshake; None
waits for ever.
cleartext lets a TLS listener take connections in the clear too, on the same port: one that
opens with a TLS handshake record is served TLS, any other is left in the clear. Off, a TLS
listener takes TLS only.
Install
Download zipNetworking for MoonBit: connections, listeners and dialers over TCP, TLS and QUIC.
networkingnetworksockettcptlshttpsconnectionlistenerdialerclientserverasynchttpquicmoonbit
Apache-2.0
Updated 10 hours ago
1K downloads