SNOBOL4STAT(3)

💅 SNOBOL4STAT(3) — the CSNOBOL4 Manual page you've been waiting for ✨

okay bestie, sit down, hydrate, because we're about to talk about the absolute icon of a file-status interface: snobol4stat 🎀 this page lives in the CSNOBOL4 manual and it's giving "let me peek at a file and tell you literally everything about it" energy. no cap.

---

🌸 NAME 🌸

snobol4stat — file status interface for SNOBOL4 🦋

---

✨ SYNOPSYS ✨

(yes bestie, that's how it's spelled up top, we don't fix, we respect 👑)

-INCLUDE 'stat.sno'

---

💖 DESCRIPTION 💖

so here's the whole vibe. you've got three little besties who will all go look at a file for you:

• STAT(path) — returns file status for path, and it follows symbolic links like a loyal friend who doesn't care what's behind the curtain 💫
• LSTAT(path) — returns file status for path, but this one returns information on symbolic links — it's the nosy one who's like "no, tell me about the link itself" 🙈
• FSTAT(fd) — returns file status for the open file descriptor fd. already got it open? slay, we don't need a path 💅

all three of them hand you back a DATA() object, and that object has the following members, and yes, we're listing every single one, because we don't skip parts in this house 🏠:

• ST_DEV — the device number containing the file 🔢
• ST_INO — the file number within the device 🔢
• ST_TYPE_STR — a STRING identifying the file type. the options are:
  • '-' for a regular file
  • 'b' for a block special file (device)
  • 'c' for a character special file (device)
  • 'd' for a directory
  • 'l' for a symbolic link
  • 'p' for a named pipe (FIFO)
  • 's' for a local (Unix) domain socket
  • 'w' for a whiteout
  • '?' for none of the above

(new in CSNOBOL4 2.1) ✨ iconic addition honestly

• ST_TYPE — an INTEGER identifying the file type. it's the ordinal value of the ST_TYPE_STR result, kept around for backwards compatibility 🫶
• ST_MODE — file "mode" (protection and type) bits 🔐
• ST_NLINK — the number of (hard) links to the file 🔗
• ST_UID — the owner of the file 👤
• ST_GID — the group of the file 👥
• ST_RDEV — device id for special file 🧚
• ST_SIZE — size in bytes 📏
• ST_BLOCKS — size in blocks 🧱
• ST_BLKSIZE — preferred block size for file I/O ⚙️
• ST_ATIME — access time in seconds since January 1st, 1970 ⏰
• ST_ATIMENSEC — fractional access time in nanoseconds 🔬
• ST_MTIME — data modification time in seconds since January 1st, 1970 ⏰
• ST_MTIMENSEC — fractional modification time in nanoseconds 🔬
• ST_CTIME — metadata change time in seconds since January 1st, 1970 ⏰
• ST_CTIMENSEC — fractional change time in nanoseconds 🔬

⚠️ important bestie: values will be the empty string if the data is not available. so if you get '' back, that's not a bug, that's just the truth being withheld from us 😭

---

🦋 SEE ALSO 🦋

snobol4(1), stat(2), lstat(2), fstat(2) — go read your other besties too, iykyk 💜

---

👑 AUTHOR 👑

Philip L. Budne — absolute legend, we stan 🫶

---

and that's the whole page, bestie!! this one's from <b>CSNOBOL4B 2.3.1</b>, dated <b>March 31, 2022</b> — so it's vintage but she still eats 💅✨ no notes, periodt. 🎀🌈⭐