components/docker/files/man/docker-network-inspect.1
changeset 6468 af5d82385cd7
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/components/docker/files/man/docker-network-inspect.1	Wed Jul 20 17:19:20 2016 -0700
@@ -0,0 +1,139 @@
+.TH "DOCKER" "1" " Docker User Manuals" "Docker Community" "OCT 2015"  ""
+
+
+.SH NAME
+.PP
+docker\-network\-inspect \- inspect a network
+
+
+.SH SYNOPSIS
+.PP
+\fBdocker network inspect\fP
+[\fB\-f\fP|\fB\-\-format\fP[=\fIFORMAT\fP]]
+[\fB\-\-help\fP]
+NETWORK [NETWORK...]
+
+
+.SH DESCRIPTION
+.PP
+Returns information about one or more networks. By default, this command renders all results in a JSON object. For example, if you connect two containers to the default \fB\fCbridge\fR network:
+
+.PP
+.RS
+
+.nf
+$ sudo docker run \-itd \-\-name=container1 busybox
+f2870c98fd504370fb86e59f32cd0753b1ac9b69b7d80566ffc7192a82b3ed27
+
+$ sudo docker run \-itd \-\-name=container2 busybox
+bda12f8922785d1f160be70736f26c1e331ab8aaf8ed8d56728508f2e2fd4727
+
+.fi
+.RE
+
+.PP
+The \fB\fCnetwork inspect\fR command shows the containers, by id, in its
+results. You can specify an alternate format to execute a given
+template for each result. Go's
+
+\[la]http://golang.org/pkg/text/template/\[ra] package
+describes all the details of the format.
+
+.PP
+.RS
+
+.nf
+$ sudo docker network inspect bridge
+[
+    {
+        "Name": "bridge",
+        "Id": "b2b1a2cba717161d984383fd68218cf70bbbd17d328496885f7c921333228b0f",
+        "Scope": "local",
+        "Driver": "bridge",
+        "IPAM": {
+            "Driver": "default",
+            "Config": [
+                {
+                    "Subnet": "172.17.42.1/16",
+                    "Gateway": "172.17.42.1"
+                }
+            ]
+        },
+        "Containers": {
+            "bda12f8922785d1f160be70736f26c1e331ab8aaf8ed8d56728508f2e2fd4727": {
+                "Name": "container2",
+                "EndpointID": "0aebb8fcd2b282abe1365979536f21ee4ceaf3ed56177c628eae9f706e00e019",
+                "MacAddress": "02:42:ac:11:00:02",
+                "IPv4Address": "172.17.0.2/16",
+                "IPv6Address": ""
+            },
+            "f2870c98fd504370fb86e59f32cd0753b1ac9b69b7d80566ffc7192a82b3ed27": {
+                "Name": "container1",
+                "EndpointID": "a00676d9c91a96bbe5bcfb34f705387a33d7cc365bac1a29e4e9728df92d10ad",
+                "MacAddress": "02:42:ac:11:00:01",
+                "IPv4Address": "172.17.0.1/16",
+                "IPv6Address": ""
+            }
+        },
+        "Options": {
+            "com.docker.network.bridge.default\_bridge": "true",
+            "com.docker.network.bridge.enable\_icc": "true",
+            "com.docker.network.bridge.enable\_ip\_masquerade": "true",
+            "com.docker.network.bridge.host\_binding\_ipv4": "0.0.0.0",
+            "com.docker.network.bridge.name": "docker0",
+            "com.docker.network.driver.mtu": "1500"
+        }
+    }
+]
+
+.fi
+.RE
+
+.PP
+Returns the information about the user\-defined network:
+
+.PP
+.RS
+
+.nf
+$ docker network create simple\-network
+69568e6336d8c96bbf57869030919f7c69524f71183b44d80948bd3927c87f6a
+$ docker network inspect simple\-network
+[
+    {
+        "Name": "simple\-network",
+        "Id": "69568e6336d8c96bbf57869030919f7c69524f71183b44d80948bd3927c87f6a",
+        "Scope": "local",
+        "Driver": "bridge",
+        "IPAM": {
+            "Driver": "default",
+            "Config": [
+                {
+                    "Subnet": "172.22.0.0/16",
+                    "Gateway": "172.22.0.1/16"
+                }
+            ]
+        },
+        "Containers": {},
+        "Options": {}
+    }
+]
+
+.fi
+.RE
+
+
+.SH OPTIONS
+.PP
+\fB\-f\fP, \fB\-\-format\fP=""
+  Format the output using the given go template.
+
+.PP
+\fB\-\-help\fP
+  Print usage statement
+
+
+.SH HISTORY
+.PP
+OCT 2015, created by Mary Anthony 
+\[la][email protected]\[ra]