NAME

       pyosmium-up-to-date

SYNOPSIS

       pyosmium-up-to-date [options] <osm file>

DESCRIPTION

       Update an OSM file with changes from a OSM replication server.

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

       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.

       This  program can update normal OSM data files as well as OSM history files.  It detects automatically on
       what type of file it is called.

       The program returns 0, if updates have been successfully applied up to the newest data or no new data was
       available. 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.

       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.

       <osm file>
              OSM file to update

OPTIONS

       -v     Increase verbosity (can be used multiple times).

       -o OUTFILE, --outfile OUTFILE
              Name output of file. If missing, the input file will be overwritten.

       --format FORMAT
              Format the data should be saved in. Usually determined from file name.

       --server SERVER_URL
              Base  URL  of  the  replication  server. Default: https://planet.osm.org/replication/hour/ (hourly
              diffs from osm.org)

       -s SIZE, --size SIZE
              Maximum size of change to apply at once in MB. Default: 1GB

       --tmpdir TMPDIR
              Directory to use for temporary files. Usually the directory of input file is used.

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

       -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

       --force-update-of-old-planet
              Apply update even if the input data is really old.

       --cookie COOKIE
              Netscape-style cookie jar file to read cookies from and where received cookies will be written to.

       --socket-timeout SOCKET_TIMEOUT
              Set timeout for file downloads.

       --version
              show program's version number and exit

AUTHOR

       Sarah Hoffmann
       lonvia@denofr.de

DISTRIBUTION

       The latest version of pyosmium may be downloaded from https://github.com/osmcode/pyosmium/

pyosmium                                           2025-03-04                             PYOSMIUM-UP-TO-DATE(1)