LEIL(1)

📦 version 5.12.0, in nixpkgs unstable

🎀 NAME 🎀

okay bestie, welcome to LEIL(1) — the manual page for leil, the open prompt to perform LeilFS-specific operations. it's giving “small command, very specific job,” and honestly? iconic. use it when you need LeilFS to do its special little things. 💅

✨ SYNOPSIS ✨

here's the whole command family, bestie — copy these exactly, no typos, no vibes-based guessing:

       leil getgoal [-r] [-n|-h|-H] OBJECT...

       leil setgoal [-r] [-n|-h|-H] NAME OBJECT...

       leil setquota (-u UID | -g GID) SOFT-LIMIT-SIZE HARD-LIMIT-SIZE
                     SOFT-LIMIT-INODES HARD-LIMIT-INODES MOUNTPOINT-ROOT-PATH

       leil repquota [-nhH] (-u UID | -g GID)+ MOUNTPOINT-ROOT-PATH
       leil repquota [-nhH] -a MOUNTPOINT-ROOT-PATH

       leil gettrashtime [-r] [-n|-h|-H] OBJECT...

       leil settrashtime [-r] [-n|-h|-H] [+|-]SECONDS OBJECT...

       leil geteattr [-r] [-n|-h|-H] OBJECT...

       leil seteattr [-r] [-n|-h|-H] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

       leil deleattr [-r] [-n|-h|-H] -f ATTRNAME [-f ATTRNAME ...] OBJECT...

       leil checkfile FILE...

       leil fileinfo FILE...

       leil dirinfo [-n|-h|-H] OBJECT...

       leil filerepair [-n|-h|-H] FILE...

       leil appendchunks SNAPSHOT_FILE OBJECT...

       leil makesnapshot [-o] SOURCE... DESTINATION

       leil rremove OBJECT...

🌸 DESCRIPTION 🌸

see respective documents. that's basically the whole description, bestie — this page is like the group chat, and the actual lore lives in the individual docs. go read those for the deep dive. 🫶

✨ GENERAL OPTIONS ✨

most leil operations use these options to pick how printed numbers get formatted. number girlies, this is your moment:

  • -n — print exact numbers (like 1024).
  • -h — print numbers with binary prefixes (Ki, Mi, Gi as 2^10, 2^20 etc.).
  • -H — print numbers with SI prefixes (k, M, G as 10^3, 10^6 etc.).

you can get the same result by setting the SFSHRFORMAT environment variable to:

  • 0 — exact numbers
  • 1 or h — binary prefixes
  • 2 or H — SI prefixes
  • 3 or h+ — exact numbers and binary prefixes
  • 4 or H+ — exact numbers and SI prefixes

the default is to print just exact numbers. iykyk ✨

other options:

  • -r — enables recursive mode.
  • -v, --version — print version and exit.

🧬 INHERITANCE 🧬

okay so when a new object is created in LeilFS, attributes like goal, trashtime, and extra attributes are inherited from the parent directory. so if you set i.e. the "noowner" attribute and goal to 3 in a directory, then every new object created in that directory will have goal set to 3 and the "noowner" flag set. a newly created object always inherits the current set of its parent’s attributes. changing a directory attribute does not affect children that already exist. if you want to change an attribute for a directory and all of its children, use the -r option. 🦋

🐛 REPORTING BUGS 🐛

found a bug? not the vibe, but also please tell someone. report bugs to the GitHub repository https://github.com/leil-io/leilfs as an issue. 🙈

  • Copyright 2008-2009 Gemius SA
  • Copyright 2013-2019 Skytechnology sp. z o.o.
  • Copyright 2023-2024 Leil Storage OÜ

LeilFS is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3.

LeilFS is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with LeilFS. If not, see http://www.gnu.org/licenses/. 💜

👀 SEE ALSO 👀

go read these next, bestie — the extended cinematic universe:

that's the whole page, bestie 💖 — footer vibes: LEIL(1) · 1980-01-01. now go forth and slay your LeilFS ops ✨

📦 where this page comes from