EMILUA(3em)

📦 version 0.12.1, in nixos 26.05, nixpkgs unstable

EMILUA 💅

okay so bestie, welcome to Emilua — it's a Lua execution engine ✨ and this particular page (it lives in section 3em, iykyk) is all about one tiny little function that messes with your process's umask. slay.

✨ NAME ✨

Emilua — a Lua execution engine 🦋

🌸 SYNOPSIS 🌸

local fs = require "filesystem"
fs.umask(mask: integer) -> integer

like, that's the whole vibe. you pull in "filesystem", you call fs.umask with an integer mask, and you get an integer back. no cap. 🎀

💖 DESCRIPTION 💖

So what does it actually do? It sets the file mode creation mask (the umask, bestie, the thing that decides which permission bits get quietly yeeted from newly created files) of the calling process to mask & 0777. that bitwise AND is doing the Lord's work, honestly.

And then — the moment you've been waiting for 👑 — it returns the old mask. the previous one. the one from before you walked in and changed everything. main character energy fr fr.

Note 🙈 Only the master VM is allowed to use this function. like, literally only the master VM. everyone else? not invited to this party. 💀

🫶 sign-off 🫶

that's the whole page, bestie — short and iconic, just how we like it. this lil masterpiece is from Emilua 0.12.1-nixpkgs1, dated 1980-01-01 (yes, that date is real, and yes, it's giving vintage ✨). go set some masks. responsibly. 💜🌈

📦 where this page comes from