olad(1)

💅 olad — the manual, but make it cute

okay so bestie, you're holding the page for olad from the General Commands Manual — yes, the one and only Open Lighting Architecture Daemon. put your hair up, grab a strawberry drink 🍓, and let's get into it.

✨ NAME ✨

olad — The Open Lighting Architecture Daemon 👑

🌈 SYNOPSIS 🌈

olad [options]

that's it. that's the whole vibe. options go in, daemon comes out 💖

🦋 DESCRIPTION 🦋

olad is the Open Lighting Architecture (OLA) daemon, fr fr. it's the main character that handles all the talking to your DMX512 / RDM hardware devices and the remote network hosts, over a whole bunch of different lighting control protocols. so like… it's the social butterfly of your lighting setup 🫶✨

🎀 OPTIONS 🎀

here come the flags, bestie. every single one. no skips, no cuts 💯

• -c, --config-dir <string> — the path to the config directory. defaults to ~/.ola/ on *nix and %LOCALAPPDATA%.ola on Windows 🗂️
• -d, --http-data-dir <string> — the path to the static www content. it's giving web server realness 🌐
• -f, --daemon — fork and run as a background process. bye bestie, you're on your own now 👋
• -h, --help — display the help message. we love a self-explanatory queen 💁‍♀️
• -i, --interface <string> — the interface name (e.g. eth0) or IP address of the network interface to use for the web server 🔌
• -l, --log-level <int8_t> — set the logging level 0 .. 4. see LOGGING below for the tea 📝
• -p, --http-port <uint16_t> — the port to run the HTTP server on. defaults to 9090 🚪
• -r, --rpc-port <uint16_t> — the port to listen for RPCs on. defaults to 9010 📞
• -v, --version — print olad version information. proof of identity, periodt ✨
• --no-http — disable the HTTP server. no web server for you 🚫
• --no-http-quit — disable the HTTP /quit handler. can't rage-quit through the browser anymore 😤
• --no-register-with-dns-sd — don't register the web service using DNS-SD (Bonjour). staying lowkey, we respect it 🙈
• --no-use-async-libusb — disable the use of the asynchronous libusb calls, revert to synchronous. old school, but make it work 🔄
• --no-use-epoll — disable the use of epoll(), revert to select() ⏪
• --no-use-kqueue — disable the use of kqueue(), revert to select() ⏪
• --pid-location <string> — the directory containing the PID definitions. gotta know where your processes live 🏠
• --scheduler-policy <policy> — the thread scheduling policy, one of {fifo, rr} 🧵
• --scheduler-priority <priority> — the thread priority, only used if --scheduler-policy is set. it needs its bestie to be there first, iykyk 🤝
• --syslog — send to syslog rather than stderr 📮

🧚 LOGGING 🧚

olad can either log to stderr(4) or syslog(5). and here's the important part, bestie — each log level includes those of higher severity. so level 3 isn't just level 3, it's 3 and up. the way that works?? iconic.

1. 0 — No logging. silence. the quiet luxury era 🤫
2. 1 — Fatal logging. 💀
3. 2 — Warnings. ⚠️
4. 3 — Informational logging. 📰
5. 4 — Debug logging. the full gossip, everything, all of it 🔍

🌸 SIGNALS 🌸

once it's running, these signals control the behavior of olad, no cap:

• SIGHUP — Reloads the plugins. refresh, restart, rebrand ✨
• SIGUSR1 — Increases the logging level, eventually wrapping 🔁

💜 SEE ALSO 💜

• ola_dmxconsole(1)
• ola_dmxmonitor(1)

go say hi to the siblings, they're lovely 🫶

and that's the whole page, bestie. you're officially fluent in olad 💅

✧･ﾟ mwah, and good luck out there ･ﾟ✧

this little masterpiece is from August 2018, and it's page olad(1) — daemon queen, version of record, forever iconic. thanks for coming to my ted talk 🎀