mirror of
https://github.com/projectatomic/atomic.git
synced 2026-02-06 12:45:57 +01:00
35c18bc67d
https://github.com/projectatomic/atomic/issues/378 points out that when an rpm diff is done with --names-only, the output messaging was not clear enough. Reworked the man page, --help, and output message to clarify that when --names-only is used, it only compares RPMs based on names and NOT versions. Nice find by Micah. Closes: #381 Approved by: rhatdan
63 lines
1.7 KiB
Markdown
63 lines
1.7 KiB
Markdown
% ATOMIC(1) Atomic Man Pages
|
|
% Brent Baude
|
|
% November 2015
|
|
# NAME
|
|
atomic-diff - show the differences between two images|containers RPMs
|
|
# SYNOPSIS
|
|
**atomic diff**
|
|
[**-h**|**--help**]
|
|
[**--json**]
|
|
[**--names-only**]
|
|
[**-n**][**--no-files**]
|
|
[**-r**][**--rpms**]
|
|
[**-v**][**--verbose**]
|
|
image|container image|container ...]
|
|
|
|
# DESCRIPTION
|
|
**atomic diff** will compare the RPMs found in two different images or containers
|
|
and output to stdout or as JSON. By default, the comparison is done by name and
|
|
version of the RPMs.
|
|
|
|
# OPTIONS
|
|
**-h** **--help**
|
|
Print usage statement.
|
|
|
|
**--json**
|
|
Output in the form of JSON.
|
|
|
|
**-n** **--no-files**
|
|
Do not perform a file based diff between the two images or containers. Often used
|
|
when performing an RPM-based diff to restrict output.
|
|
|
|
**--names-only**
|
|
When performing the diff, only compare package names and not their versions.
|
|
|
|
**-r** **--rpms**
|
|
Show the where the two docker objects have different RPMs.
|
|
|
|
**-v** **--verbose**
|
|
Be verbose in showing the differences in RPMs. The default will only show the differences in RPMs, whereas
|
|
with **verbose** it will show all the RPMS in each object.
|
|
|
|
|
|
# EXAMPLES
|
|
Compare images the files in 'foo1' and 'foo2'.
|
|
|
|
atomic diff foo1 foo2
|
|
|
|
Compare the files in images 'foo1' and 'foo2' and output in JSON.
|
|
|
|
atomic diff --json foo1 foo2
|
|
|
|
Compare only the RPMs in images 'foo1' and 'foo2'
|
|
|
|
atomic diff -r -n foo1 foo2
|
|
|
|
Compare the files and RPMs (without versions) in images 'foo1' and 'foo2' and output as json
|
|
|
|
atomic diff -r --json foo1 foo2
|
|
|
|
# HISTORY
|
|
Updated by Brent Baude (bbaude at redhat dot com) May 2016
|
|
Initial revision by Brent Baude (bbaude at redhat dot com) November 2015
|