.\" Man page generated from reStructuredText.
.
.TH "PYOSMIUM-GET-CHANGES" "1" "Feb 28, 2021" "3.1" "Pyosmium"
.SH NAME
pyosmium-get-changes \- Download OSM change files
.
.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\-get\-changes.py
.sp
Fetch diffs from an OSM planet server.
.sp
The starting point of the diff must be given either as a sequence ID or a date
or can be computed from an OSM file. If no output file is given, the program
will just print the initial sequence ID it would use (or save it in a file, if
requested) and exit. This can be used to bootstrap the update process.
.sp
The program tries to download until the latest change on the server is found
or the maximum requested diff size is reached. Note that diffs are kept in
memory during download.
.sp
On success, the program will print a single number to stdout, the sequence
number where to continue updates in the next run. This output can also be
written to (and later read from) a file.
.sp
\fINote:\fP you may pipe the diff also to standard output using ‘\-o \-‘. Then
the sequence number will not be printed. You must write it to a file in that
case.
.sp
Some OSM data sources require a cookie to be sent with the HTTP requests.
pyosmium\-get\-changes 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\-get\-changes [options]
.ft P
.fi
.UNINDENT
.UNINDENT
.INDENT 0.0
.TP
.B \-h, \-\-help
show this help message and exit
.UNINDENT
.INDENT 0.0
.TP
.B \-v
Increase verbosity (can be used multiple times)
.UNINDENT
.INDENT 0.0
.TP
.B \-o <outfile>, \-\-outfile <outfile>
Name of diff output file. If omitted, only the sequence ID will be printed where updates would start.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-format <format>
Format the data should be saved in.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-server <server_url>
Base URL of the replication server
.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
.INDENT 0.0
.TP
.B \-s <outsize>, \-\-size <outsize>
Maximum data to load in MB (default: 100MB).
.UNINDENT
.INDENT 0.0
.TP
.B \-I <id>, \-\-start\-id <id>
Sequence ID to start with
.UNINDENT
.INDENT 0.0
.TP
.B \-D <date>, \-\-start\-date <date>
Date when to start updates
.UNINDENT
.INDENT 0.0
.TP
.B \-O <osmfile>, \-\-start\-osm\-data <osmfile>
start at the date of the newest OSM object in the file
.UNINDENT
.INDENT 0.0
.TP
.B \-f <seq_file>, \-\-sequence\-file <seq_file>
Sequence file. If the file exists, then updates will start after the id given in the file. At the end of the process, the last sequence ID contained in the diff is written.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ignore\-osmosis\-headers
When determining the start from an OSM file, ignore potential replication information in the header and search for the newest OSM object.
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-no\-deduplicate
Do not deduplicate diffs.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-socket\-timeout <socket_timeout>
Set timeout for file downloads.
.UNINDENT
.INDENT 0.0
.TP
.B \-\-version
show program’s version number and exit
.UNINDENT
.SH AUTHOR
Sarah Hoffmann
.SH COPYRIGHT
2015-2021, Sarah Hoffmann
.\" Generated by docutils manpage writer.
.