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
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

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-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

CONTACT

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

AUTHORS

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