Browse code

update network ls docs to add SCOPE

Signed-off-by: erxian <evelynhsu21@gmail.com>

erxian authored on 2016/11/10 13:08:15
Showing 1 changed files
... ...
@@ -35,24 +35,24 @@ Lists all the networks the Engine `daemon` knows about. This includes the
35 35
 networks that span across multiple hosts in a cluster, for example:
36 36
 
37 37
 ```bash
38
-    $ sudo docker network ls
39
-    NETWORK ID          NAME                DRIVER
40
-    7fca4eb8c647        bridge              bridge
41
-    9f904ee27bf5        none                null
42
-    cf03ee007fb4        host                host
43
-    78b03ee04fc4        multi-host          overlay
38
+$ sudo docker network ls
39
+NETWORK ID          NAME                DRIVER          SCOPE
40
+7fca4eb8c647        bridge              bridge          local
41
+9f904ee27bf5        none                null            local
42
+cf03ee007fb4        host                host            local
43
+78b03ee04fc4        multi-host          overlay         local
44 44
 ```
45 45
 
46 46
 Use the `--no-trunc` option to display the full network id:
47 47
 
48 48
 ```bash
49
-docker network ls --no-trunc
50
-NETWORK ID                                                         NAME                DRIVER
51
-18a2866682b85619a026c81b98a5e375bd33e1b0936a26cc497c283d27bae9b3   none                null
52
-c288470c46f6c8949c5f7e5099b5b7947b07eabe8d9a27d79a9cbf111adcbf47   host                host
53
-7b369448dccbf865d397c8d2be0cda7cf7edc6b0945f77d2529912ae917a0185   bridge              bridge
54
-95e74588f40db048e86320c6526440c504650a1ff3e9f7d60a497c4d2163e5bd   foo                 bridge
55
-63d1ff1f77b07ca51070a8c227e962238358bd310bde1529cf62e6c307ade161   dev                 bridge
49
+$ docker network ls --no-trunc
50
+NETWORK ID                                                         NAME                DRIVER           SCOPE
51
+18a2866682b85619a026c81b98a5e375bd33e1b0936a26cc497c283d27bae9b3   none                null             local
52
+c288470c46f6c8949c5f7e5099b5b7947b07eabe8d9a27d79a9cbf111adcbf47   host                host             local
53
+7b369448dccbf865d397c8d2be0cda7cf7edc6b0945f77d2529912ae917a0185   bridge              bridge           local
54
+95e74588f40db048e86320c6526440c504650a1ff3e9f7d60a497c4d2163e5bd   foo                 bridge           local
55
+63d1ff1f77b07ca51070a8c227e962238358bd310bde1529cf62e6c307ade161   dev                 bridge           local
56 56
 ```
57 57
 
58 58
 ## Filtering
... ...
@@ -78,9 +78,9 @@ The following example matches networks with the `bridge` driver:
78 78
 
79 79
 ```bash
80 80
 $ docker network ls --filter driver=bridge
81
-NETWORK ID          NAME                DRIVER
82
-db9db329f835        test1               bridge
83
-f6e212da9dfd        test2               bridge
81
+NETWORK ID          NAME                DRIVER            SCOPE
82
+db9db329f835        test1               bridge            local
83
+f6e212da9dfd        test2               bridge            local
84 84
 ```
85 85
 
86 86
 #### ID
... ...
@@ -92,20 +92,20 @@ The following filter matches all networks with an ID containing the
92 92
 
93 93
 ```bash
94 94
 $ docker network ls --filter id=63d1ff1f77b07ca51070a8c227e962238358bd310bde1529cf62e6c307ade161
95
-NETWORK ID          NAME                DRIVER
96
-63d1ff1f77b0        dev                 bridge
95
+NETWORK ID          NAME                DRIVER           SCOPE
96
+63d1ff1f77b0        dev                 bridge           local
97 97
 ```
98 98
 
99 99
 You can also filter for a substring in an ID as this shows:
100 100
 
101 101
 ```bash
102 102
 $ docker network ls --filter id=95e74588f40d
103
-NETWORK ID          NAME                DRIVER
104
-95e74588f40d        foo                 bridge
103
+NETWORK ID          NAME                DRIVER          SCOPE
104
+95e74588f40d        foo                 bridge          local
105 105
 
106 106
 $ docker network ls --filter id=95e
107
-NETWORK ID          NAME                DRIVER
108
-95e74588f40d        foo                 bridge
107
+NETWORK ID          NAME                DRIVER          SCOPE
108
+95e74588f40d        foo                 bridge          local
109 109
 ```
110 110
 
111 111
 #### Label
... ...
@@ -117,17 +117,17 @@ The following filter matches networks with the `usage` label regardless of its v
117 117
 
118 118
 ```bash
119 119
 $ docker network ls -f "label=usage"
120
-NETWORK ID          NAME                DRIVER
121
-db9db329f835        test1               bridge
122
-f6e212da9dfd        test2               bridge
120
+NETWORK ID          NAME                DRIVER         SCOPE
121
+db9db329f835        test1               bridge         local
122
+f6e212da9dfd        test2               bridge         local
123 123
 ```
124 124
 
125 125
 The following filter matches networks with the `usage` label with the `prod` value.
126 126
 
127 127
 ```bash
128 128
 $ docker network ls -f "label=usage=prod"
129
-NETWORK ID          NAME                DRIVER
130
-f6e212da9dfd        test2               bridge
129
+NETWORK ID          NAME                DRIVER        SCOPE
130
+f6e212da9dfd        test2               bridge        local
131 131
 ```
132 132
 
133 133
 #### Name
... ...
@@ -138,17 +138,17 @@ The following filter matches all networks with a name containing the `foobar` st
138 138
 
139 139
 ```bash
140 140
 $ docker network ls --filter name=foobar
141
-NETWORK ID          NAME                DRIVER
142
-06e7eef0a170        foobar              bridge
141
+NETWORK ID          NAME                DRIVER       SCOPE
142
+06e7eef0a170        foobar              bridge       local
143 143
 ```
144 144
 
145 145
 You can also filter for a substring in a name as this shows:
146 146
 
147 147
 ```bash
148 148
 $ docker network ls --filter name=foo
149
-NETWORK ID          NAME                DRIVER
150
-95e74588f40d        foo                 bridge
151
-06e7eef0a170        foobar              bridge
149
+NETWORK ID          NAME                DRIVER       SCOPE
150
+95e74588f40d        foo                 bridge       local
151
+06e7eef0a170        foobar              bridge       local
152 152
 ```
153 153
 
154 154
 #### Type
... ...
@@ -160,9 +160,9 @@ The following filter matches all user defined networks:
160 160
 
161 161
 ```bash
162 162
 $ docker network ls --filter type=custom
163
-NETWORK ID          NAME                DRIVER
164
-95e74588f40d        foo                 bridge
165
-63d1ff1f77b0        dev                 bridge
163
+NETWORK ID          NAME                DRIVER       SCOPE
164
+95e74588f40d        foo                 bridge       local  
165
+63d1ff1f77b0        dev                 bridge       local
166 166
 ```
167 167
 
168 168
 By having this flag it allows for batch cleanup. For example, use this filter