ola_trigger(1)

💖 ola_trigger — the manual, but make it cute 💖

okay so bestie, welcome to ola_trigger(1), a page from the General Commands Manual section of the Unix manual. yes you're literally reading a manpage for fun now, main character behaviour, we love that for you. sit down, grab a boba, and let's get into it 🧋✨

🌸 NAME 🌸

ola_trigger — run programs based on the values in a DMX stream. that's the whole vibe. DMX values come in, programs go off. slay 💅

✨ SYNOPSIS ✨

ola_trigger [ options ] <config_file>

so it's the program name, then optionally a pile of options, then your config_file which is literally required, no config no party. 🎀

🦋 DESCRIPTION 🦋

ola_trigger runs programs based on the values in a DMX stream. periodt. that's it, that's the whole thing — the DMX values are the vibe check and your programs are the ones reacting. 🎉

💅 OPTIONS 💅

okay this is the long part bestie, but every single one matters, no skipping, we're doing all of them 🌈

• -h, --help — shows you the help message. classic. when in doubt, ask for help, we love a self-aware icon 🫶
• -l, --log-level <int8_t> — sets the logging level, and it's a number from 0 to 4. lowkey chattier at some values, quieter at others, it's giving dial on a volume knob 🔊
• -o, --offset <uint16_t> — slaps an offset onto the slot numbers. valid offsets are 0 to 512, and the default is 0. it's a little shift, a little nudge, a little ✨adjustment✨
• -u, --universe <uint32_t> — which universe to use. defaults to 0, because of course it does, zero is the default of the universe 🌌
• --validate — checks the config file instead of running it. it's a vibe check on your config, not a performance, no programs get executed, just validation 🕵️‍♀️
• -v, --version — displays version information. the "who am i" moment, but for software 👑
• --syslog — sends stuff to syslog instead of stderr. relocating the gossip to a different group chat 📬
• --no-use-epoll — disables the use of epoll(), and reverts to select(). throwing it back to the old way, retro era 🙈
• --no-use-kqueue — disables the use of kqueue(), and reverts to select(). same energy, different platform, still going back to select() 🌸
• --scheduler-policy <policy> — the thread scheduling policy, and it's one of {fifo, rr}. pick your fighter 🥊
• --scheduler-priority <priority> — the thread priority, but heads up, it's only used if --scheduler-policy is set. no policy, no priority, they're a package deal fr fr 💞

also there's a --validate in there and it's instead of running, so don't expect your programs to fire while you're validating. just saying, bestie 😭

🎀 SEE ALSO 🎀

• olad(1) — the other one. go read it, it's iconic too 🌟

and that's the whole page!! written in October 2014, so it's an elder that still eats, and it's part of the General Commands Manual for ola_trigger(1). thanks for reading bestie, go trigger some programs, you got this 💖✨🦋💅🎀