1ATOMIC(1)                        November 2015                       ATOMIC(1)
2
3
4

NAME

6       atomic-diff - show the differences between two images|containers RPMs
7
8
9

SYNOPSIS

11       atomic diff [-h|--help] [--json] [--names-only] [-n][--no-files]
12       [-r][--rpms] [-v][--verbose] image|container image|container ...]
13
14
15

DESCRIPTION

17       atomic diff will compare the files found in two different images or
18       containers and output to stdout or as JSON. By default,  the comparison
19       is done on the file level but there are switches for comparing RPMs and
20       metadata as well.
21
22
23

OPTIONS

25       -h --help
26         Print usage statement.
27
28
29       --json
30         Output in the form of JSON.
31
32
33       -k --keywords
34         Use the following keywords for comparison of files.  You must select
35       at least one but multiple can
36         be used as well. Keywords that are used for this option are
37       exclusive, which means that any only those
38         keywords will be used.
39
40
41       Keywords currently defined are: all, link, nlink, mode, type, time,
42       uid, gid, size, sha256digest
43
44
45       -m --metadata
46         Show the differences in the metadata for the two images or
47       containers.
48
49
50       -n --no-files
51         Do not perform a file based diff between the two images or
52       containers.  Often used
53         when performing an RPM-based diff to restrict output.
54
55
56       --names-only
57         When performing the diff, only compare package names and not their
58       versions.
59
60
61       -r --rpms
62         Show the where the two docker objects have different RPMs.
63
64
65       -v --verbose
66         Be verbose in showing the differences in RPMs.  The default will only
67       show the differences in RPMs, whereas
68         with verbose it will show all the RPMS in each object.
69
70
71

EXAMPLES

73       Compare images the files in 'foo1' and 'foo2'.
74
75
76              atomic diff foo1 foo2
77
78
79
80       Compare the files in images 'foo1' and 'foo2' and output in JSON.
81
82
83              atomic diff --json foo1 foo2
84
85
86
87       Compare only the RPMs in images 'foo1' and 'foo2'
88
89
90              atomic diff -r -n foo1 foo2
91
92
93
94       Compare the files and RPMs (without versions) in images 'foo1' and
95       'foo2' and output as json
96
97
98              atomic diff -r --json foo1 foo2
99
100
101
102       Compare only the metadata between images 'foo1' and 'foo2'
103
104
105              atomic diff -m foo1 foo2
106
107
108
109       Compare files by 'sha256digests' and 'time' between images 'foo1' and
110       'foo2'
111
112
113              atomic diff foo1 foo2 --keywords sha256digest time
114
115
116
117

HISTORY

119       Updated by Brent Baude (bbaude at redhat dot com) Nov 2016 Updated by
120       Brent Baude (bbaude at redhat dot com) May 2016 Initial revision by
121       Brent Baude (bbaude at redhat dot com) November 2015
122
123
124
125Brent Baude                     Atomic Man Pages                     ATOMIC(1)
Impressum