shttp3

README

HTTP/3 over SCION

This package contains glue code to use the quic-go/http3 libraries for HTTP/3 over SCION.

Usage of this package is analogous to pkg/shttp, and thus analogous to using the net/http standard library.

Documentation

Overview

package shttp3 provides glue to use quic-go/http3 libraries for HTTP/3 over SCION.

Index

• Variables
• func ListenAndServe(addr string, certFile, keyFile string, handler http.Handler) error
• type Dialer
  • func (d *Dialer) Dial(ctx context.Context, addr string, tlsCfg *tls.Config, cfg *quic.Config) (quic.EarlyConnection, error)
  • func (d *Dialer) SetPolicy(policy pan.Policy)
• type Server
  • func (s *Server) ListenAndServe() error
  • func (s *Server) Serve(conn net.PacketConn) error

Variables

var DefaultTransport = &http3.RoundTripper{
	Dial: (&Dialer{
		Policy: nil,
	}).Dial,
}

DefaultTransport is the default RoundTripper that can be used for HTTP/3 over SCION.

Functions

func ListenAndServe

func ListenAndServe(addr string, certFile, keyFile string, handler http.Handler) error

ListenAndServe listens on the SCION/UDP address addr and calls the handler for HTTP/3 requests on incoming connections. http.DefaultServeMux is used when handler is nil.

Types

type Dialer

type Dialer struct {
	Local  netip.AddrPort
	Policy pan.Policy
	// contains filtered or unexported fields
}

Dialer dials a QUIC connection over SCION. This is the Dialer used for shttp3.DefaultTransport.

func (*Dialer) Dial

func (d *Dialer) Dial(ctx context.Context, addr string, tlsCfg *tls.Config,
	cfg *quic.Config) (quic.EarlyConnection, error)

Dial dials a QUIC connection over SCION.

func (*Dialer) SetPolicy

func (d *Dialer) SetPolicy(policy pan.Policy)

type Server

type Server struct {
	*http3.Server
}

Server wraps a http3.Server making it work with SCION

func (*Server) ListenAndServe

func (s *Server) ListenAndServe() error

ListenAndServe listens on the UDP address s.Addr and calls s.Handler to handle HTTP/3 requests on incoming connections.

func (*Server) Serve

func (s *Server) Serve(conn net.PacketConn) error