disabling cache; it's not really necessary.

conf/_testdata/test.toml

@@ -1,3 +1,10 @@
+# This file is heavily commented explaining various configuration options.
+# The other configuration file examples are uncommented, but their field names
+#   should be easily visually mapped to the ones in here.
+# All example configuration files evaluate to the same configuration.
+# The test_uncommented.toml file is the exact same is this but without
+#   empty newlines and comments.
+
 # DefaultUsername specifies the default username to use for
 #   authenticating to tunnelbroker.net.
 # It is optional, as the username can be specified for each Tunnel,
@@ -50,16 +57,17 @@ CacheDbPath = '/var/cache/gobroke.db'
 	#   and the parent directory (see below).
 	[CacheDbPerms.File]
 		# The User is optional.
-		# If unspecified, the default behavir mentioned above is performed.
-		# If specified as an empty string, the runtime EUID is enforced.
-		# Otherwise it may be a username or a UID (checked in that order).
+		# If specified as '-1', the owner will not be modified/enforced.
+		# If specified as an empty string (the default), the runtime EUID is enforced.
+		# Otherwise, it may be a username or a UID (checked in that order).
+		# (For new files/directories, the OS default behavior is used.)
 		User = ""
-		# Group is also optional, and follows the same logic except
+		# Group is also optional, and follows the same exact logic as User except
 		#   for EGID/groupnames/GIDs.
 		Group = ""
 		# Mode is optional also.
 		# It *must* be equal to the octal mode bits (e.g. it must be an
-		#   unsigned integer), but may be represented in multiple ways.
+		#   unsigned integer 0-4095), but may be represented in multiple ways.
 		# e.g.:
 		#   Mode = 0o0600
 		#   Mode = 0o600
@@ -75,12 +83,15 @@ CacheDbPath = '/var/cache/gobroke.db'
 		#   you can use the calculator here:
 		#       https://rubendougall.co.uk/projects/permissions-calculator/
 		#       (source: https://github.com/Ruben9922/permissions-calculator )
-		#       (Supports "special" bits)
+		#       (Supports/includes "special" bits)
 		#   or here:
 		#       https://wintelguy.com/permissions-calc.pl
 		#       (beware of ads)
 		#       (provides an explanation of the bits)
 		# Or see https://en.wikipedia.org/wiki/Chmod
+		# Note that this does, technically, work on Windows but only read vs. read-write
+		#   for the User is used (https://pkg.go.dev/os?GOOS=windows#Chmod).
+		# If not specified, the default is 0o0600 for files and 0o0700 for directories.
 		Mode = 0o0600
 	# Dir permissions specifiy permissions/ownership of the parent directory of the cache DB.
 	# The same rules, logic, behavior, etc. as in CacheDbPerms.File apply here.

conf/_testdata/test_uncommented.toml

@@ -0,0 +1,57 @@
+DefaultUsername = "default_user"
+SingleTunnel = true
+CacheDbPath = '/var/cache/gobroke.db'
+[CacheDbPerms]
+	[CacheDbPerms.File]
+		User = ""
+		Group = ""
+		Mode = 0o0600
+	[CacheDbPerms.Dir]
+		User = ""
+		Group = ""
+		Mode = 0o0700
+[[Tunnel]]
+	TunnelID = 123
+	ExplicitClientIP = '203.0.113.1'
+	MTU = 1450
+	Username = "specific_user"
+	UpdateKey = "abcdef"
+	[[Tunnel.ConfigTemplate]]
+		Template = "/etc/gobroke/tpl/dnsmasq/ra_dhcpv6.conf.tpl"
+		Destination = "/etc/dnsmasq.d/ra_dhcpv6.conf"
+		[[Tunnel.ConfigTemplate.Permissions]]
+			[[Tunnel.ConfigTemplate.Permissions.File]]
+				User = ""
+				Group = ""
+				Mode = 0o0600
+			[[Tunnel.ConfigTemplate.Permissions.Dir]]
+				User = ""
+				Group = ""
+				Mode = 0o0700
+		[[Tunnel.ConfigTemplate.Command]]
+			ProgramPath = '/usr/local/bin/somecmd'
+			Args = [
+				'-f', 'foo',
+			]
+			IsolatedEnv = false
+			EnvVars = [
+				'SOMEENV=SOMEVAL',
+			]
+			OnChange = true
+			IsTemplate = false
+	[[Tunnel.ConfigTemplate]]
+		Template = "/etc/gobroke/tpl/stat.tpl"
+		Destination = "/tmp/gobroke.dump"
+	[[Tunnel.Command]]
+		ProgramPath = 'systemctl'
+		Args = [
+			'restart',
+			'someservice',
+		]
+		OnChange = true
+[[Tunnel]]
+	TunnelID = 456
+	Username = "specific_user"
+	UpdateKey = "defghi"
+[[Command]]
+	ProgramPath = "/usr/local/bin/alltunpsrogram"