OPENELPD(1)

💖 OPENELPD(1) — General Commands Manual 💖

okay bestie, pull up a chair, we're reading the openelpd manual together and honestly? it's giving iconic. this is the page for openelpd, and it lives in the General Commands Manual section, section 1, as one does. 💅

---

✨ NAME ✨

openelpd — an open source EchoLink proxy daemon 🦋

---

🌸 SYNOPSIS 🌸

openelpd [-d] [-F] [-L <log file>] [-S] [-V] [configuration file]

that's it, that's the whole vibe. flags go in, config file goes at the end, chaos ensues (affectionate). ✨

---

💜 DESCRIPTION 💜

so. EchoLink is a software system for connecting licensed radio amateurs so they can communicate over the internet using Voice over IP (VoIP). no cap, that's the actual thing it does.

here's the tea tho: EchoLink clients require that UDP ports 5198 and 5199 be "forwarded" to the machine running the client. and when that's not allowed, or it's otherwise just not possible, you use a proxy instead — it listens for data on these ports and forwards that data to a client over a TCP stream. main character energy, honestly.

OpenELP, an Open Source EchoLink Proxy, is a performance-oriented proxy which can be used with EchoLink software. it uses a compatible protocol, and a compatible configuration file syntax with the Java EchoLink proxy available from the EchoLink website. 🎀 compatible! periodt!

---

💅 OPTIONS 💅

• -d — turn on debugging output to the specified logging utility (by default, this is STDOUT/STDERR). default behavior is to produce no debug output. so if you want the receipts, you gotta ask for them. 👑
• -F — if specified, this parameter causes the main thread to run in the foreground, and not daemonize. child threads are still created for each additional port, but the main thread does not return unless the proxy is shut down. default behavior is to daemonize. so like, it stays right there with you instead of ghosting. 🫶
• -L — after initial startup is complete, switch the logging utility to output all information to the given file. if the file does not exist, it will be created. if it does exist, new log data will be appended to it. this flag is incompatible with -S. default behavior is not to use a log file, and route all information to STDOUT.
• -S — after initial startup is complete, switch the logging utility to output all information to syslog. this flag is incompatible with -L. default behaviour is not to use syslog, and route all information to STDOUT. (yes they wrote "behaviour" there and "behavior" everywhere else, we love a little inconsistency, it's character. 😭)
• -V — print the version of the daemon executable and exit. short, sweet, slays. ✨

🚨 and now for the configuration file lore: if the configuration file path is not specified, openelpd will first attempt to open the file named ELProxy.conf in the current working directory. on systems where a global configuration file path hint was specified at compile time, openelpd will use that configuration path as a last resort. so like, it checks locally first, then falls back. bestie behaviour fr fr.

---

🐛 BUGS 🐛

found a bug? any bugs should be reported to the project repository at:

http://github.com/cottsay/openelp/issues

go tell them, they want to know, no gatekeeping. 💜

---

👑 AUTHORS 👑

OpenELP was created by Scott K Logan, KM0H <logans@cottsay.net> — actual legend, we stan. 🌟

see the Authors file included with this program for a full list of authors and contributors. so many icons, honestly. 🌈

EchoLink(r) is a registered trademark of Synergenics, LLC. gotta respect the trademark, it's the law. 💅

---

🦋 SEE ALSO 🦋

• qtel(1)

---

and that's the whole page, bestie!! 🎀 this was the OPENELPD(1) page from the General Commands Manual — go forth and proxy responsibly, and remember: ports forwarded, vibes immaculate. 💖✨🌸