1OSMIUM-SHOW(1)                                                  OSMIUM-SHOW(1)
2
3
4

NAME

6       osmium-show - show OSM file
7

SYNOPSIS

9       osmium show [OPTIONS] OSM-FILE
10

DESCRIPTION

12       Show  the  contents of the OSM-FILE on STDOUT, usually in a pager.  The
13       output format can be set using the output-format/-f option, its  short‐
14       cuts  -d  (debug format with colors), -o (OPL), or -x (XML), or the OS‐
15       MIUM_SHOW_FORMAT environment variable.
16
17       The pager can be set with the OSMIUM_PAGER  or  the  PAGER  environment
18       variable.   If  neither is set, the default less is used unless the op‐
19       tion --no-pager is used.  If the pager variables are set  to  an  empty
20       value  or  to cat, no pager is used.  On Windows there is no pager sup‐
21       port at all.
22
23       This commands reads its input file only once, ie.   it  can  read  from
24       STDIN.
25

OPTIONS

27       -f, --output-format=FORMAT
28              The  format  of  the output file.  Can be used to set the output
29              file format if it can’t be autodetected  from  the  output  file
30              name.   See  osmium-file-formats(5)  or the libosmium manual for
31              details.
32
33       --no-pager
34              Disable pager.
35
36       -d, --format-debug
37              Same as -f debug,color=true.
38
39       -o, --format-opl
40              Same as -f opl.
41
42       -x, --format-xml
43              Same as -f xml.
44
45       -t, --object-type=TYPE
46              Read only objects of given type (node,  way,  relation,  change‐
47              set).   By default all types are read.  This option can be given
48              multiple times.
49

COMMON OPTIONS

51       -h, --help
52              Show usage help.
53

INPUT OPTIONS

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

DIAGNOSTICS

63       osmium show exits with exit code
64
65       0      if everything went alright,
66
67       1      if there was an error processing the data, or
68
69       2      if there was a problem with the command line arguments.
70

MEMORY USAGE

72       osmium show does all its work on the fly and doesn’t keep much data  in
73       main memory.
74

EXAMPLES

76       Show an OSM file using the default pager and default format:
77
78              osmium show norway.osm.pbf
79
80       Use more as a pager and only show relations:
81
82              OSMIUM_PAGER=more osmium show -t r norway.osm.pbf
83
84       Show using XML format:
85
86              osmium show -x norway.osm.pbf
87

SEE ALSO

89       • osmium(1), osmium-cat(1), osmium-file-formats(5)
90
91       • Osmium website (https://osmcode.org/osmium-tool/)
92

94       Copyright (C) 2013-2023 Jochen Topf <jochen@topf.org>.
95
96       License  GPLv3+:  GNU  GPL  version  3  or  later  <https://gnu.org/li‐
97       censes/gpl.html>.  This is free software: you are free  to  change  and
98       redistribute it.  There is NO WARRANTY, to the extent permitted by law.
99

CONTACT

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

AUTHORS

105       Jochen Topf <jochen@topf.org>.
106
107
108
109                                    1.16.0                      OSMIUM-SHOW(1)
Impressum