.\" Man page generated from reStructuredText.
.
.TH "PYOSMIUM-UP-TO-DATE" "1" "Jan 25, 2019" "2.15" "Pyosmium"
.SH NAME
pyosmium-up-to-date \- Bring OSM files up-to-date
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH USAGE
.SS pyosmium\-up\-to\-date.py
.sp
Update an OSM file with changes from a OSM replication server.
.sp
Diffs are downloaded and kept in memory. To avoid running out of memory,
the maximum size of diffs that can be downloaded at once is limited
to 1 GB per default. This corresponds to approximately 3 days of update.
The limit can be changed with the –size parameter. However, you should
take into account that processing the files requires additional memory
(about 1GB more).
.sp
The starting time is automatically determined from the data in the file.
For PBF files, it is also possible to read and write the replication
information from the osmosis headers. That means that after the first update,
subsequent calls to pyosmium\-up\-to\-date will continue the updates from the same
server exactly where they have left of.
.sp
The program returns 0, if updates have been successfully applied up to
the newest data. It returns 1, if some updates have been applied but
there is still data available on the server (either because the size
limit has been reached or there was a network error which could not be
resolved). Any other error results in a return code larger than 1. The
output file is guaranteed to be unmodified in that case.
.sp
Some OSM data sources require a cookie to be sent with the HTTP requests. 
Pyosmium\-up\-to\-date does not fetch the cookie from these services for you.
However, it can read cookies from a Netscape\-style cookie jar file, send these
cookies to the server and will save received cookies to the jar file.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
usage: pyosmium\-up\-to\-date [options] <osm file>
.ft P
.fi
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B <osm file>
OSM file to update
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
show this help message and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-v
Increase verbosity
.UNINDENT
.INDENT 0.0
.TP
.B \-o <outfile>, \-\-outfile <outfile>
Name output of file. If missing, the input file will be overwritten.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-server <server_url>
Base URL of the replication server. Default: ‘\fI\%https://planet.osm.org/replication/hour/\fP’ (hourly diffs from osm.org).
.UNINDENT
.INDENT 0.0
.TP
.B \-s <size>, \-\-size <size>
Maximum size of change to apply at once in MB. Default: 1GB.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-tmpdir <tmpdir>
Directory to use for temporary files. Default: directory of input file
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ignore\-osmosis\-headers
Ignore potential replication information in the header of the input file and search for the newest OSM object in the file instead.
.UNINDENT
.INDENT 0.0
.TP
.B \-b <wind_back>, \-\-wind\-back <wind_back>
Number of minutes to start downloading before the newest addition to input data. (Ignored when the file contains a sequence ID.) Default: 60.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-force\-update\-of\-old\-planet
Apply update even if the input data is really old.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-cookie <cookie>
Netscape\-style cookie jar file to read cookies from and where   
                              received cookies will be written to.
.UNINDENT
.SH AUTHOR
Sarah Hoffmann
.SH COPYRIGHT
2015-2019, Sarah Hoffmann
.\" Generated by docutils manpage writer.
.