UMEGAYA-DDC-PING(1)

📦 version 1.0, in debian bookworm, ubuntu jammy, ubuntu noble

💖 umegaya-ddc-ping 💖

okay bestie, welcome to the manual page for umegaya-ddc-ping(1), aka Umegaya's debian-devel-changes pinger 🌸 she's a tiny script with one job and she does it flawlessly.

✨ SYNOPSIS ✨

umegaya-ddc-ping < email.txt

that's it. that's the whole vibe. she reads from stdin like the main character she is 👑

🌈 DESCRIPTION 🌈

so here's the tea ☕ — you pipe emails from http://lists.debian.org/debian-devel-changes into this program, and it goes and triggers a ping for the corresponding package in an Umegaya instance. no cap, that's the entire plot.

if emailaddress is subscribed to debian-devel-changes, then this lil entry in /etc/aliases will forward those emails straight to umegaya-ddc-ping:

emailaddress: |umegaya-ddc-ping

adorable, right? 🎀

now, how does she figure out which package to ping? she looks in the third field of the first line starting with Subject. yes, exactly that, don't ask, it's giving very specific and she's committed to it 💅

⚠️ and if that fails? the script returns with an exit code of 1, unless the messages option is used. so like, it will be dramatic about it unless you tell it not to 🙈

💅 OPTIONS 💅

okay so plot twist: umegaya-ddc-ping takes no option from the command line. zero. none. not a single flag. she's low maintenance like that ✨

instead, she reads the following from /etc/umegaya/umegaya.conf 👇

🦋 ping_url

the URL of an Umegaya instance. defaults to http://localhost/umegaya if you don't say anything. iconic default behaviour fr fr 🫶

🍓 messages

log pings and failures-to-determine-package-name to syslog, and do not exit with error in case of failure. this one is off by default. so if you want her to be chill about things and keep receipts in syslog, turn this on 💖

👑 SEE ALSO 👑

  • umegaya.conf (5)

🌸 AUTHORS 🌸

Charles Plessy. 💜

and that's the whole page bestie!! no crumbs left, every flag and default and exit code accounted for 😭✨

Umegaya User Manual — August 21, 2012 🎀 like yeah she's an old queen but she still slays 🫶 bye pookie, go ping something 💅🌟

📦 where this page comes from