1berry/docker-cli
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clarify what docker diff shows

Browse Source 
Signed-off-by: Misty Stanley-Jones <misty@docker.com>
This commit is contained in:
Misty Stanley-Jones 2016-12-20 11:47:54 -08:00 committed by Tibor Vass
parent 9d27f13dd8
commit fbb21b0191
2 changed files with 73 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
docs/reference/commandline/diff.md
View File

@ -13,36 +13,53 @@ keywords: "list, changed, files, container"
will be rejected. will be rejected.
--> -->
# diff ## diff
```markdown ```markdown
Usage: docker diff CONTAINER Usage: docker diff CONTAINER
Inspect changes on a container's filesystem Inspect changes to files or directories on a container's filesystem
Options: Options:
--help Print usage --help Print usage
``` ```
List the changed files and directories in a container᾿s filesystem. List the changed files and directories in a container᾿s filesystem since the
There are 3 events that are listed in the `diff`: container was created. Three different types of change are tracked:
1. `A` - Add | Symbol | Description |
2. `D` - Delete |--------|---------------------------------|
3. `C` - Change | `A` | A file or directory was added |
| `D` | A file or directory was deleted |
| `C` | A file or directory was changed |
For example: You can use the full or shortened container ID or the container name set using
`docker run --name` option.
$ docker diff 7bb0e258aefe ## Examples
Inspect the changes to an `nginx` container:
```bash
$ docker diff 1fdfd1f54c1b
C /dev C /dev
A /dev/kmsg C /dev/console
C /etc C /dev/core
A /etc/mtab C /dev/stdout
A /go C /dev/fd
A /go/src C /dev/ptmx
A /go/src/github.com C /dev/stderr
A /go/src/github.com/docker C /dev/stdin
A /go/src/github.com/docker/docker C /run
A /go/src/github.com/docker/docker/.git A /run/nginx.pid
.... C /var/lib/nginx/tmp
A /var/lib/nginx/tmp/client_body
A /var/lib/nginx/tmp/fastcgi
A /var/lib/nginx/tmp/proxy
A /var/lib/nginx/tmp/scgi
A /var/lib/nginx/tmp/uwsgi
C /var/log/nginx
A /var/log/nginx/access.log
A /var/log/nginx/error.log
```

22
man/docker-diff.1.md
View File

@ -2,7 +2,7 @@
% Docker Community % Docker Community
% JUNE 2014 % JUNE 2014
# NAME # NAME
docker-diff - Inspect changes on a container's filesystem docker-diff - Inspect changes to files or directories on a container's filesystem
# SYNOPSIS # SYNOPSIS
**docker diff** **docker diff**
@ -10,8 +10,16 @@ docker-diff - Inspect changes on a container's filesystem
CONTAINER CONTAINER
# DESCRIPTION # DESCRIPTION
Inspect changes on a container's filesystem. You can use the full or List the changed files and directories in a container᾿s filesystem since the
shortened container ID or the container name set using container was created. Three different types of change are tracked:
| Symbol | Description |
|--------|---------------------------------|
| `A` | A file or directory was added |
| `D` | A file or directory was deleted |
| `C` | A file or directory was changed |
You can use the full or shortened container ID or the container name set using
**docker run --name** option. **docker run --name** option.
# OPTIONS # OPTIONS
@ -19,9 +27,12 @@ shortened container ID or the container name set using
Print usage statement Print usage statement
# EXAMPLES # EXAMPLES
Inspect the changes to on a nginx container:
# docker diff 1fdfd1f54c1b Inspect the changes to an `nginx` container:
```bash
$ docker diff 1fdfd1f54c1b
C /dev C /dev
C /dev/console C /dev/console
C /dev/core C /dev/core
@ -41,6 +52,7 @@ Inspect the changes to on a nginx container:
C /var/log/nginx C /var/log/nginx
A /var/log/nginx/access.log A /var/log/nginx/access.log
A /var/log/nginx/error.log A /var/log/nginx/error.log
```
# HISTORY # HISTORY