1. docker
  2. Commit 689bcd1dc3afdcae5bd45e32541b464fcf3ecbd0
Browse code

Clean up build warnings. Remove redundant files.

Andy Rothfusz authored on 2013/10/18 09:57:01
Showing 38 changed files
docs/sources/api/index.rst
History View file @ 689bcd1
... ... 
@@ -14,5 +14,5 @@ Your programs and scripts can access Docker's functionality via these interfaces
14 14 
   registry_api
15 15 
   index_api
16 16 
   docker_remote_api
17 
-
17 
+  remote_api_client_libraries
18 18
docs/sources/commandline/cli.rst
History View file @ 689bcd1
... ... 
@@ -4,11 +4,8 @@
4 4
5 5 
 .. _cli:
6 6
7 
-Overview
8 
-======================
9 
-
10 
-Docker Usage
11 
-~~~~~~~~~~~~~~~~~~
7 
+Command Line Help
8 
+-----------------
12 9
13 10 
 To list available commands, either run ``docker`` with no parameters or execute
14 11 
 ``docker help``::
... ... 
@@ -21,71 +18,666 @@ To list available commands, either run ``docker`` with no parameters or execute
21 21
22 22 
     ...
23 23
24 
+.. _cli_attach:
25 
+
26 
+``attach``
27 
+----------
28 
+
29 
+::
30 
+
31 
+    Usage: docker attach CONTAINER
32 
+
33 
+    Attach to a running container.
34 
+
35 
+You can detach from the container again (and leave it running) with
36 
+``CTRL-c`` (for a quiet exit) or ``CTRL-\`` to get a stacktrace of
37 
+the Docker client when it quits.
38 
+
39 
+To stop a container, use ``docker stop``
40 
+
41 
+To kill the container, use ``docker kill``
42 
+
43 
+.. _cli_attach_examples:
44 
+
45 
+Examples:
46 
+~~~~~~~~~
47 
+
48 
+.. code-block:: bash
49 
+
50 
+     $ ID=$(sudo docker run -d ubuntu /usr/bin/top -b)
51 
+     $ sudo docker attach $ID
52 
+     top - 02:05:52 up  3:05,  0 users,  load average: 0.01, 0.02, 0.05
53 
+     Tasks:   1 total,   1 running,   0 sleeping,   0 stopped,   0 zombie
54 
+     Cpu(s):  0.1%us,  0.2%sy,  0.0%ni, 99.7%id,  0.0%wa,  0.0%hi,  0.0%si,  0.0%st
55 
+     Mem:    373572k total,   355560k used,    18012k free,    27872k buffers
56 
+     Swap:   786428k total,        0k used,   786428k free,   221740k cached
57 
+
58 
+     PID USER      PR  NI  VIRT  RES  SHR S %CPU %MEM    TIME+  COMMAND
59 
+      1 root      20   0 17200 1116  912 R    0  0.3   0:00.03 top
60 
+
61 
+      top - 02:05:55 up  3:05,  0 users,  load average: 0.01, 0.02, 0.05
62 
+      Tasks:   1 total,   1 running,   0 sleeping,   0 stopped,   0 zombie
63 
+      Cpu(s):  0.0%us,  0.2%sy,  0.0%ni, 99.8%id,  0.0%wa,  0.0%hi,  0.0%si,  0.0%st
64 
+      Mem:    373572k total,   355244k used,    18328k free,    27872k buffers
65 
+      Swap:   786428k total,        0k used,   786428k free,   221776k cached
66 
+
67 
+        PID USER      PR  NI  VIRT  RES  SHR S %CPU %MEM    TIME+  COMMAND
68 
+	    1 root      20   0 17208 1144  932 R    0  0.3   0:00.03 top
69 
+
70 
+
71 
+      top - 02:05:58 up  3:06,  0 users,  load average: 0.01, 0.02, 0.05
72 
+      Tasks:   1 total,   1 running,   0 sleeping,   0 stopped,   0 zombie
73 
+      Cpu(s):  0.2%us,  0.3%sy,  0.0%ni, 99.5%id,  0.0%wa,  0.0%hi,  0.0%si,  0.0%st
74 
+      Mem:    373572k total,   355780k used,    17792k free,    27880k buffers
75 
+      Swap:   786428k total,        0k used,   786428k free,   221776k cached
76 
+
77 
+      PID USER      PR  NI  VIRT  RES  SHR S %CPU %MEM    TIME+  COMMAND
78 
+           1 root      20   0 17208 1144  932 R    0  0.3   0:00.03 top
79 
+     ^C$
80 
+     $ sudo docker stop $ID
81 
+
82 
+.. _cli_build:
83 
+
84 
+``build``
85 
+---------
86 
+
87 
+::
88 
+
89 
+    Usage: docker build [OPTIONS] PATH | URL | -
90 
+    Build a new container image from the source code at PATH
91 
+      -t="": Repository name (and optionally a tag) to be applied to the resulting image in case of success.
92 
+      -q=false: Suppress verbose build output.
93 
+      -no-cache: Do not use the cache when building the image.
94 
+      -rm: Remove intermediate containers after a successful build
95 
+    When a single Dockerfile is given as URL, then no context is set. When a git repository is set as URL, the repository is used as context
96 
+
97 
+.. _cli_build_examples:
98 
+
99 
+Examples
100 
+~~~~~~~~
101 
+
102 
+.. code-block:: bash
103 
+
104 
+    sudo docker build .
105 
+
106 
+This will read the ``Dockerfile`` from the current directory. It will
107 
+also send any other files and directories found in the current
108 
+directory to the ``docker`` daemon.
109 
+
110 
+The contents of this directory would be used by ``ADD`` commands found
111 
+within the ``Dockerfile``.  This will send a lot of data to the
112 
+``docker`` daemon if the current directory contains a lot of data.  If
113 
+the absolute path is provided instead of ``.`` then only the files and
114 
+directories required by the ADD commands from the ``Dockerfile`` will be
115 
+added to the context and transferred to the ``docker`` daemon.
116 
+
117 
+.. code-block:: bash
118 
+
119 
+   sudo docker build -t vieux/apache:2.0 .
120 
+
121 
+This will build like the previous example, but it will then tag the
122 
+resulting image. The repository name will be ``vieux/apache`` and the
123 
+tag will be ``2.0``
124 
+
125 
+
126 
+.. code-block:: bash
127 
+
128 
+    sudo docker build - < Dockerfile
129 
+
130 
+This will read a ``Dockerfile`` from *stdin* without context. Due to
131 
+the lack of a context, no contents of any local directory will be sent
132 
+to the ``docker`` daemon.  ``ADD`` doesn't work when running in this
133 
+mode because the absence of the context provides no source files to
134 
+copy to the container.
135 
+
136 
+
137 
+.. code-block:: bash
138 
+
139 
+    sudo docker build github.com/creack/docker-firefox
140 
+
141 
+This will clone the Github repository and use it as context. The
142 
+``Dockerfile`` at the root of the repository is used as
143 
+``Dockerfile``.  Note that you can specify an arbitrary git repository
144 
+by using the ``git://`` schema.
145 
+
146 
+
147 
+.. _cli_commit:
148 
+
149 
+``commit``
150 
+----------
151 
+
152 
+::
153 
+
154 
+    Usage: docker commit [OPTIONS] CONTAINER [REPOSITORY [TAG]]
155 
+
156 
+    Create a new image from a container's changes
157 
+
158 
+      -m="": Commit message
159 
+      -author="": Author (eg. "John Hannibal Smith <hannibal@a-team.com>"
160 
+      -run="": Configuration to be applied when the image is launched with `docker run`.
161 
+               (ex: '{"Cmd": ["cat", "/world"], "PortSpecs": ["22"]}')
162 
+
163 
+Full -run example (multiline is ok within a single quote ``'``)
164 
+
165 
+::
166 
+
167 
+  $ sudo docker commit -run='
168 
+  {
169 
+      "Entrypoint" : null,
170 
+      "Privileged" : false,
171 
+      "User" : "",
172 
+      "VolumesFrom" : "",
173 
+      "Cmd" : ["cat", "-e", "/etc/resolv.conf"],
174 
+      "Dns" : ["8.8.8.8", "8.8.4.4"],
175 
+      "MemorySwap" : 0,
176 
+      "AttachStdin" : false,
177 
+      "AttachStderr" : false,
178 
+      "CpuShares" : 0,
179 
+      "OpenStdin" : false,
180 
+      "Volumes" : null,
181 
+      "Hostname" : "122612f45831",
182 
+      "PortSpecs" : ["22", "80", "443"],
183 
+      "Image" : "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc",
184 
+      "Tty" : false,
185 
+      "Env" : [
186 
+         "HOME=/",
187 
+         "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
188 
+      ],
189 
+      "StdinOnce" : false,
190 
+      "Domainname" : "",
191 
+      "WorkingDir" : "/",
192 
+      "NetworkDisabled" : false,
193 
+      "Memory" : 0,
194 
+      "AttachStdout" : false
195 
+  }' $CONTAINER_ID
196 
+
197 
+.. _cli_cp:
198 
+
199 
+``cp``
200 
+------
201 
+
202 
+::
203 
+
204 
+    Usage: docker cp CONTAINER:RESOURCE HOSTPATH
205 
+
206 
+    Copy files/folders from the containers filesystem to the host
207 
+    path.  Paths are relative to the root of the filesystem.
208 
+
209 
+.. _cli_diff:
210 
+
211 
+``diff``
212 
+--------
213 
+
214 
+::
215 
+
216 
+    Usage: docker diff CONTAINER [OPTIONS]
217 
+
218 
+    Inspect changes on a container's filesystem
219 
+
220 
+.. _cli_events:
221 
+
222 
+``events``
223 
+----------
224 
+
225 
+::
226 
+
227 
+    Usage: docker events
228 
+
229 
+    Get real time events from the server
230 
+
231 
+.. _cli_events_example:
232 
+
233 
+Examples
234 
+~~~~~~~~
235 
+
236 
+You'll need two shells for this example.
237 
+
238 
+Shell 1: Listening for events
239 
+.............................
240 
+
241 
+.. code-block:: bash
242 
+
243 
+    $ sudo docker events
244 
+
245 
+Shell 2: Start and Stop a Container
246 
+...................................
247 
+
248 
+.. code-block:: bash
249 
+
250 
+    $ sudo docker start 4386fb97867d
251 
+    $ sudo docker stop 4386fb97867d
252 
+
253 
+Shell 1: (Again .. now showing events)
254 
+......................................
255 
+
256 
+.. code-block:: bash
257 
+
258 
+    [2013-09-03 15:49:26 +0200 CEST] 4386fb97867d: (from 12de384bfb10) start
259 
+    [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die
260 
+    [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop
261 
+
262 
+
263 
+.. _cli_export:
264 
+
265 
+``export``
266 
+----------
267 
+
268 
+::
269 
+
270 
+    Usage: docker export CONTAINER
271 
+
272 
+    Export the contents of a filesystem as a tar archive
273 
+
274 
+.. _cli_history:
275 
+
276 
+``history``
277 
+-----------
278 
+
279 
+::
280 
+
281 
+    Usage: docker history [OPTIONS] IMAGE
282 
+
283 
+    Show the history of an image
284 
+
285 
+.. _cli_images:
286 
+
287 
+``images``
288 
+----------
289 
+
290 
+::
291 
+
292 
+    Usage: docker images [OPTIONS] [NAME]
293 
+
294 
+    List images
295 
+
296 
+      -a=false: show all images
297 
+      -q=false: only show numeric IDs
298 
+      -viz=false: output in graphviz format
299 
+
300 
+Displaying images visually
301 
+~~~~~~~~~~~~~~~~~~~~~~~~~~
302 
+
303 
+::
304 
+
305 
+    sudo docker images -viz | dot -Tpng -o docker.png
306 
+
307 
+.. image:: docker_images.gif
308 
+   :alt: Example inheritance graph of Docker images.
309 
+
310 
+.. _cli_import:
311 
+
312 
+``import``
313 
+----------
314 
+
315 
+::
316 
+
317 
+    Usage: docker import URL|- [REPOSITORY [TAG]]
318 
+
319 
+    Create a new filesystem image from the contents of a tarball
320 
+
321 
+At this time, the URL must start with ``http`` and point to a single
322 
+file archive (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) containing a
323 
+root filesystem. If you would like to import from a local directory or
324 
+archive, you can use the ``-`` parameter to take the data from
325 
+standard in.
326 
+
327 
+Examples
328 
+~~~~~~~~
329 
+
330 
+Import from a remote location
331 
+.............................
332 
+
333 
+``$ sudo docker import http://example.com/exampleimage.tgz exampleimagerepo``
334 
+
335 
+Import from a local file
336 
+........................
337 
+
338 
+Import to docker via pipe and standard in
339 
+
340 
+``$ cat exampleimage.tgz | sudo docker import - exampleimagelocal``
341 
+
342 
+Import from a local directory
343 
+.............................
344 
+
345 
+``$ sudo tar -c . | docker import - exampleimagedir``
346 
+
347 
+Note the ``sudo`` in this example -- you must preserve the ownership
348 
+of the files (especially root ownership) during the archiving with
349 
+tar. If you are not root (or sudo) when you tar, then the ownerships
350 
+might not get preserved.
351 
+
352 
+.. _cli_info:
353 
+
354 
+``info``
355 
+--------
356 
+
357 
+::
358 
+
359 
+    Usage: docker info
360 
+
361 
+    Display system-wide information.
362 
+
363 
+.. _cli_insert:
364 
+
365 
+``insert``
366 
+----------
367 
+
368 
+::
369 
+
370 
+    Usage: docker insert IMAGE URL PATH
371 
+
372 
+    Insert a file from URL in the IMAGE at PATH
373 
+
374 
+Examples
375 
+~~~~~~~~
376 
+
377 
+Insert file from github
378 
+.......................
379 
+
380 
+.. code-block:: bash
381 
+
382 
+    $ sudo docker insert 8283e18b24bc https://raw.github.com/metalivedev/django/master/postinstall /tmp/postinstall.sh
383 
+
384 
+.. _cli_inspect:
385 
+
386 
+``inspect``
387 
+-----------
388 
+
389 
+::
390 
+
391 
+    Usage: docker inspect [OPTIONS] CONTAINER
392 
+
393 
+    Return low-level information on a container
394 
+
395 
+.. _cli_kill:
396 
+
397 
+``kill``
398 
+--------
399 
+
400 
+::
401 
+
402 
+    Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...]
403 
+
404 
+    Kill a running container
405 
+
406 
+.. _cli_login:
407 
+
408 
+``login``
409 
+---------
410 
+
411 
+::
412 
+
413 
+    Usage: docker login [OPTIONS] [SERVER]
414 
+
415 
+    Register or Login to the docker registry server
416 
+
417 
+    -e="": email
418 
+    -p="": password
419 
+    -u="": username
420 
+
421 
+    If you want to login to a private registry you can
422 
+    specify this by adding the server name.
423 
+
424 
+    example:
425 
+    docker login localhost:8080
426 
+
427 
+
428 
+.. _cli_logs:
429 
+
430 
+``logs``
431 
+--------
432 
+
433 
+
434 
+::
435 
+
436 
+    Usage: docker logs [OPTIONS] CONTAINER
437 
+
438 
+    Fetch the logs of a container
439 
+
440 
+
441 
+.. _cli_port:
442 
+
443 
+``port``
444 
+--------
445 
+
446 
+::
447 
+
448 
+    Usage: docker port [OPTIONS] CONTAINER PRIVATE_PORT
449 
+
450 
+    Lookup the public-facing port which is NAT-ed to PRIVATE_PORT
451 
+
452 
+
453 
+.. _cli_ps:
454 
+
455 
+``ps``
456 
+------
457 
+
458 
+::
459 
+
460 
+    Usage: docker ps [OPTIONS]
461 
+
462 
+    List containers
463 
+
464 
+      -a=false: Show all containers. Only running containers are shown by default.
465 
+      -notrunc=false: Don't truncate output
466 
+      -q=false: Only display numeric IDs
467 
+
468 
+.. _cli_pull:
469 
+
470 
+``pull``
471 
+--------
472 
+
473 
+::
474 
+
475 
+    Usage: docker pull NAME
476 
+
477 
+    Pull an image or a repository from the registry
478 
+
479 
+
480 
+.. _cli_push:
481 
+
482 
+``push``
483 
+--------
484 
+
485 
+::
486 
+
487 
+    Usage: docker push NAME
488 
+
489 
+    Push an image or a repository to the registry
490 
+
491 
+
492 
+.. _cli_restart:
493 
+
494 
+``restart``
495 
+-----------
496 
+
497 
+::
498 
+
499 
+    Usage: docker restart [OPTIONS] NAME
500 
+
501 
+    Restart a running container
502 
+
503 
+.. _cli_rm:
504 
+
505 
+``rm``
506 
+------
507 
+
508 
+::
509 
+
510 
+    Usage: docker rm [OPTIONS] CONTAINER
511 
+
512 
+    Remove one or more containers
513 
+
514 
+.. _cli_rmi:
515 
+
516 
+``rmi``
517 
+-------
518 
+
519 
+::
520 
+
521 
+    Usage: docker rmi IMAGE [IMAGE...]
522 
+
523 
+    Remove one or more images
524 
+
525 
+.. _cli_run:
526 
+
527 
+``run``
528 
+-------
529 
+
530 
+::
531 
+
532 
+    Usage: docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...]
533 
+
534 
+    Run a command in a new container
535 
+
536 
+      -a=map[]: Attach to stdin, stdout or stderr.
537 
+      -c=0: CPU shares (relative weight)
538 
+      -cidfile="": Write the container ID to the file
539 
+      -d=false: Detached mode: Run container in the background, print new container id
540 
+      -e=[]: Set environment variables
541 
+      -h="": Container host name
542 
+      -i=false: Keep stdin open even if not attached
543 
+      -privileged=false: Give extended privileges to this container
544 
+      -m=0: Memory limit (in bytes)
545 
+      -n=true: Enable networking for this container
546 
+      -p=[]: Map a network port to the container
547 
+      -rm=false: Automatically remove the container when it exits (incompatible with -d)
548 
+      -t=false: Allocate a pseudo-tty
549 
+      -u="": Username or UID
550 
+      -dns=[]: Set custom dns servers for the container
551 
+      -v=[]: Create a bind mount with: [host-dir]:[container-dir]:[rw|ro]. If "container-dir" is missing, then docker creates a new volume.
552 
+      -volumes-from="": Mount all volumes from the given container.
553 
+      -entrypoint="": Overwrite the default entrypoint set by the image.
554 
+      -w="": Working directory inside the container
555 
+      -lxc-conf=[]: Add custom lxc options -lxc-conf="lxc.cgroup.cpuset.cpus = 0,1"
556 
+
557 
+Examples
558 
+~~~~~~~~
559 
+
560 
+.. code-block:: bash
561 
+
562 
+    sudo docker run -cidfile /tmp/docker_test.cid ubuntu echo "test"
563 
+
564 
+This will create a container and print "test" to the console. The
565 
+``cidfile`` flag makes docker attempt to create a new file and write the
566 
+container ID to it. If the file exists already, docker will return an
567 
+error. Docker will close this file when docker run exits.
568 
+
569 
+.. code-block:: bash
570 
+
571 
+   docker run mount -t tmpfs none /var/spool/squid
572 
+
573 
+This will *not* work, because by default, most potentially dangerous
574 
+kernel capabilities are dropped; including ``cap_sys_admin`` (which is
575 
+required to mount filesystems). However, the ``-privileged`` flag will
576 
+allow it to run:
577 
+
578 
+.. code-block:: bash
579 
+
580 
+   docker run -privileged mount -t tmpfs none /var/spool/squid
581 
+
582 
+The ``-privileged`` flag gives *all* capabilities to the container,
583 
+and it also lifts all the limitations enforced by the ``device``
584 
+cgroup controller. In other words, the container can then do almost
585 
+everything that the host can do. This flag exists to allow special
586 
+use-cases, like running Docker within Docker.
587 
+
588 
+.. code-block:: bash
589 
+
590 
+   docker  run -w /path/to/dir/ -i -t  ubuntu pwd
591 
+
592 
+The ``-w`` lets the command being executed inside directory given,
593 
+here /path/to/dir/. If the path does not exists it is created inside the
594 
+container.
595 
+
596 
+.. code-block:: bash
597 
+
598 
+   docker  run  -v `pwd`:`pwd` -w `pwd` -i -t  ubuntu pwd
599 
+
600 
+The ``-v`` flag mounts the current working directory into the container.
601 
+The ``-w`` lets the command being executed inside the current
602 
+working directory, by changing into the directory to the value
603 
+returned by ``pwd``. So this combination executes the command
604 
+using the container, but inside the current working directory.
605 
+
606 
+.. _cli_search:
607 
+
608 
+``search``
609 
+----------
610 
+
611 
+::
612 
+
613 
+    Usage: docker search TERM
24 614
615 
+    Searches for the TERM parameter on the Docker index and prints out
616 
+    a list of repositories that match.
25 617
26 
-Available Commands
27 
-~~~~~~~~~~~~~~~~~~
618 
+.. _cli_start:
28 619
29 
-.. include:: command/attach.rst
620 
+``start``
621 
+---------
30 622
31 
-.. include:: command/build.rst
623 
+::
32 624
33 
-.. include:: command/commit.rst
625 
+    Usage: docker start [OPTIONS] NAME
34 626
35 
-.. include:: command/cp.rst
627 
+    Start a stopped container
36 628
37 
-.. include:: command/diff.rst
629 
+.. _cli_stop:
38 630
39 
-.. include:: command/events.rst
631 
+``stop``
632 
+--------
40 633
41 
-.. include:: command/export.rst
634 
+::
42 635
43 
-.. include:: command/history.rst
636 
+    Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...]
44 637
45 
-.. include:: command/images.rst
638 
+    Stop a running container
46 639
47 
-.. include:: command/import.rst
640 
+      -t=10: Number of seconds to wait for the container to stop before killing it.
48 641
49 
-.. include:: command/info.rst
642 
+.. _cli_tag:
50 643
51 
-.. include:: command/insert.rst
644 
+``tag``
645 
+-------
52 646
53 
-.. include:: command/inspect.rst
647 
+::
54 648
55 
-.. include:: command/kill.rst
649 
+    Usage: docker tag [OPTIONS] IMAGE REPOSITORY [TAG]
56 650
57 
-.. include:: command/login.rst
651 
+    Tag an image into a repository
58 652
59 
-.. include:: command/logs.rst
653 
+      -f=false: Force
60 654
61 
-.. include:: command/port.rst
655 
+.. _cli_top:
62 656
63 
-.. include:: command/ps.rst
657 
+``top``
658 
+-------
64 659
65 
-.. include:: command/pull.rst
660 
+::
66 661
67 
-.. include:: command/push.rst
662 
+    Usage: docker top CONTAINER
68 663
69 
-.. include:: command/restart.rst
664 
+    Lookup the running processes of a container
70 665
71 
-.. include:: command/rm.rst
666 
+.. _cli_version:
72 667
73 
-.. include:: command/rmi.rst
668 
+``version``
669 
+-----------
74 670
75 
-.. include:: command/run.rst
671 
+Show the version of the docker client, daemon, and latest released version.
76 672
77 
-.. include:: command/search.rst
78 673
79 
-.. include:: command/start.rst
674 
+.. _cli_wait:
80 675
81 
-.. include:: command/stop.rst
676 
+``wait``
677 
+--------
82 678
83 
-.. include:: command/tag.rst
679 
+::
84 680
85 
-.. include:: command/top.rst
681 
+    Usage: docker wait [OPTIONS] NAME
86 682
87 
-.. include:: command/version.rst
683 
+    Block until a container stops, then print its exit code.
88 684
89 
-.. include:: command/wait.rst
90 685
91 686
docs/sources/commandline/command/attach.rst
History View file @ 689bcd1
92 687 
deleted file mode 100644
... ... 
@@ -1,59 +0,0 @@
1 
-:title: Attach Command
2 
-:description: Attach to a running container
3 
-:keywords: attach, container, docker, documentation
4 
-
5 
-===========================================
6 
-``attach`` -- Attach to a running container
7 
-===========================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker attach CONTAINER
12 
-
13 
-    Attach to a running container.
14 
-
15 
-You can detach from the container again (and leave it running) with
16 
-``CTRL-c`` (for a quiet exit) or ``CTRL-\`` to get a stacktrace of
17 
-the Docker client when it quits.
18 
-
19 
-To stop a container, use ``docker stop``
20 
-
21 
-To kill the container, use ``docker kill``
22 
-
23 
-Examples:
24 
-
25 
-.. code-block:: bash
26 
-
27 
-     $ ID=$(sudo docker run -d ubuntu /usr/bin/top -b)
28 
-     $ sudo docker attach $ID
29 
-     top - 02:05:52 up  3:05,  0 users,  load average: 0.01, 0.02, 0.05
30 
-     Tasks:   1 total,   1 running,   0 sleeping,   0 stopped,   0 zombie
31 
-     Cpu(s):  0.1%us,  0.2%sy,  0.0%ni, 99.7%id,  0.0%wa,  0.0%hi,  0.0%si,  0.0%st
32 
-     Mem:    373572k total,   355560k used,    18012k free,    27872k buffers
33 
-     Swap:   786428k total,        0k used,   786428k free,   221740k cached
34 
-
35 
-     PID USER      PR  NI  VIRT  RES  SHR S %CPU %MEM    TIME+  COMMAND
36 
-      1 root      20   0 17200 1116  912 R    0  0.3   0:00.03 top
37 
-
38 
-      top - 02:05:55 up  3:05,  0 users,  load average: 0.01, 0.02, 0.05
39 
-      Tasks:   1 total,   1 running,   0 sleeping,   0 stopped,   0 zombie
40 
-      Cpu(s):  0.0%us,  0.2%sy,  0.0%ni, 99.8%id,  0.0%wa,  0.0%hi,  0.0%si,  0.0%st
41 
-      Mem:    373572k total,   355244k used,    18328k free,    27872k buffers
42 
-      Swap:   786428k total,        0k used,   786428k free,   221776k cached
43 
-
44 
-        PID USER      PR  NI  VIRT  RES  SHR S %CPU %MEM    TIME+  COMMAND
45 
-	    1 root      20   0 17208 1144  932 R    0  0.3   0:00.03 top
46 
-
47 
-
48 
-      top - 02:05:58 up  3:06,  0 users,  load average: 0.01, 0.02, 0.05
49 
-      Tasks:   1 total,   1 running,   0 sleeping,   0 stopped,   0 zombie
50 
-      Cpu(s):  0.2%us,  0.3%sy,  0.0%ni, 99.5%id,  0.0%wa,  0.0%hi,  0.0%si,  0.0%st
51 
-      Mem:    373572k total,   355780k used,    17792k free,    27880k buffers
52 
-      Swap:   786428k total,        0k used,   786428k free,   221776k cached
53 
-
54 
-      PID USER      PR  NI  VIRT  RES  SHR S %CPU %MEM    TIME+  COMMAND
55 
-           1 root      20   0 17208 1144  932 R    0  0.3   0:00.03 top
56 
-     ^C$
57 
-     $ sudo docker stop $ID
58 
-
docs/sources/commandline/command/build.rst
History View file @ 689bcd1
59 1 
deleted file mode 100644
... ... 
@@ -1,65 +0,0 @@
1 
-:title: Build Command
2 
-:description: Build a new image from the Dockerfile passed via stdin
3 
-:keywords: build, docker, container, documentation
4 
-
5 
-================================================
6 
-``build`` -- Build a container from a Dockerfile
7 
-================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker build [OPTIONS] PATH | URL | -
12 
-    Build a new container image from the source code at PATH
13 
-      -t="": Repository name (and optionally a tag) to be applied to the resulting image in case of success.
14 
-      -q=false: Suppress verbose build output.
15 
-      -no-cache: Do not use the cache when building the image.
16 
-      -rm: Remove intermediate containers after a successful build
17 
-    When a single Dockerfile is given as URL, then no context is set. When a git repository is set as URL, the repository is used as context
18 
-
19 
-
20 
-Examples
21 
-
22 
-.. code-block:: bash
23 
-
24 
-    sudo docker build .
25 
-
26 
-This will read the ``Dockerfile`` from the current directory. It will
27 
-also send any other files and directories found in the current
28 
-directory to the ``docker`` daemon.
29 
-
30 
-The contents of this directory would be used by ``ADD`` commands found
31 
-within the ``Dockerfile``.  This will send a lot of data to the
32 
-``docker`` daemon if the current directory contains a lot of data.  If
33 
-the absolute path is provided instead of ``.`` then only the files and
34 
-directories required by the ADD commands from the ``Dockerfile`` will be
35 
-added to the context and transferred to the ``docker`` daemon.
36 
-
37 
-.. code-block:: bash
38 
-
39 
-   sudo docker build -t vieux/apache:2.0 .
40 
-
41 
-This will build like the previous example, but it will then tag the
42 
-resulting image. The repository name will be ``vieux/apache`` and the
43 
-tag will be ``2.0``
44 
-
45 
-
46 
-.. code-block:: bash
47 
-
48 
-    sudo docker build - < Dockerfile
49 
-
50 
-This will read a ``Dockerfile`` from *stdin* without context. Due to
51 
-the lack of a context, no contents of any local directory will be sent
52 
-to the ``docker`` daemon.  ``ADD`` doesn't work when running in this
53 
-mode because the absence of the context provides no source files to
54 
-copy to the container.
55 
-
56 
-
57 
-.. code-block:: bash
58 
-
59 
-    sudo docker build github.com/creack/docker-firefox
60 
-
61 
-This will clone the Github repository and use it as context. The
62 
-``Dockerfile`` at the root of the repository is used as
63 
-``Dockerfile``.  Note that you can specify an arbitrary git repository
64 
-by using the ``git://`` schema.
docs/sources/commandline/command/commit.rst
History View file @ 689bcd1
65 1 
deleted file mode 100644
... ... 
@@ -1,52 +0,0 @@
1 
-:title: Commit Command
2 
-:description: Create a new image from a container's changes
3 
-:keywords: commit, docker, container, documentation
4 
-
5 
-===========================================================
6 
-``commit`` -- Create a new image from a container's changes
7 
-===========================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker commit [OPTIONS] CONTAINER [REPOSITORY [TAG]]
12 
-
13 
-    Create a new image from a container's changes
14 
-
15 
-      -m="": Commit message
16 
-      -author="": Author (eg. "John Hannibal Smith <hannibal@a-team.com>"
17 
-      -run="": Configuration to be applied when the image is launched with `docker run`.
18 
-               (ex: '{"Cmd": ["cat", "/world"], "PortSpecs": ["22"]}')
19 
-
20 
-Full -run example (multiline is ok within a single quote ``'``)
21 
-
22 
-::
23 
-
24 
-  $ sudo docker commit -run='
25 
-  {
26 
-      "Entrypoint" : null,
27 
-      "Privileged" : false,
28 
-      "User" : "",
29 
-      "VolumesFrom" : "",
30 
-      "Cmd" : ["cat", "-e", "/etc/resolv.conf"],
31 
-      "Dns" : ["8.8.8.8", "8.8.4.4"],
32 
-      "MemorySwap" : 0,
33 
-      "AttachStdin" : false,
34 
-      "AttachStderr" : false,
35 
-      "CpuShares" : 0,
36 
-      "OpenStdin" : false,
37 
-      "Volumes" : null,
38 
-      "Hostname" : "122612f45831",
39 
-      "PortSpecs" : ["22", "80", "443"],
40 
-      "Image" : "b750fe79269d2ec9a3c593ef05b4332b1d1a02a62b4accb2c21d589ff2f5f2dc",
41 
-      "Tty" : false,
42 
-      "Env" : [
43 
-         "HOME=/",
44 
-         "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
45 
-      ],
46 
-      "StdinOnce" : false,
47 
-      "Domainname" : "",
48 
-      "WorkingDir" : "/",
49 
-      "NetworkDisabled" : false,
50 
-      "Memory" : 0,
51 
-      "AttachStdout" : false
52 
-  }' $CONTAINER_ID
docs/sources/commandline/command/cp.rst
History View file @ 689bcd1
53 1 
deleted file mode 100644
... ... 
@@ -1,14 +0,0 @@
1 
-:title: Cp Command
2 
-:description: Copy files/folders from the containers filesystem to the host path
3 
-:keywords: cp, docker, container, documentation, copy
4 
-
5 
-============================================================================
6 
-``cp`` -- Copy files/folders from the containers filesystem to the host path
7 
-============================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker cp CONTAINER:RESOURCE HOSTPATH
12 
-
13 
-    Copy files/folders from the containers filesystem to the host
14 
-    path.  Paths are relative to the root of the filesystem.
docs/sources/commandline/command/diff.rst
History View file @ 689bcd1
15 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Diff Command
2 
-:description: Inspect changes on a container's filesystem
3 
-:keywords: diff, docker, container, documentation
4 
-
5 
-=======================================================
6 
-``diff`` -- Inspect changes on a container's filesystem
7 
-=======================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker diff CONTAINER [OPTIONS]
12 
-
13 
-    Inspect changes on a container's filesystem
docs/sources/commandline/command/events.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,34 +0,0 @@
1 
-:title: Events Command
2 
-:description: Get real time events from the server
3 
-:keywords: events, docker, documentation
4 
-
5 
-=================================================================
6 
-``events`` -- Get real time events from the server
7 
-=================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker events
12 
-
13 
-    Get real time events from the server
14 
-
15 
-Examples
16 
-
17 
-Starting and stopping a container
18 
-.................................
19 
-
20 
-.. code-block:: bash
21 
-
22 
-    $ sudo docker start 4386fb97867d
23 
-    $ sudo docker stop 4386fb97867d
24 
-
25 
-In another shell
26 
-
27 
-.. code-block:: bash
28 
-
29 
-    $ sudo docker events
30 
-    [2013-09-03 15:49:26 +0200 CEST] 4386fb97867d: (from 12de384bfb10) start
31 
-    [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) die
32 
-    [2013-09-03 15:49:29 +0200 CEST] 4386fb97867d: (from 12de384bfb10) stop
33 
-
docs/sources/commandline/command/export.rst
History View file @ 689bcd1
34 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Export Command
2 
-:description: Export the contents of a filesystem as a tar archive
3 
-:keywords: export, docker, container, documentation
4 
-
5 
-=================================================================
6 
-``export`` -- Stream the contents of a container as a tar archive
7 
-=================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker export CONTAINER
12 
-
13 
-    Export the contents of a filesystem as a tar archive
docs/sources/commandline/command/history.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: History Command
2 
-:description: Show the history of an image
3 
-:keywords: history, docker, container, documentation
4 
-
5 
-===========================================
6 
-``history`` -- Show the history of an image
7 
-===========================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker history [OPTIONS] IMAGE
12 
-
13 
-    Show the history of an image
docs/sources/commandline/command/images.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,26 +0,0 @@
1 
-:title: Images Command
2 
-:description: List images
3 
-:keywords: images, docker, container, documentation
4 
-
5 
-=========================
6 
-``images`` -- List images
7 
-=========================
8 
-
9 
-::
10 
-
11 
-    Usage: docker images [OPTIONS] [NAME]
12 
-
13 
-    List images
14 
-
15 
-      -a=false: show all images
16 
-      -q=false: only show numeric IDs
17 
-      -viz=false: output in graphviz format
18 
-
19 
-Displaying images visually
20 
-
21 
-::
22 
-
23 
-    sudo docker images -viz | dot -Tpng -o docker.png
24 
-
25 
-.. image:: https://docs.docker.io/en/latest/_static/docker_images.gif
docs/sources/commandline/command/import.rst
History View file @ 689bcd1
26 1 
deleted file mode 100644
... ... 
@@ -1,44 +0,0 @@
1 
-:title: Import Command
2 
-:description: Create a new filesystem image from the contents of a tarball
3 
-:keywords: import, tarball, docker, url, documentation
4 
-
5 
-==========================================================================
6 
-``import`` -- Create a new filesystem image from the contents of a tarball
7 
-==========================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker import URL|- [REPOSITORY [TAG]]
12 
-
13 
-    Create a new filesystem image from the contents of a tarball
14 
-
15 
-At this time, the URL must start with ``http`` and point to a single
16 
-file archive (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) containing a
17 
-root filesystem. If you would like to import from a local directory or
18 
-archive, you can use the ``-`` parameter to take the data from
19 
-standard in.
20 
-
21 
-Examples
22 
-
23 
-Import from a remote location
24 
-.............................
25 
-
26 
-``$ sudo docker import http://example.com/exampleimage.tgz exampleimagerepo``
27 
-
28 
-Import from a local file
29 
-........................
30 
-
31 
-Import to docker via pipe and standard in
32 
-
33 
-``$ cat exampleimage.tgz | sudo docker import - exampleimagelocal``
34 
-
35 
-Import from a local directory
36 
-.............................
37 
-
38 
-``$ sudo tar -c . | docker import - exampleimagedir``
39 
-
40 
-Note the ``sudo`` in this example -- you must preserve the ownership
41 
-of the files (especially root ownership) during the archiving with
42 
-tar. If you are not root (or sudo) when you tar, then the ownerships
43 
-might not get preserved.
docs/sources/commandline/command/info.rst
History View file @ 689bcd1
44 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Info Command
2 
-:description: Display system-wide information.
3 
-:keywords: info, docker, information, documentation
4 
-
5 
-===========================================
6 
-``info`` -- Display system-wide information
7 
-===========================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker info
12 
-
13 
-    Display system-wide information.
docs/sources/commandline/command/insert.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,23 +0,0 @@
1 
-:title: Insert Command
2 
-:description: Insert a file in an image
3 
-:keywords: insert, image, docker, documentation
4 
-
5 
-==========================================================================
6 
-``insert`` -- Insert a file in an image
7 
-==========================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker insert IMAGE URL PATH
12 
-
13 
-    Insert a file from URL in the IMAGE at PATH
14 
-
15 
-Examples
16 
-
17 
-Insert file from github
18 
-.......................
19 
-
20 
-.. code-block:: bash
21 
-
22 
-    $ sudo docker insert 8283e18b24bc https://raw.github.com/metalivedev/django/master/postinstall /tmp/postinstall.sh
docs/sources/commandline/command/inspect.rst
History View file @ 689bcd1
23 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Inspect Command
2 
-:description: Return low-level information on a container
3 
-:keywords: inspect, container, docker, documentation
4 
-
5 
-==========================================================
6 
-``inspect`` -- Return low-level information on a container
7 
-==========================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker inspect [OPTIONS] CONTAINER
12 
-
13 
-    Return low-level information on a container
docs/sources/commandline/command/kill.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Kill Command
2 
-:description: Kill a running container
3 
-:keywords: kill, container, docker, documentation
4 
-
5 
-====================================
6 
-``kill`` -- Kill a running container
7 
-====================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...]
12 
-
13 
-    Kill a running container
docs/sources/commandline/command/login.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,24 +0,0 @@
1 
-:title: Login Command
2 
-:description: Register or Login to the docker registry server
3 
-:keywords: login, docker, documentation
4 
-
5 
-============================================================
6 
-``login`` -- Register or Login to the docker registry server
7 
-============================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker login [OPTIONS] [SERVER]
12 
-
13 
-    Register or Login to the docker registry server
14 
-
15 
-    -e="": email
16 
-    -p="": password
17 
-    -u="": username
18 
-
19 
-    If you want to login to a private registry you can
20 
-    specify this by adding the server name.
21 
-
22 
-    example:
23 
-    docker login localhost:8080
24 
-
docs/sources/commandline/command/logs.rst
History View file @ 689bcd1
25 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Logs Command
2 
-:description: Fetch the logs of a container
3 
-:keywords: logs, container, docker, documentation
4 
-
5 
-=========================================
6 
-``logs`` -- Fetch the logs of a container
7 
-=========================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker logs [OPTIONS] CONTAINER
12 
-
13 
-    Fetch the logs of a container
docs/sources/commandline/command/port.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Port Command
2 
-:description: Lookup the public-facing port which is NAT-ed to PRIVATE_PORT
3 
-:keywords: port, docker, container, documentation
4 
-
5 
-=========================================================================
6 
-``port`` -- Lookup the public-facing port which is NAT-ed to PRIVATE_PORT
7 
-=========================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker port [OPTIONS] CONTAINER PRIVATE_PORT
12 
-
13 
-    Lookup the public-facing port which is NAT-ed to PRIVATE_PORT
docs/sources/commandline/command/ps.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,17 +0,0 @@
1 
-:title: Ps Command
2 
-:description: List containers
3 
-:keywords: ps, docker, documentation, container
4 
-
5 
-=========================
6 
-``ps`` -- List containers
7 
-=========================
8 
-
9 
-::
10 
-
11 
-    Usage: docker ps [OPTIONS]
12 
-
13 
-    List containers
14 
-
15 
-      -a=false: Show all containers. Only running containers are shown by default.
16 
-      -notrunc=false: Don't truncate output
17 
-      -q=false: Only display numeric IDs
docs/sources/commandline/command/pull.rst
History View file @ 689bcd1
18 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Pull Command
2 
-:description: Pull an image or a repository from the registry
3 
-:keywords: pull, image, repo, repository, documentation, docker
4 
-
5 
-=========================================================================
6 
-``pull`` -- Pull an image or a repository from the docker registry server
7 
-=========================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker pull NAME
12 
-
13 
-    Pull an image or a repository from the registry
docs/sources/commandline/command/push.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Push Command
2 
-:description: Push an image or a repository to the registry
3 
-:keywords: push, docker, image, repository, documentation, repo
4 
-
5 
-=======================================================================
6 
-``push`` -- Push an image or a repository to the docker registry server
7 
-=======================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker push NAME
12 
-
13 
-    Push an image or a repository to the registry
docs/sources/commandline/command/restart.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Restart Command
2 
-:description: Restart a running container
3 
-:keywords: restart, container, docker, documentation
4 
-
5 
-==========================================
6 
-``restart`` -- Restart a running container
7 
-==========================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker restart [OPTIONS] NAME
12 
-
13 
-    Restart a running container
docs/sources/commandline/command/rm.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Rm Command
2 
-:description: Remove a container
3 
-:keywords: remove, container, docker, documentation, rm
4 
-
5 
-============================
6 
-``rm`` -- Remove a container
7 
-============================
8 
-
9 
-::
10 
-
11 
-    Usage: docker rm [OPTIONS] CONTAINER
12 
-
13 
-    Remove one or more containers
docs/sources/commandline/command/rmi.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Rmi Command
2 
-:description: Remove an image
3 
-:keywords: rmi, remove, image, docker, documentation
4 
-
5 
-==========================
6 
-``rmi`` -- Remove an image
7 
-==========================
8 
-
9 
-::
10 
-
11 
-    Usage: docker rmi IMAGE [IMAGE...]
12 
-
13 
-    Remove one or more images
docs/sources/commandline/command/run.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,85 +0,0 @@
1 
-:title: Run Command
2 
-:description: Run a command in a new container
3 
-:keywords: run, container, docker, documentation
4 
-
5 
-===========================================
6 
-``run`` -- Run a command in a new container
7 
-===========================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...]
12 
-
13 
-    Run a command in a new container
14 
-
15 
-      -a=map[]: Attach to stdin, stdout or stderr.
16 
-      -c=0: CPU shares (relative weight)
17 
-      -cidfile="": Write the container ID to the file
18 
-      -d=false: Detached mode: Run container in the background, print new container id
19 
-      -e=[]: Set environment variables
20 
-      -h="": Container host name
21 
-      -i=false: Keep stdin open even if not attached
22 
-      -privileged=false: Give extended privileges to this container
23 
-      -m=0: Memory limit (in bytes)
24 
-      -n=true: Enable networking for this container
25 
-      -p=[]: Map a network port to the container
26 
-      -rm=false: Automatically remove the container when it exits (incompatible with -d)
27 
-      -t=false: Allocate a pseudo-tty
28 
-      -u="": Username or UID
29 
-      -dns=[]: Set custom dns servers for the container
30 
-      -v=[]: Create a bind mount with: [host-dir]:[container-dir]:[rw|ro]. If "container-dir" is missing, then docker creates a new volume.
31 
-      -volumes-from="": Mount all volumes from the given container.
32 
-      -entrypoint="": Overwrite the default entrypoint set by the image.
33 
-      -w="": Working directory inside the container
34 
-      -lxc-conf=[]: Add custom lxc options -lxc-conf="lxc.cgroup.cpuset.cpus = 0,1"
35 
-
36 
-Examples
37 
-
38 
-.. code-block:: bash
39 
-
40 
-    sudo docker run -cidfile /tmp/docker_test.cid ubuntu echo "test"
41 
-
42 
-This will create a container and print "test" to the console. The
43 
-``cidfile`` flag makes docker attempt to create a new file and write the
44 
-container ID to it. If the file exists already, docker will return an
45 
-error. Docker will close this file when docker run exits.
46 
-
47 
-.. code-block:: bash
48 
-
49 
-   docker run mount -t tmpfs none /var/spool/squid
50 
-
51 
-This will *not* work, because by default, most potentially dangerous
52 
-kernel capabilities are dropped; including ``cap_sys_admin`` (which is
53 
-required to mount filesystems). However, the ``-privileged`` flag will
54 
-allow it to run:
55 
-
56 
-.. code-block:: bash
57 
-
58 
-   docker run -privileged mount -t tmpfs none /var/spool/squid
59 
-
60 
-The ``-privileged`` flag gives *all* capabilities to the container,
61 
-and it also lifts all the limitations enforced by the ``device``
62 
-cgroup controller. In other words, the container can then do almost
63 
-everything that the host can do. This flag exists to allow special
64 
-use-cases, like running Docker within Docker.
65 
-
66 
-.. code-block:: bash
67 
-
68 
-   docker  run -w /path/to/dir/ -i -t  ubuntu pwd
69 
-
70 
-The ``-w`` lets the command being executed inside directory given,
71 
-here /path/to/dir/. If the path does not exists it is created inside the
72 
-container.
73 
-
74 
-.. code-block:: bash
75 
-
76 
-   docker  run  -v `pwd`:`pwd` -w `pwd` -i -t  ubuntu pwd
77 
-
78 
-The ``-v`` flag mounts the current working directory into the container.
79 
-The ``-w`` lets the command being executed inside the current
80 
-working directory, by changing into the directory to the value
81 
-returned by ``pwd``. So this combination executes the command
82 
-using the container, but inside the current working directory.
83 
-
84 
-
docs/sources/commandline/command/search.rst
History View file @ 689bcd1
85 1 
deleted file mode 100644
... ... 
@@ -1,14 +0,0 @@
1 
-:title: Search Command
2 
-:description: Searches for the TERM parameter on the Docker index and prints out a list of repositories that match.
3 
-:keywords: search, docker, image, documentation
4 
-
5 
-===================================================================
6 
-``search`` -- Search for an image in the docker index
7 
-===================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker search TERM
12 
-
13 
-    Searches for the TERM parameter on the Docker index and prints out
14 
-    a list of repositories that match.
docs/sources/commandline/command/start.rst
History View file @ 689bcd1
15 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Start Command
2 
-:description: Start a stopped container
3 
-:keywords: start, docker, container, documentation
4 
-
5 
-======================================
6 
-``start`` -- Start a stopped container
7 
-======================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker start [OPTIONS] NAME
12 
-
13 
-    Start a stopped container
docs/sources/commandline/command/stop.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,15 +0,0 @@
1 
-:title: Stop Command
2 
-:description: Stop a running container
3 
-:keywords: stop, container, docker, documentation
4 
-
5 
-====================================
6 
-``stop`` -- Stop a running container
7 
-====================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...]
12 
-
13 
-    Stop a running container
14 
-
15 
-      -t=10: Number of seconds to wait for the container to stop before killing it.
docs/sources/commandline/command/tag.rst
History View file @ 689bcd1
16 1 
deleted file mode 100644
... ... 
@@ -1,15 +0,0 @@
1 
-:title: Tag Command
2 
-:description: Tag an image into a repository
3 
-:keywords: tag, docker, image, repository, documentation, repo
4 
-
5 
-=========================================
6 
-``tag`` -- Tag an image into a repository
7 
-=========================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker tag [OPTIONS] IMAGE REPOSITORY [TAG]
12 
-
13 
-    Tag an image into a repository
14 
-
15 
-      -f=false: Force
docs/sources/commandline/command/top.rst
History View file @ 689bcd1
16 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Top Command
2 
-:description: Lookup the running processes of a container
3 
-:keywords: top, docker, container, documentation
4 
-
5 
-=======================================================
6 
-``top`` -- Lookup the running processes of a container
7 
-=======================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker top CONTAINER
12 
-
13 
-    Lookup the running processes of a container
docs/sources/commandline/command/version.rst
History View file @ 689bcd1
14 1 
deleted file mode 100644
... ... 
@@ -1,7 +0,0 @@
1 
-:title: Version Command
2 
-:description:
3 
-:keywords: version, docker, documentation
4 
-
5 
-==================================================
6 
-``version`` -- Show the docker version information
7 
-==================================================
docs/sources/commandline/command/wait.rst
History View file @ 689bcd1
8 1 
deleted file mode 100644
... ... 
@@ -1,13 +0,0 @@
1 
-:title: Wait Command
2 
-:description: Block until a container stops, then print its exit code.
3 
-:keywords: wait, docker, container, documentation
4 
-
5 
-===================================================================
6 
-``wait`` -- Block until a container stops, then print its exit code
7 
-===================================================================
8 
-
9 
-::
10 
-
11 
-    Usage: docker wait [OPTIONS] NAME
12 
-
13 
-    Block until a container stops, then print its exit code.
docs/sources/commandline/docker_images.gif
History View file @ 689bcd1
14 1 
new file mode 100644
15 2 
Binary files /dev/null and b/docs/sources/commandline/docker_images.gif differ
docs/sources/commandline/index.rst
History View file @ 689bcd1
... ... 
@@ -1,6 +1,6 @@
1 1 
 :title: Commands
2 
-:description: -- todo: change me
3 
-:keywords: todo, commands, command line, help, docker, documentation
2 
+:description: docker command line interface
3 
+:keywords: commands, command line, help, docker
4 4
5 5
6 6 
 Commands
... ... 
@@ -12,34 +12,3 @@ Contents:
12 12 
   :maxdepth: 1
13 13
14 14 
   cli
15 
-  attach  <command/attach>
16 
-  build   <command/build>
17 
-  commit  <command/commit>
18 
-  cp      <command/cp>
19 
-  diff    <command/diff>
20 
-  events  <command/events>
21 
-  export  <command/export>
22 
-  history <command/history>
23 
-  images  <command/images>
24 
-  import  <command/import>
25 
-  info    <command/info>
26 
-  insert  <command/insert>
27 
-  inspect <command/inspect>
28 
-  kill    <command/kill>
29 
-  login   <command/login>
30 
-  logs    <command/logs>
31 
-  port    <command/port>
32 
-  ps      <command/ps>
33 
-  pull    <command/pull>
34 
-  push    <command/push>
35 
-  restart <command/restart>
36 
-  rm      <command/rm>
37 
-  rmi     <command/rmi>
38 
-  run     <command/run>
39 
-  search  <command/search>
40 
-  start   <command/start>
41 
-  stop    <command/stop>
42 
-  tag     <command/tag>
43 
-  top     <command/top>
44 
-  version <command/version>
45 
-  wait    <command/wait>
docs/sources/examples/hello_world.rst
History View file @ 689bcd1
... ... 
@@ -178,4 +178,4 @@ you could skip to any of the other examples:
178 178 
 * :ref:`running_ssh_service`
179 179 
 * :ref:`running_couchdb_service`
180 180 
 * :ref:`postgresql_service`
181 
-* :ref:`mongodb`
181 
+* :ref:`mongodb_image`
docs/sources/index.rst
History View file @ 689bcd1
... ... 
@@ -2,8 +2,6 @@
2 2 
 :description: An overview of the Docker Documentation
3 3 
 :keywords: containers, lxc, concepts, explanation
4 4
5 
-.. image:: https://www.docker.io/static/img/linked/dockerlogo-horizontal.png
6 
-
7 5 
 Introduction
8 6 
 ------------
9 7
docs/sources/static_files/docker_images.gif
History View file @ 689bcd1
10 8 
deleted file mode 100644
11 9 
Binary files a/docs/sources/static_files/docker_images.gif and /dev/null differ