TIREX-R...-CONTROL(1)

📦
version 0.8.0 · 8 versions
, in ubuntu stonking

💖 TIREX-RENDERING-CONTROL(1) 💖

okay bestie, so this page lives in the User Contributed Perl Documentation section of the manual (that's the manual name, iykyk), and it's literally the "hey tirex, chill for a sec" remote control you've been looking for. no cap. 🎀

✨ NAME ✨

tirex-rendering-control — send messages to control rendering 🦋

🫶 SYNOPSIS 🫶

tirex-rendering-control [OPTIONS] [BUCKET...]

literally that's it. options first, then a list of buckets if you're feeling specific. 💅

👑 OPTIONS 👑

  • -h, --help — shows you the help message. your basic "what does this thing do" button. 🥰
  • -d, --debug — run in debug mode. extra chatter, extra clues. 🔍
  • -c, --config=DIR — use the config DIR instead of the default /etc/tirex. main character move if your config lives somewhere else. 💅
  • --stop — sends stop_rendering_bucket commands to tirex-master for each bucket you listed on the command line. and if you didn't list any? it sends the command for all buckets except the one containing the priority 1 — which is usually the bucket getting live requests from the web server, so yeah, we're protecting that one. 🛡️ and if you really want every single one, use the special bucket name ALL.
  • --continue — sends continue_rendering_bucket commands to tirex-master for each bucket you listed on the command line. no buckets specified (or you said ALL)? then it's sent for all buckets. we're so back. 🔥

🌸 DESCRIPTION 🌸

sometimes you just need rendering tiles to, like, take a little nap. not forever. just for a minute. maybe you're updating the database, maybe you're re-starting the rendering daemon, maybe you're running some resource-intensive job on the machine that would straight-up conflict with rendering. it's giving "sorry bestie, not right now." 😭

this command sends the running tirex-master commands to stop (or continue) rendering for the buckets you specify. simple as. ✨

and here's the part you need to know: when you use --stop, this command blocks and waits for the currently rendering tiles to be finished. so when the command returns (with return code 0) you can be absolutely sure you can do whatever you want to do without the rendering interfering. periodt. 💖

🎀 FILES 🎀

  • /etc/tirex/tirex.conf — the configuration file. that's the one. 🗂️

🧚 DIAGNOSTICS 🧚

tirex-rendering-control returns:

  1. 0 if everything was alright 🎉
  2. 3 if the server could not be reached 💀
  3. 4 if there was an error parsing the command line 🙈

🌈 SEE ALSO 🌈

<http://wiki.openstreetmap.org/wiki/Tirex> — go read the wiki, bestie, it's iconic. ⭐

💜 AUTHORS 💜

Frederik Ramm <frederik.ramm@geofabrik.de>, Jochen Topf <jochen.topf@geofabrik.de> and possibly others. legends, all of them. 👑

ngl, if any of this is confusing, just remember: --stop blocks until tiles are done, --continue un-blocks, and the priority 1 bucket is lowkey the VIP you don't wanna freeze. got it? slay. 💅

okay that's the whole page!! this was perl v5.40.1, dated 2026-08-09 — mwah, stay rendering responsibly, ily bye 🫶✨

📦 where this page comes from