Document --validate daemon option

Anca Iordache · aiordache · commit cf1442df9975 · 2021-05-26T19:25:09.000+02:00
Signed-off-by: Anca Iordache &lt;anca.iordache@docker.com&gt;
diff --git a/contrib/completion/bash/docker b/contrib/completion/bash/docker
@@ -2560,6 +2560,7 @@ _docker_daemon() {
 		--raw-logs
 		--selinux-enabled
 		--userland-proxy=false
+		--validate
 		--version -v
 	"
 	local options_with_args="
diff --git a/contrib/completion/zsh/_docker b/contrib/completion/zsh/_docker
@@ -2791,7 +2791,8 @@ __docker_subcommand() {
                 "($help)--tlsverify[Use TLS and verify the remote]" \
                 "($help)--userns-remap=[User/Group setting for user namespaces]:user\:group:->users-groups" \
                 "($help)--userland-proxy[Use userland proxy for loopback traffic]" \
-                "($help)--userland-proxy-path=[Path to the userland proxy binary]:binary:_files" && ret=0
+                "($help)--userland-proxy-path=[Path to the userland proxy binary]:binary:_files" \
+                "($help)--validate[Validate daemon configuration and exit]" && ret=0
 
             case $state in
                 (cluster-store)
diff --git a/docs/reference/commandline/dockerd.md b/docs/reference/commandline/dockerd.md
@@ -104,6 +104,7 @@ Options:
       --userland-proxy                        Use userland proxy for loopback traffic (default true)
       --userland-proxy-path string            Path to the userland proxy binary
       --userns-remap string                   User/Group setting for user namespaces
+      --validate                              Validate configuration file and exit
   -v, --version                               Print version information and quit
 ```
 
@@ -1334,6 +1335,19 @@ For example, the daemon fails to start if you set daemon labels
 in the configuration file and also set daemon labels via the `--label` flag.
 Options that are not present in the file are ignored when the daemon starts.
 
+The `--validate` option allows to validate a configuration file without
+starting the Docker daemon.
+
+```console
+$ dockerd --validate --config-file=/tmp/valid-config.json
+Config OK
+
+
+$ dockerd --validate --config-file /tmp/invalid-config.json
+unable to configure the Docker daemon with file /tmp/invalid-config.json: the following directives don't match any configuration option: unknown-option
+```
+
+
 ##### On Linux
 
 The default location of the configuration file on Linux is
diff --git a/man/dockerd.8.md b/man/dockerd.8.md
@@ -75,6 +75,7 @@ dockerd - Enable daemon mode
 [**--userland-proxy**[=*true*]]
 [**--userland-proxy-path**[=*""*]]
 [**--userns-remap**[=*default*]]
+[**--validate**]
 
 # DESCRIPTION
 **dockerd** is used for starting the Docker daemon (i.e., to command the daemon
@@ -411,6 +412,9 @@ unix://[/path/to/socket] to use.
   daemon to lookup the user and group's subordinate ID ranges for use as the
   user namespace mappings for contained processes.
 
+**--validate**
+  Validate the daemon configuration and exit.
+
 # STORAGE DRIVER OPTIONS
 
 Docker uses storage backends (known as "graphdrivers" in the Docker

Original file line number	Diff line number	Diff line change
`@@ -2560,6 +2560,7 @@ _docker_daemon() {`
`2560`	`2560`	`--raw-logs`
`2561`	`2561`	`--selinux-enabled`
`2562`	`2562`	`--userland-proxy=false`
	`2563`	`+ --validate`
`2563`	`2564`	`--version -v`
`2564`	`2565`	`"`
`2565`	`2566`	`local options_with_args="`