Set implements the [flag.Value] interface for *uint32Value.

String implements the [flag.Value] interface for *uint32Value.

defineFlag defines a flag with specified setFlag function. o must not be nil.

defineFlagVar defines a flag with the specified [flag.Value] value. o must not be nil.

reply creates a new response message replying to req with the given code.

hdr creates a new DNS header with the given name and RR type.

loadServersList loads a list of DNS servers from the specified list. The thing is that the user may specify either a server address or the path to a

ByName implements the [hostsfile.Storage] interface for [emptyStorage].

RunProxy starts and runs the proxy. l must not be nil. TODO(e.burkov): Move into separate dnssvc package.

isEmpty returns false if uc contains at least a single upstream. uc must not be nil. TODO(e.burkov): Think of a better way to validate the config.

parseCmdLineOptions parses the command-line options. conf must not be nil.

usage prints a usage message similar to the one printed by package flag but taking long vs. short versions into account as well as using more informat

ByAddr implements the [hostsfile.Storage] interface for [emptyStorage].

NewCompressedResponse creates a new compressed response message for req with the given response code.

NewCompressedResponse implements the [messageConstructor] interface for defaultConstructor.

NewDefault creates a new [Default] handler.

NewIPResponse creates a new A/AAAA response message for req with the given IP addresses. All IP addresses must be of the same family.

NewMsgNODATA creates a new empty response message replying to req with the NOERROR code. See https://www.rfc-editor.org/rfc/rfc2308#section-2.2.

NewPTRAnswer creates a new resource record for PTR response with the given FQDN and PTR domain. Arguments must be fully qualified domain names.

ReadHosts reads the hosts files from the file system and returns a storage with parsed records. strg is always usable even if an error occurred.

addOption adds the command-line option described by o to flags using fieldPtr as the pointer to the value.

TODO(e.burkov): Use a separate type for the YAML Configuration file. createProxyConfig initializes [proxy.Config]. l must not be nil.

defaultHostsPaths returns default paths to hosts files for UNIX.

defineTimeutilDurationFlag defines a flag with for the specified [*timeutil.Duration] pointer and command line option. o must not be nil.

genAnswersWithIPv4s generates DNS A answers provided IPv4 addresses. If any of the IPs isn't an IPv4 address, genAnswersWithIPv4s logs a warning and

haltAAAA halts the processing of AAAA requests if IPv6 is disabled. req must not be nil.

hostsFiles returns the list of hosts files to resolve from. It's empty if resolving from hosts files is disabled.

initBogusNXDomain inits BogusNXDomain structure.

initBootstrap initializes the [upstream.Resolver] for bootstrapping upstream servers. It returns the default resolver if no bootstraps were specified

initDNSCryptConfig inits the DNSCrypt config.

initDNSCryptListenAddrs sets up proxy Configuration DNSCrypt listen addresses.

initEDNS inits EDNS-related config fields.

initListenAddrs sets up proxy Configuration listen IP addresses.

initSubnets sets the private subnets Configuration into conf.

initSubnets sets the DNS64 Configuration into conf. TODO(d.kolyshev): Join errors.

initTLSConfig inits the TLS config.

initTLSListenAddrs sets up proxy Configuration TLS listen addresses.

initUpstreams inits upstream-related config fields. TODO(d.kolyshev): Join errors.

loadX509KeyPair reads and parses a public/private key pair from a pair of files. The files must contain PEM encoded data. The certificate file may c

newAnswerA creates a DNS A answer for req with the given IP address.

newAnswerAAAA creates a DNS AAAA answer for req with the given IP address.

newIntSliceValue returns a pointer to intSliceValue with the given value.

newStringSliceValue returns a pointer to stringSliceValue with the given value.

NewTLSConfig returns the TLS config that includes a certificate. Use it for server TLS Configuration or for a client certificate. If caPath is empty

parseConfig returns options parsed from the command args or config file. If no options have been parsed, it returns a suitable exit code and an error

parseConfigFile fills options with the settings from file read by the given path.

parseListenAddrs returns a slice of listen IP addresses from the given options. In case no addresses are specified by options returns a slice with th

processCmdLineOptions decides if dnsproxy should exit depending on the results of command-line option parsing.

readHostsFile reads the hosts file at path and parses it into strg.

reply creates a DNS response for req.

resolveFromHosts resolves the DNS query from the hosts file. It fills the response with the A, AAAA, and PTR records from the hosts file.

runPprof runs pprof server on localhost:6060. TODO(e.burkov): Add debugsvc.

writeUsageLine writes the usage line for the provided command-line option.

DefaultHostsPaths returns the slice of default paths to system hosts files. TODO(s.chzhen): Since [fs.FS] is no longer needed, update the [hostsfile

HandleRequest resolves the DNS request within proxyCtx. It only calls [proxy.Proxy.Resolve] if the request isn't handled by any of the internal handl

Main is the entrypoint of dnsproxy CLI. Main may accept arguments, such as embedded assets and command-line arguments.

NewIPResponse implements the [messageConstructor] interface for [defaultConstructor]

NewMsgNODATA implements the [MessageConstructor] interface for DefaultMessageConstructor.

NewMsgNOTIMPLEMENTED creates a new response message replying to req with the NOTIMPLEMENTED code.

NewMsgNOTIMPLEMENTED implements the [MessageConstructor] interface for DefaultMessageConstructor.

NewMsgNXDOMAIN creates a new response message replying to req with the NXDOMAIN code.

NewMsgNXDOMAIN implements the [MessageConstructor] interface for DefaultMessageConstructor.

NewMsgSERVFAIL creates a new response message replying to req with the SERVFAIL code.

NewMsgSERVFAIL implements the [MessageConstructor] interface for DefaultMessageConstructor.

NewPTRAnswer implements the [messageConstructor] interface for [defaultConstructor].

ParseSubnet parses s either as a CIDR prefix itself, or as an IP address, returning the corresponding single-IP CIDR prefix. TODO(e.burkov): Replace

Set implements the [flag.Value] interface for *float32Value.

Set implements the [flag.Value] interface for *intSliceValue.

Set implements the [flag.Value] interface for *stringSliceValue.

String implements the [flag.Value] interface for *float32Value.

String implements the [flag.Value] interface for *intSliceValue.

String implements the [flag.Value] interface for *stringSliceValue.

defaultHostsPaths returns default paths to hosts files for Windows.