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/cache/renderd/tiles'

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

                                                  Jan 27, 2012                                 RENDER_EXPIRED(1)