From 927e721a25aa720bc28b2be463d4cae049e80651 Mon Sep 17 00:00:00 2001 From: Drew Parsons Date: Tue, 28 Mar 2023 16:24:37 +0200 Subject: [PATCH] docs: faq: clarify name resolver control On Linux systems rclone builds with cgo but uses the internal Go resolver for DNS by default. This update the FAQ to suggest use of GODEBUG=netdns=cgo if there are name resolution problems on Linux/BSD (with CGO_ENABLED rebuild from source if necessary), or try GODEBUG=netdns=go on Windows/MacOS. See: #683 --- docs/content/faq.md | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/docs/content/faq.md b/docs/content/faq.md index 574cd540f..5c489bd1b 100644 --- a/docs/content/faq.md +++ b/docs/content/faq.md @@ -190,9 +190,14 @@ If you are using `systemd-resolved` (default on Arch Linux), ensure it is at version 233 or higher. Previous releases contain a bug which causes not all domains to be resolved properly. -Additionally with the `GODEBUG=netdns=` environment variable the Go -resolver decision can be influenced. This also allows to resolve certain -issues with DNS resolution. See the [name resolution section in the go docs](https://golang.org/pkg/net/#hdr-Name_Resolution). +The Go resolver decision can be influenced with the `GODEBUG=netdns=...` +environment variable. This also allows to resolve certain issues with +DNS resolution. On Windows or MacOS systems, try forcing use of the +internal Go resolver by setting `GODEBUG=netdns=go` at runtime. On +other systems (Linux, \*BSD, etc) try forcing use of the system +name resolver by setting `GODEBUG=netdns=cgo` (and recompile rclone +from source with CGO enabled if necessary). See the +[name resolution section in the go docs](https://golang.org/pkg/net/#hdr-Name_Resolution). ### The total size reported in the stats for a sync is wrong and keeps changing