The stat module provides detailed metadata for files and file systems, including permissions, ownership, sizes, and timestamps, with the ability to export this data in structured formats.
When to Activate
- When the user needs detailed file attributes (permissions, inode, last modified).
- When checking file system usage and limits (e.g., total space, free inodes).
- When exporting file metadata to JSON, CSV, or TSV for automated analysis.
- When browsing file details using an interactive TUI.
Core Principles & Rules
- Precision: Provides detailed, technical metadata beyond standard
lsoutput. - Export Formats: Prioritize
--jsonor--csvfor data processing tasks. - File System Support: Use the
-fflag to target entire file systems instead of individual files.
Patterns & Examples
File Metadata
# View detailed information for a specific file
x stat myfile.txt
File System Status
# Check the status of the root file system
x stat -f /
JSON Export
# Get file status as a JSON object
x stat --json myfile.txt
Checklist
- Confirm if the target is an individual file or a file system.
- Verify the desired output format (Human-readable, JSON, CSV).