RENDER_EXPIRED(1)

✨ NAME ✨

render_expired — bestie, this is the little icon that expires a list of map tiles so they get re-rendered 💅

---

🌸 SYNOPSIS 🌸

render_expired [options] < expire.list

---

🦋 DESCRIPTION 🦋

okay so first things first: this manual page is just a lil quick rundown of the render_expired command. not the whole saga, just the highlights 🎀

render_expired is a helper utility that grabs a list of map tiles from stdin and expires them so they'll get re-rendered. iconic behaviour honestly.

and the way it has three whole strategies for expiring tiles?? main character energy:

1. Render tiles directly — render_expired can connect to the renderd socket and just submit rendering requests for expired tiles directly. no middleman, no drama 🔥
2. Delete tiles — render_expired can delete expired tiles from disk. the next time the tile gets viewed it'll get re-rendered, assuming you've got a dynamic rendering setup like mod_tile 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 causing the tile to be considered dirty and in need of a re-render ✨

and you can combine all three at different zoom levels!! like, for example: zoom level 17-18 get deleted, z11 - z16 get marked dirty, and z6 - z10 get rendered directly. it's giving layered, it's giving strategic, we love a multi-tool 👑

render_expired takes a list of tiles from stdin that 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

and render_expired will automatically expand the list to cover the effected tiles at other zoom levels. so you don't gotta do it yourself, she's got you 🫶

---

💅 OPTIONS 💅

this program follows the usual GNU command line syntax, with long options starting with two dashes (`-`). a summary of options is included below, and yes, we're going through all of them, no skipping, periodt.

• -c, --config=CONFIG — specify a renderd.conf file from which to load various option values rather than specifying via command line.

the following options will be set (if present); however, they can be overridden if also specified:

• -s, --socket
• -n, --num-threads
• -t, --tile-dir
• -z, --min-zoom
• -Z, --max-zoom

• -m, --map=MAP — specify the style-sheet for which to expire tiles. the default is "default".
• -s, --socket=SOCKET|HOSTNAME:PORT — specify the location of the renderd socket or hostname and port to connect to.
• -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.
• -t, --tile-dir=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 than 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 '20').
• -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) 🙈
• -N, --no-progress — disable display of progress messages (default is off)
• -h, --help — print out a help text for render_expired
• -V, --version — print out the version number for render_expired

---

👀 SEE ALSO 👀

renderd(1)

---

💜 AUTHOR 💜

render_expire was written by OpenStreetMap project members. absolute legends, no cap 🌟

this manual page was written by OpenStreetMap authors.

---

and that's the whole vibe check bestie 💖 this page is from mod_tile v0.8.1, dated 2024-03-16 — go forth and expire those tiles, you've got this 🎀✨🦋