NAME

       osmium-diff - display differences between OSM files

SYNOPSIS

       osmium diff [OPTIONS] OSM-FILE1 OSM-FILE2

DESCRIPTION

       Finds  all differences between two OSM files and displays them.  This command compares all
       attributes of all objects, so it will even find, say, differences in the user name or even
       the  order  of tags, differences that should not happen in normal OSM data unless there is
       also a different object version.

       Only differences between objects (node, ways, and  relations)  are  found  and  displayed.
       Headers are ignored.

       Objects in both input files must be sorted in the same order.

       Several output formats are supported, see the OUTPUT FORMATS section.

       This  command  is intended for displaying the differences between files to humans.  It can
       not be used to create an OSM change file (.osc), use osmium-derive-changes for that.

OUTPUT FORMATS

       The following output formats are supported and can  be  set  with  the  --output-format/-f
       options.  Default is the compact format.

       compact
              A  very  compact format.  For all objects a line is printed with the type of object
              (`n', `w', or `r'), the object ID and then the version number.  If  objects  appear
              in  both  files  and are identical they are preceded by a space (’ `) character, if
              they are in both files, but different, they are  preceded  by  an  asterisk  ('*`).
              Otherwise they get a minus ('-`) or plus ('+’) character to show that they are only
              in the first or second file, respectively.

       opl    The usual OPL format with all lines preceded by space (’ `), minus ('-`),  or  plus
              ('+’)  characters  depending  on  whether  the object is in both, the first, or the
              second file.

       debug  The usual debug format with all lines preceded by space (’ `), minus ('-`), or plus
              ('+`)  characters  depending  on  whether  the object is in both, the first, or the
              second file. Color support can be enabled (’debug,color').

       None of the output formats print the headers of the input files.

OPTIONS

       -c, --suppress-common
              Do not output objects that are the same in both files.

       -f, --output-format=FORMAT
              See the OUTPUT FORMATS section.

       -o, --output=FILE
              Name of the output file.  Default is `-' (STDOUT).

       -O, --overwrite
              Allow an existing output file to be overwritten.  Normally osmium  will  refuse  to
              write over an existing file.

       -q, --quiet
              No output.  Just report when files differ through the return code.

       -s, --summary
              Print  count  of  objects  that are only in the left or right files, or the same in
              both or different in both to STDERR.

       -t, --object-type=TYPE
              Read only objects of given type (node, way, relation).  By default  all  types  are
              read.  This option can be given multiple times.  This affects the output as well as
              the return code of the command.

COMMON OPTIONS

       -h, --help
              Show usage help.

       -v, --verbose
              Set verbose mode.  The program will output information about what it  is  doing  to
              STDERR.

       --progress
              Show  progress  bar.  Usually a progress bar is only displayed if STDOUT and STDERR
              are detected to be TTY.  With this option a progress bar  is  always  shown.   Note
              that a progress bar will never be shown when reading from STDIN or a pipe.

       --no-progress
              Do not show progress bar.  Usually a progress bar is displayed if STDOUT and STDERR
              are detected to be a TTY.  With this option the progress bar is  suppressed.   Note
              that a progress bar will never be shown when reading from STDIN or a pipe.

INPUT OPTIONS

       -F, --input-format=FORMAT
              The  format  of the input file(s).  Can be used to set the input format if it can’t
              be autodetected from the file name(s).  This will set  the  format  for  all  input
              files,  there  is  no  way  to  set  the  format  for  some  input files only.  See
              osmium-file-formats(5) or the libosmium manual for details.

DIAGNOSTICS

       osmium diff exits with exit code

       0      if the files are the same,

       1      if the files are different, or

       2      if there was an error

MEMORY USAGE

       osmium diff doesn’t keep a lot of data in memory.

EXAMPLES

       Show difference between Nepal files from January 2016 and Febrary 2016 in compact format:

              osmium diff nepal-20160101.osm.pbf nepal-20160201.osm.pbf

       Show in color debug format only those objects that are different:

              osmium diff nepal-20160101.osm.pbf nepal-20160201.osm.pbf -f debug,color -c

SEE ALSO

       • osmium(1), osmium-file-formats(5), osmium-derive-changes(1)

       • Osmium website (https://osmcode.org/osmium-tool/)

COPYRIGHT

       Copyright (C) 2013-2019 Jochen Topf <jochen@topf.org>.

       License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.   This  is
       free  software:  you are free to change and redistribute it.  There is NO WARRANTY, to the
       extent permitted by law.

CONTACT

       If   you   have   any   questions   or   want   to   report   a   bug,   please   go    to
       https://osmcode.org/contact.html

AUTHORS

       Jochen Topf <jochen@topf.org>.

                                              1.11.1                               OSMIUM-DIFF(1)