appquic

Documentation

Overview

Package appquic provides a simple interface to use QUIC over SCION. This package is similar to snet/squic, but offers a smoother interface for applications and, like appnet, it allows to Dial hostnames resolved with RAINS.

Index

• func Dial(remote string, tlsConf *tls.Config, quicConf *quic.Config) (quic.Session, error)
• func DialAddr(raddr *snet.UDPAddr, host string, tlsConf *tls.Config, quicConf *quic.Config) (quic.Session, error)
• func DialAddrEarly(raddr *snet.UDPAddr, host string, tlsConf *tls.Config, quicConf *quic.Config) (quic.EarlySession, error)
• func DialEarly(remote string, tlsConf *tls.Config, quicConf *quic.Config) (quic.EarlySession, error)
• func GetDummyTLSCerts() []tls.Certificate
• func Listen(listen *net.UDPAddr, tlsConf *tls.Config, quicConfig *quic.Config) (quic.Listener, error)
• func ListenPort(port uint16, tlsConf *tls.Config, quicConfig *quic.Config) (quic.Listener, error)

Functions

func Dial

func Dial(remote string, tlsConf *tls.Config, quicConf *quic.Config) (quic.Session, error)

Dial establishes a new QUIC connection to a server at the remote address. The address can be of the form of a SCION address (i.e. of the form "ISD-AS,[IP]:port") or in the form of hostname:port.

func DialAddr

func DialAddr(raddr *snet.UDPAddr, host string, tlsConf *tls.Config, quicConf *quic.Config) (quic.Session, error)

DialAddr establishes a new QUIC connection to a server at the remote address.

If no path is specified in raddr, DialAddr will choose the first available path, analogous to appnet.DialAddr. The host parameter is used for SNI. The tls.Config must define an application protocol (using NextProtos).

func DialAddrEarly

func DialAddrEarly(raddr *snet.UDPAddr, host string, tlsConf *tls.Config, quicConf *quic.Config) (quic.EarlySession, error)

DialAddrEarly establishes a new 0-RTT QUIC connection to a server. Analogous to DialAddr.

func DialEarly

func DialEarly(remote string, tlsConf *tls.Config, quicConf *quic.Config) (quic.EarlySession, error)

DialEarly establishes a new 0-RTT QUIC connection to a server. Analogous to Dial.

func GetDummyTLSCerts

func GetDummyTLSCerts() []tls.Certificate

GetDummyTLSCert returns the singleton TLS certificate with a fresh private key and a dummy certificate.

func Listen

func Listen(listen *net.UDPAddr, tlsConf *tls.Config, quicConfig *quic.Config) (quic.Listener, error)

func ListenPort

func ListenPort(port uint16, tlsConf *tls.Config, quicConfig *quic.Config) (quic.Listener, error)

ListenPort listens for QUIC connections on a SCION/UDP port.

See note on wildcard addresses in the appnet package documentation.