stat

gives a short view of a file or directory; without a path it inspects the current directory

FilesVersion 1.1.6Stable
lil-terminal

Overview

stat gives a short view of a file or directory; without a path it inspects the current directory. stat feed.xml shows type, size, permissions and modification time. Files also show their extension and installed handlers, when available.

Inspect, then change

Use stat feed.xml before mod, mov or del; use stat feed.xml -f when you need the full metadata.

Syntax

lil-terminal
stat [path] [-f] [-L]

Reference

stat

show brief information for the current directory

stat <path>

show brief information without following a symbolic link

-f

show full filesystem information

-L

follow a symbolic link and inspect its target

Notes

Add -f for the full view: resolved path, MIME, ownership, timestamps and filesystem capacity where supported by PHP. -L matters for symbolic links: without it the link itself is examined; with it the target is examined. On a regular file, -L makes no difference.

Safety

Inspection is read-only. Missing paths and broken link targets produce explicit errors. Values in the interactive sandbox are illustrative, not measurements of your hosting account.

Interactive sandbox preview

Run the prepared examples directly on the page. Their results are prebuilt and shown in the browser; no terminal command is executed on the server.

Show brief information for the current directory

Install and manage

Install the current compatible version. Choose Base for the complete feature set or Minimum for the reduced package; use upgrade to update a module that is already installed.

Base and Minimum are two packages of the same current module release, not separate command versions.

Base package

Install the complete package with local command reference and every published mode.

install stat
Minimum package

Install the reduced package. Local reference is omitted; help <cmd> -i opens the current server reference.

install stat -m
Exact public version

Install exactly this published version.

install stat -v 1.1.6
Check or update

Ask upgrade to check compatibility and replace the installed block only when needed.

upgrade stat
Remove module

Remove the extension block while leaving the core and unrelated modules intact.

install stat -u

Examples

Examples are copyable command lines, not actions executed by this website. Review paths, permissions and destructive flags before running them on a real project.

Show brief information for the current directory
stat
Path         sandbox
Type         directory
Items        16
Permissions  0755  drwxr-xr-x
Modified     2026-08-11 18:40:00
Show brief information without following a symbolic link
stat \sandbox\feed.xml
Path         sandbox/feed.xml
Type         file
Extension    xml
Size         127 b (127 B)
Permissions  0644  -rw-r--r--
Modified     2026-08-11 18:40:00
Show full filesystem information
stat \sandbox\feed.xml -f
Path         sandbox/feed.xml
Type         file
Real         sandbox/feed.xml
Name         feed.xml
Directory    sandbox
Extension    xml

Size         127 b (127 B)
MIME         text/xml

Permissions  0644  -rw-r--r--
UID          1000
GID          1000

Access       rw-
Modified     2026-08-11 18:40:00
Changed      2026-08-11 18:40:00
Accessed     2026-08-11 18:40:00
Follow a symbolic link and inspect its target
stat \sandbox\feed.xml -L
Path         sandbox/feed.xml
Type         file
Extension    xml
Size         127 b (127 B)
Permissions  0644  -rw-r--r--
Modified     2026-08-11 18:40:00
Show brief information without following a symbolic link
stat \sandbox\images
Path         sandbox/images
Type         directory
Items        2
Permissions  0755  drwxr-xr-x
Modified     2026-08-11 18:40:00
Show full filesystem information
stat \sandbox\images -f
Path         sandbox/images
Type         directory
Real         sandbox/images
Name         images
Directory    sandbox
Extension    -

Items        2
Directories  0
Files        2
Links        0

Permissions  0755  drwxr-xr-x
Modified     2026-08-11 18:40:00
Show brief information without following a symbolic link
stat \sandbox\missing.txt
Path not found

File used in this example: sandbox/data/sample.txt

The example uses a file or directory from the protected /sandbox/ documentation workspace.

lil-terminal sandbox text file

This file is safe to read, copy, rename, replace, hash and archive.

Related documentation

How are filesystem operations protected? →Why are large files or outputs limited? →

Current public release

v1.1.62026-10-31

Consistent timestamps for links

The full stat view shows link timestamps without -L and target timestamps with -L.

# Version history