1OSMIUM-SHOW(1) OSMIUM-SHOW(1)
2
3
4
6 osmium-show - show OSM file
7
9 osmium show [OPTIONS] OSM-FILE
10
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
15 OSMIUM_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
19 option --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
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
51 -h, --help
52 Show usage help.
53
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
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
72 osmium show does all its work on the fly and doesn’t keep much data in
73 main memory.
74
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
89 · osmium(1), osmium-cat(1), osmium-file-formats(5)
90
91 · Osmium website (https://osmcode.org/osmium-tool/)
92
94 Copyright (C) 2013-2020 Jochen Topf <jochen@topf.org>.
95
96 License GPLv3+: GNU GPL version 3 or later
97 <https://gnu.org/licenses/gpl.html>. This is free software: you are
98 free to change and redistribute it. There is NO WARRANTY, to the
99 extent permitted by law.
100
102 If you have any questions or want to report a bug, please go to
103 https://osmcode.org/contact.html
104
106 Jochen Topf <jochen@topf.org>.
107
108
109
110 1.12.1 OSMIUM-SHOW(1)