.TH "OSMIUM-CHANGESET-FILTER" "1" "1.6.1" "" ""
.SH NAME
.PP
osmium\-changeset\-filter \- filter changesets from OSM changeset file
.SH SYNOPSIS
.PP
\f[B]osmium changeset\-filter\f[] [\f[I]OPTIONS\f[]]
\f[I]OSM\-CHANGESET\-FILE\f[]
.SH DESCRIPTION
.PP
Copy the changesets matching all the given criteria to the output.
Matching criteria are given through command line options.
.SH FILTER OPTIONS
.TP
.B \-a, \-\-after=TIMESTAMP
Only copy changesets closed after the given time.
This will always include all open changesets.
.RS
.RE
.TP
.B \-b, \-\-before=TIMESTAMP
Only copy changesets created before the given time.
.RS
.RE
.TP
.B \-c, \-\-with\-changes
Only copy changesets with changes.
.RS
.RE
.TP
.B \-C, \-\-without\-changes
Only copy changesets without changes.
.RS
.RE
.TP
.B \-d, \-\-with\-discussion
Only copy changesets with discussions, ie changesets with at least one
comment.
.RS
.RE
.TP
.B \-D, \-\-without\-discussion
Only copy changesets without discussions, ie changesets without any
comments.
.RS
.RE
.TP
.B \-\-open
Only copy open changesets.
.RS
.RE
.TP
.B \-\-closed
Only copy closed changesets.
.RS
.RE
.TP
.B \-u, \-\-user=USER
Only copy changesets by the given user name.
.RS
.RE
.TP
.B \-U, \-\-uid=UID
Only copy changesets by the given user ID.
.RS
.RE
.SH COMMON OPTIONS
.TP
.B \-h, \-\-help
Show usage help.
.RS
.RE
.TP
.B \-v, \-\-verbose
Set verbose mode.
The program will output information about what it is doing to
\f[I]stderr\f[].
.RS
.RE
.TP
.B \-\-progress
Show progress bar.
Usually a progress bar is only displayed if STDERR is detected to be a
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.
.RS
.RE
.TP
.B \-\-no\-progress
Do not show progress bar.
Usually a progress bar is displayed if STDERR is 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.
.RS
.RE
.SH INPUT OPTIONS
.TP
.B \-F, \-\-input\-format=FORMAT
The format of the input file(s).
Can be used to set the input format if it can\[aq]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 \f[B]osmium\-file\-formats\f[](5) or the libosmium manual for
details.
.RS
.RE
.SH OUTPUT OPTIONS
.TP
.B \-f, \-\-output\-format=FORMAT
The format of the output file.
Can be used to set the output file format if it can\[aq]t be
autodetected from the output file name.
See \f[B]osmium\-file\-formats\f[](5) or the libosmium manual for
details.
.RS
.RE
.TP
.B \-\-fsync
Call fsync after writing the output file to force flushing buffers to
disk.
.RS
.RE
.TP
.B \-\-generator=NAME
The name and version of the program generating the output file.
It will be added to the header of the output file.
Default is "\f[I]osmium/\f[]" and the version of osmium.
.RS
.RE
.TP
.B \-o, \-\-output=FILE
Name of the output file.
Default is \[aq]\-\[aq] (STDOUT).
.RS
.RE
.TP
.B \-O, \-\-overwrite
Allow an existing output file to be overwritten.
Normally \f[B]osmium\f[] will refuse to write over an existing file.
.RS
.RE
.TP
.B \-\-output\-header=OPTION
Add output header option.
This option can be given several times.
See the \f[I]libosmium manual\f[] for a list of allowed header options.
.RS
.RE
.SH DIAGNOSTICS
.PP
\f[B]osmium changeset\-filter\f[] exits with exit code
.TP
.B 0
if everything went alright,
.RS
.RE
.TP
.B 1
if there was an error processing the data, or
.RS
.RE
.TP
.B 2
if there was a problem with the command line arguments.
.RS
.RE
.SH MEMORY USAGE
.PP
\f[B]osmium changeset\-filter\f[] does all its work on the fly and
doesn\[aq]t keep much data in main memory.
.SH EXAMPLES
.PP
To see all changesets by user "foo":
.IP
.nf
\f[C]
osmium\ changeset\-filter\ \-u\ foo\ \-f\ debug\ changesets.osm.bz2
\f[]
.fi
.PP
To create an OPL file containing only open changesets:
.IP
.nf
\f[C]
osmium\ changeset\-filter\ \-\-open\ \-o\ open\-changesets.opl.bz2\ changesets.osm.bz2
\f[]
.fi
.SH SEE ALSO
.IP \[bu] 2
\f[B]osmium\f[](1), \f[B]osmium\-file\-formats\f[](5)
.IP \[bu] 2
Osmium website (http://osmcode.org/osmium-tool/)
.SH COPYRIGHT
.PP
Copyright (C) 2013\-2017 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.
.SH CONTACT
.PP
If you have any questions or want to report a bug, please go to
http://osmcode.org/contact.html
.SH AUTHORS
Jochen Topf <jochen@topf.org>.