179 lines
6.4 KiB
Groff
179 lines
6.4 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.43.3.
|
|
.TH OSMUPDATE "1" "September 2013"
|
|
.SH NAME
|
|
osmupdate \- Update OSM files
|
|
.SH "SYNOPSIS"
|
|
\&\fBosmupdate\fR \fIoptions\fR [\fIoldfile\fR] [\fInewfile\fR]
|
|
.SH DESCRIPTION
|
|
.PP
|
|
This program cares about updating an .osm, .o5m or .pbf file. It
|
|
will download and apply OSM Change files (.osc) from the servers of
|
|
"planet.openstreetmap.org".
|
|
It also can assemble a new .osc or .o5c file which can be used to
|
|
update your OSM data file at a later time.
|
|
.PP
|
|
Prequesites
|
|
.PP
|
|
To run this program, please download and install two other programs
|
|
first: "osmconvert" and "wget".
|
|
.PP
|
|
Usage
|
|
.PP
|
|
Two command line arguments are mandatory: the name of the old and the
|
|
name of the new OSM data file. If the old data file does not have a
|
|
file timestamp, you may want to specify this timestamp manually on
|
|
the command line. If you do not, the program will try to determine
|
|
the timestamp by examining the whole old data file.
|
|
Instead of the second parameter, you alternatively may specify the
|
|
name of a change file (.osc or .o5c). In this case, you also may
|
|
replace the name of the old OSM data file by a timestamp.
|
|
Command line arguments which are not recognized by osmupdate will be
|
|
passed to osmconvert. Use this opportunity to supply a bounding box
|
|
or a bounding polygon if you are going to update a regional change
|
|
file. You also may exclude unneeded meta data from your file by
|
|
specifying this osmconvert option: \fB\-\-drop\-author\fR
|
|
.PP
|
|
.SH OPTIONS
|
|
The program osmupdate recognizes a few command line options:
|
|
.PP
|
|
\fB\-\-max\-days\fR=\fIUPDATE_RANGE\fR
|
|
.IP
|
|
By default, the maximum time range for to assemble a
|
|
cumulated changefile is 250 days. You can change this by
|
|
giving a different maximum number of days, for example 300.
|
|
If you do, please ensure that there are daily change files
|
|
available for such a wide range of time.
|
|
.PP
|
|
\fB\-\-minute\fR
|
|
\fB\-\-hour\fR
|
|
\fB\-\-day\fR
|
|
\fB\-\-sporadic\fR
|
|
.IP
|
|
By default, osmupdate uses a combination of minutely, hourly
|
|
and daily changefiles. If you want to limit these changefile
|
|
categories, use one or two of these options and choose that
|
|
category/ies you want to be used.
|
|
The option \fB\-\-sporadic\fR allows processing changefile sources
|
|
which do not have the usual "minute", "hour" and "day"
|
|
subdirectories.
|
|
.PP
|
|
\fB\-\-max\-merge\fR=\fICOUNT\fR
|
|
.IP
|
|
The subprogram osmconvert is able to merge more than two
|
|
changefiles in one run. This ability increases merging speed.
|
|
Unfortunately, every changefile consumes about 200 MB of main
|
|
memory while being processed. For this reason, the number of
|
|
parallelly processable changefiles is limited.
|
|
Use this commandline argument to determine the maximum number
|
|
of parallelly processed changefiles. The default value is 7.
|
|
.PP
|
|
\fB\-t\fR=\fITEMPPATH\fR
|
|
\fB\-\-tempfiles\fR=\fITEMPPATH\fR
|
|
.IP
|
|
On order to cache changefiles, osmupdate needs a separate
|
|
directory. This parameter defines the name of this directory,
|
|
including the prefix of the tempfiles' names.
|
|
The default value is "osmupdate_temp/temp".
|
|
.PP
|
|
\fB\-\-keep\-tempfiles\fR
|
|
.IP
|
|
Use this option if you want to keep local copies of every
|
|
downloaded file. This is strongly recommended if you are
|
|
going to assemble different changefiles which overlap in
|
|
time ranges. Your data traffic will be minimized.
|
|
Do not invoke this option if you are going to use different
|
|
change file sources (option \fB\-\-base\-url\fR). This would cause
|
|
severe data corruption.
|
|
.PP
|
|
\fB--trust-tempfiles\fR
|
|
.IP
|
|
Use this option if you want to use the saved local copies
|
|
of already downloaded changefiles without checking their
|
|
lengths against to their server-hosted originals.
|
|
Downloads will be limited to files not saved yet.
|
|
Do not invoke this option if you suspect incomplete
|
|
downloads.
|
|
.PP
|
|
\fB\-\-compression\-level\fR=\fILEVEL\fR
|
|
.IP
|
|
Define level for gzip compression. Values between 1 (low
|
|
compression, but fast) and 9 (high compression, but slow).
|
|
.PP
|
|
\fB\-\-base\-url\fR=\fIBASE_URL\fR
|
|
.IP
|
|
To accelerate downloads or to get regional file updates you
|
|
may specify an alternative download location. Please enter
|
|
its URL, or simply the word "mirror" if you want to use
|
|
gwdg's planet server.
|
|
.PP
|
|
\fB\-\-base\-url\-suffix\fR=\fIBASE_URL_SUFFIX\fR
|
|
.IP
|
|
To use old planet URLs, you may need to add the suffix
|
|
"\-replicate" because it was custom to have this word in the
|
|
URL, right after the period identifier "day" etc.
|
|
.PP
|
|
\fB\-v\fR
|
|
\fB\-\-verbose\fR
|
|
.IP
|
|
With activated 'verbose' mode, some statistical data and
|
|
diagnosis data will be displayed.
|
|
If \fB\-v\fR resp. \fB\-\-verbose\fR is the first parameter in the line,
|
|
osmupdate will display all input parameters.
|
|
.SH NOTES
|
|
.PP
|
|
This program is for experimental use. Expect malfunctions and data
|
|
loss. Do not use the program in productive or commercial systems.
|
|
.PP
|
|
There is NO WARRANTY, to the extent permitted by law.
|
|
Please send any bug reports to marqqs@gmx.eu
|
|
.SH EXAMPLE
|
|
osmupdate old_file.o5m new_file.o5m
|
|
.br
|
|
osmupdate old_file.pbf new_file.pbf
|
|
.br
|
|
osmupdate old_file.osm new_file.osm
|
|
.IP
|
|
The old OSM data will be updated and written as new_file.o5m
|
|
or new_file.o5m. For safety reasons osmupdate will not delete
|
|
the old file. If you do not need it as backup file, please
|
|
delete it by yourself.
|
|
.IP
|
|
osmupdate old_file.osm 2011\-07\-15T23:30:00Z new_file.osm
|
|
.br
|
|
osmupdate old_file.osm NOW\-86400 new_file.osm
|
|
.IP
|
|
If your old OSM data file does not contain a file timestamp,
|
|
or you do not want to rely on this timestamp, it can be
|
|
specified manually. Relative times are in seconds to NOW.
|
|
.IP
|
|
osmupdate old_file.o5m change_file.o5c
|
|
.br
|
|
osmupdate old_file.osm change_file.osc
|
|
.br
|
|
osmupdate 2011\-07\-15T23:30:00Z change_file.o5c
|
|
.br
|
|
osmupdate 2011\-07\-15T23:30:00Z change_file.osc.gz
|
|
.br
|
|
osmupdate NOW\-3600 change_file.osc.gz
|
|
.IP
|
|
Here, the old OSM data file is not updated directly. An OSM
|
|
changefile is written instead. This changefile can be used to
|
|
update the OSM data file afterwards.
|
|
You will have recognized the extension .gz in the last
|
|
example. In this case, the OSM Change file will be written
|
|
with gzip compression. To accomplish this, you need to have
|
|
the program gzip installed on your system.
|
|
.IP
|
|
\&./osmupdate london_old.o5m london_new.o5m \fB\-B\fR=\fIlondon\fR.poly
|
|
.IP
|
|
The OSM data file london_old.o5m will be updated. Hence the
|
|
downloaded OSM changefiles contain not only London, but the
|
|
whole planet, a lot of unneeded data will be added to this
|
|
regional file. The \fB\-B=\fR argument will clip these superfluous
|
|
data.
|
|
.SH "SEE ALSO"
|
|
osmconvert(1), osmfilter(1)
|
|
.SH AUTHORS
|
|
.B osmconvert
|
|
was written by Markus Weber
|
