NAME¶

render_expired - expires a list of map tiles so that they get re-rendered.

SYNOPSIS¶

render_expired [options]<expire.list

DESCRIPTION¶

This manual page documents briefly the render_expired command.

render_expired is a helper utility that takes a list of map tiles from stdin and expires them such that they will get re-rendered. Render_expired has three potential strategies of how to expire map tiles:
1) Render tiles directly: Render_expired can connect to the renderd socket and submit rendering requests for expired tiles directly
2) Delete tiles: Render_expired can delete expired tiles from disk. The next time the tile then gets viewed it will get re-rendered, assuming a dynamic rendering setup like mod_tile is installed
3) Mark tiles as dirty: A dynamic tile rendering system like mod_tile decides if a tile needs re-rendering by comparing the timestamp of the tile with the time of the planet-import-complet timestamp. Render_expired can set the timestamp of a tile back many years, ensuring it is older than the db import time, thus causeing the tile to be considered dirty and in need for re-render.

These three strategies can be combined and applied at different zoom levels. E.g. Zoom level 17-18 get deleted, z11 - z16 get marked dirty and z6 - z10 get rendered directly.

Render_expired takes a list of tiles from stdin which should be expired. The format of the list is one tile per line specified as z/x/y.
1/0/1
1/1/1
1/0/0
1/1/0

render_expired will automatically expand the list to cover the effected tiles at other zoom levels.

OPTIONS¶

This program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-m|--map=MAP

Specify the style-sheet for which to expire tiles. The default is "default".

-s|--socket=SOCKET

Specify the location of the renderd socket.

-n|--num-threads=N

Specify the number of parallel requests to renderd. Should renderd have less threads active, requests will be queued. The default is 1. default if --append is not specified.

-t|--tiledir=DIR

Specify the base directory where the rendered tiles are. The default is '/var/lib/mod_tile'

-z|--min-zoom=ZOOM

Filter input to only render tiles greater or equal to this zoom level (default is 0)

-Z|--max-zoom=ZOOM

Filter input to only render tiles less than or equal to this zoom level (default is 18)

-d|--delete-from=ZOOM

When expiring tiles of ZOOM or higher, delete them instead of re-rendering (default is off)

-T|--touch-from=ZOOM

when expiring tiles of ZOOM or higher, touch them instead of re-rendering (default is off)

SEE ALSO¶

renderd(1), mod_tile(1).

AUTHOR¶

render_expire was written by OpenStreetMap project members.

This manual page was written by OpenStreetMap authors.