.TH "OSMIUM-SHOW" "1" "1.5.1" "" ""
.SH NAME
.PP
osmium\-show \- show OSM file
.SH SYNOPSIS
.PP
\f[B]osmium show\f[] [\f[I]OPTIONS\f[]] \f[I]OSM\-FILE\f[]
.SH DESCRIPTION
.PP
Show the contents of the \f[I]OSM\-FILE\f[] on STDOUT, usually in a
pager.
The output format can be set using the \f[B]\-f\f[],
\f[B]output\-format\f[] option, its shortcuts \f[B]\-d\f[] (debug format
with colors), \f[B]\-o\f[] (OPL), or \f[B]\-x\f[] (XML), or the
\f[C]OSMIUM_SHOW_FORMAT\f[] environment variable.
.PP
The pager can be set with the \f[C]OSMIUM_PAGER\f[] or the
\f[C]PAGER\f[] environment variable.
If neither is set, the default \f[C]less\f[] is used unless the option
\f[C]\-\-no\-pager\f[] is used.
If the pager variables are set to an empty value or to \f[C]cat\f[], no
pager is used.
On Windows there is no pager support at all.
.SH 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.
\f[B]See osmium\-file\-formats\f[](5) or the libosmium manual for
details.
.RS
.RE
.TP
.B \-\-no\-pager
Disable pager.
.RS
.RE
.TP
.B \-d, \-\-format\-debug
Same as \f[C]\-f\ debug,color=true\f[].
.RS
.RE
.TP
.B \-o, \-\-format\-opl
Same as \f[C]\-f\ opl\f[].
.RS
.RE
.TP
.B \-x, \-\-format\-xml
Same as \f[C]\-f\ xml\f[].
.RS
.RE
.TP
.B \-t, \-\-object\-type=TYPE
Read only objects of given type (\f[I]node\f[], \f[I]way\f[],
\f[I]relation\f[], \f[I]changeset\f[]).
By default all types are read.
This option can be given multiple times.
.RS
.RE
.SH COMMON OPTIONS
.TP
.B \-h, \-\-help
Show usage help.
.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 DIAGNOSTICS
.PP
\f[B]osmium show\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 show\f[] does all its work on the fly and doesn\[aq]t keep
much data in main memory.
.SH EXAMPLES
.PP
Show an OSM file using the default pager and default format:
.IP
.nf
\f[C]
osmium\ show\ norway.osm.pbf
\f[]
.fi
.PP
Use \f[C]more\f[] as a pager and only show relations:
.IP
.nf
\f[C]
OSMIUM_PAGER=more\ osmium\ show\ \-r\ norway.osm.pbf
\f[]
.fi
.PP
Show using XML format:
.IP
.nf
\f[C]
osmium\ show\ \-x\ norway.osm.pbf
\f[]
.fi
.SH SEE ALSO
.IP \[bu] 2
\f[B]osmium\f[](1), \f[B]osmium\-cat\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>.