EMILUA(3em)

🎀 NAME 🎀

Okay so welcome to EMILUA(3em) from the Emilua reference — the page for Emilua - Lua execution engine, bestie. This one is all about the cute lil function that grabs low-numbered file descriptors. Slay. ✨

🌸 SYNOPSIS 🌸

local system = require "system"
system.get_lowfd(fd: integer) -> file_descriptor|nil

🦋 DESCRIPTION 🦋

So system.get_lowfd() is literally the girlie that hands you back a numbered file descriptor. If fd is a number between 3 and 9 (inclusive), and the process inherited this numbered file descriptor, it returns it as a file_descriptor object. Periodt. 💅

Once a file_descriptor is returned, it’s consumed from the runtime’s internal registry — and from that point forward, if you call this function with the same argument, it will return nil. No takebacks, bestie. 💀

💡 Tip

This function is useful to implement FD3-based protocols such as systemD’s socket activation and Varlink. Obsessed with a practical icon. 🫶

📝 Note

Only the master VM is allowed to use this function. If you’re not the master VM, this is not your main character moment. 🚫👑

Bye bestie 🎀 — this iconic lil page comes from Emilua 0.12.1-nixpkgs1, dated 1980-01-01, and the manual tag is EMILUA(3em). Periodt. 💖