LEI-DAEMON(8)

📦
version 2.1.0 · 5 versions
, in arch rolling, nixos 26.05, nixpkgs unstable

🎀 NAME 🎀

lei-daemon — technical information for local email interface daemon. That's the official NAME drop, bestie, and you're in the lei-daemon(8) page of the public-inbox user manual. 🫶

✨ DESCRIPTION ✨

This is the high-level overview for developers and administrators interested in how lei works. No cap.

lei-daemon is a background daemon which powers the lei(1) command-line tool. It may support virtual users and read-write IMAP+JMAP APIs in the future. It is designed to optimize shell completion by avoiding module loading costs, and to monitor Maildirs (and in the near future, IMAP folders) for changes. ✨

🧚 worker processes 🧚

Most commands cause lei-daemon to fork(2) new worker processes to isolate and parallelize work. lei-daemon is significantly more aggressive than read-only public-inbox-daemon(8) processes with regards to resource use, since it's not designed to support C10K/C100K scenarios. Like, it's not here to host the whole internet, iykyk. 💀

💌 file descriptor passing 💌

FD passing is used to reduce IPC costs for bulk I/O when importing large mboxes from stdin and dumping large mboxes to stdout. It's giving efficient little handoff. 🎀

📬 SOCK_SEQPACKET 📬

SOCK_SEQPACKET sockets are used for both communicating with lei(1) and to internal workers. SOCK_SEQPACKET guarantees reliability (unlike SOCK_DGRAM), allows easy load distribution, and saves developers the trouble of maintaining stream parsers. Obsessed with not writing stream parsers, honestly. 🦋

👀 file monitoring 👀

Inotify or EVFILT_VNODE is used depending on the platform to monitor Maildirs for changes and track keyword changes.

The listen socket (default: $XDG_RUNTIME_DIR/lei/5.seq.sock) is also monitored, and the daemon will automatically shutdown if it is unlinked. So don't go unlinkin' it unless you want it gone, bestie. 😭

🫶 CONTACT 🫶

Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>. 🧚

The mail archives are hosted at <https://public-inbox.org/meta/> and <http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>. 🌸

Copyright all contributors <mailto:meta@public-inbox.org>. 👑

License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>. ⭐

🌈 SEE ALSO 🌈

Okay that's the whole page, bestie — source/version public-inbox.git, dated 1993-10-02, signing off with maximum sparkle. 💖✨

📦 where this page comes from