nilfs_ioctl_get_sustat(9)

📦 version 7.3.1, in nixpkgs unstable

💅 nilfs_ioctl_get_sustat(9) — get segment usage statistics ✨

okay so bestie, welcome to the Kernel API Manual for nilfs_ioctl_get_sustat(9) — yes that's the whole name, it's giving "my parents gave me a long name and I'm owning it" 🎀

🌸 NAME 🌸

nilfs_ioctl_get_sustat — get segment usage statistics 💖

It literally does what it says on the tin, no cap.

✨ SYNOPSIS ✨

int nilfs_ioctl_get_sustat (struct inode *inode , struct file *filp ,
       unsigned int cmd , void __user *argp );

four arguments, one int back, that's the whole vibe 🦋

🫶 ARGUMENTS 🫶

  • inode — the inode object, bestie. the main character of the file world 👑
  • filp — the file object. it's giving "we're doing this on an open file" 🌈
  • cmd — the ioctl's request code. the lil "which thing are we doing" tag 🎀
  • argp — a pointer to the argument from userspace. this is where the answers go, iykyk 💫

💜 DESCRIPTION 💜

so, nilfs_ioctl_get_sustat returns segment usage statistics. periodt. 📊

the NILFS_IOCTL_GET_SUSTAT ioctl is what's used in lssu, in the nilfs_resize utilities, and by the nilfs_cleanerd daemon — like, those are its people, its little crew 🫶

the requested segment usage information gets copied to the userspace memory pointed to by argp. that's it, that's the whole job. slay. ✨

💀 RETURN 💀

0 on success 🎉 or one of the following negative error codes on failure (ngl the failures are the relatable part):

  • -EFAULT — failure during getting segment usage statistics 😭
  • -EIO — I/O error 🌀
  • -ENOMEM — insufficient memory available 💀

🦋 SEE ALSO 🦋

okay so this is the friend group, and honestly? it's a big one. go say hi:

and that's the whole page, bestie!! 💅 this lil manual page lives in ./fs/nilfs2 and it's dated October 2026 — go forth and read your segment usage statistics, i'm obsessed for you 💖🎀✨

📦 where this page comes from