netboot

Documentation

Overview

Package netboot makes the pure-Go binary self-sufficient for DNS and TLS on hosts that lack the files Go's stdlib expects — most notably Android/Termux, whose read-only /etc has no /etc/resolv.conf and no /etc/ssl/certs, so DNS lookups hit the dead loopback resolver and every outbound HTTPS fails x509 verification.

Termux keeps the real files under $PREFIX (e.g. $PREFIX/etc/resolv.conf, $PREFIX/etc/tls/cert.pem) — the same paths install.sh bind-mounts via proot for third-party CLIs. Setup points Go at those native files instead of embedding a CA bundle or guessing public DNS.

Setup runs as early as possible in each binary's main, before any DB connect or outbound HTTPS. It is a no-op on normal hosts (resolv.conf has a real nameserver; the system cert pool is populated).

Index

• func Setup()

Functions

func Setup

func Setup()

Setup installs the DNS + CA fallbacks once. Idempotent and safe to call from any entry point; no-op when the host is already usable.