netutil

Documentation

Overview

package netutil provides common utility functions for networking.

Index

• func AssignToPrefix(prefix netip.Prefix, publicKey []byte) netip.Prefix
• func GenerateULA() (netip.Prefix, error)
• func GenerateULAWithPSK(psk []byte) netip.Prefix
• func ParsePortRange(s string) (start int, end int, err error)
• func Ping(ctx context.Context, addr netip.Addr) error
• func ResolveTCPAddr(ctx context.Context, lookup string, maxRetries int) (net.Addr, error)
• func VerifyChainOnly(rawCerts [][]byte, _ [][]*x509.Certificate) error

Functions

func AssignToPrefix

func AssignToPrefix(prefix netip.Prefix, publicKey []byte) netip.Prefix

AssignToPrefix assigns a /112 prefix within a /32 prefix using a public key. It does not check that the given prefix is a valid /32 prefix.

func GenerateULA

func GenerateULA() (netip.Prefix, error)

GenerateULA generates a unique local address with a /32 prefix according to RFC 4193. The network is returned as a netip.Prefix.

func GenerateULAWithPSK

func GenerateULAWithPSK(psk []byte) netip.Prefix

GenerateULAWithSecret generates a unique local address with a /32 prefix using a pre-shared key. The network is returned as a netip.Prefix.

func ParsePortRange

func ParsePortRange(s string) (start int, end int, err error)

ParsePortRange parses a port range string.

func Ping

func Ping(ctx context.Context, addr netip.Addr) error

Ping sends ICMP echo requests to the given address. The context must have a timeout set and is used for the duration of the ping. The function returns an error if no replies were received.

func ResolveTCPAddr

func ResolveTCPAddr(ctx context.Context, lookup string, maxRetries int) (net.Addr, error)

ResolveTCPAddr resolves a TCP address with retries and context.

func VerifyChainOnly

func VerifyChainOnly(rawCerts [][]byte, _ [][]*x509.Certificate) error

VerifyChainOnly is a function that can be used in a TLS configuration to only verify that the certificate chain is valid.