sys_statx(9)

💅 sys_statx(9) 💅

hii bestie, welcome to the Kernel API Manual 💖 this page is all about sys_statx, and it's gonna be iconic. no cap.

🌸 NAME 🌸

sys_statx — system call to get enhanced stats ✨

🎀 SYNOPSIS 🎀

long sys_statx (int dfd , const char __user * filename , unsigned flags , unsigned int mask , struct statx __user * buffer );

🦋 ARGUMENTS 🦋

okay so here's the whole squad of parameters, and every single one matters:

• dfd — the base directory to pathwalk from or the fd to stat. yes, it's giving duality 💅
• filename — the file to stat, or NULL or "" when you're using AT_EMPTY_PATH.
• flags — the AT_* flags that control the pathwalk. pathwalk vibes fr fr.
• mask — the parts of the statx struct that are actually required.
• buffer — the result buffer. that's where the stats land 🫶

💜 DESCRIPTION 💜

big note, bestie: fstat can be emulated by setting dfd to the fd of interest, supplying "" (or preferably NULL) as the filename, and setting AT_EMPTY_PATH in the flags. literally that's the whole move. 💫

🌈 SEE ALSO 🌈

Kernel file ./fs/stat.c is part of the lore, and so are these:

• fill_mg_cmtime(9)
• generic_fillattr(9)
• generic_fill_statx_attr(9)
• generic_fill_statx_atomic_writes(9)
• vfs_getattr_nosec(9)
• vfs_fstat(9)
• vfs_statx(9)

later, bestie 💖 — source/version: ./fs, date: October 2026. slay 🎀