blob: 9d64579ed91332b529f2279e6da01080de6d4a04 [file] [log] [blame]
/* stat.c : display file or file system status
* Copyright 2012 <>
* Copyright 2013 <>
config STAT
bool stat
default y
usage: stat [-tfL] [-c FORMAT] FILE...
Display status of files or filesystems.
-c Output specified FORMAT string instead of default
-f display filesystem status instead of file status
-L Follow symlinks
-t terse (-c "%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %o")
(with -f = -c "%n %i %l %t %s %S %b %f %a %c %d")
The valid format escape sequences for files:
%a Access bits (octal) |%A Access bits (flags)|%b Size/512
%B Bytes per %b (512) |%d Device ID (dec) |%D Device ID (hex)
%f All mode bits (hex) |%F File type |%g Group ID
%G Group name |%h Hard links |%i Inode
%m Mount point |%n Filename |%N Long filename
%o I/O block size |%s Size (bytes) |%t Devtype major (hex)
%T Devtype minor (hex) |%u User ID |%U User name
%x Access time |%X Access unix time |%y File write time
%Y File write unix time|%z Dir change time |%Z Dir change unix time
The valid format escape sequences for filesystems:
%a Available blocks |%b Total blocks |%c Total inodes
%d Free inodes |%f Free blocks |%i File system ID
%l Max filename length |%n File name |%s Fragment size
%S Best transfer size |%t FS type (hex) |%T FS type (driver name)
#define FOR_stat
#include "toys.h"
char *fmt;
union {
struct stat st;
struct statfs sf;
} stat;
char *file, *pattern;
int patlen;
// Force numeric output to long long instead of manually typecasting everything
// and safely parse length prefix
static void out(char c, long long val)
sprintf(toybuf, "%.*sll%c", TT.patlen, TT.pattern, c);
printf(toybuf, val);
// Output string with parsed length prefix
static void strout(char *val)
sprintf(toybuf, "%.*ss", TT.patlen, TT.pattern);
printf(toybuf, val);
static void date_stat_format(struct timespec *ts)
char *s = toybuf+128;
strftime(s, sizeof(toybuf)-128, "%Y-%m-%d %H:%M:%S",
sprintf(s+strlen(s), ".%09ld", ts->tv_nsec);
static void print_stat(char type)
struct stat *stat = (struct stat *)&TT.stat;
if (type == 'a') out('o', stat->st_mode&~S_IFMT);
else if (type == 'A') {
char str[11];
mode_to_string(stat->st_mode, str);
} else if (type == 'b') out('u', stat->st_blocks);
else if (type == 'B') out('d', 512);
else if (type == 'd') out('d', stat->st_dev);
else if (type == 'D') out('x', stat->st_dev);
else if (type == 'f') out('x', stat->st_mode);
else if (type == 'F') {
char *t = "character device\0directory\0block device\0" \
"regular file\0symbolic link\0socket\0FIFO (named pipe)";
int i, filetype = stat->st_mode & S_IFMT;
for (i = 1; filetype != (i*8192) && i < 7; i++) t += strlen(t)+1;
if (!stat->st_size && filetype == S_IFREG) t = "regular empty file";
} else if (type == 'g') out('u', stat->st_gid);
else if (type == 'G') strout(getgroupname(stat->st_gid));
else if (type == 'h') out('u', stat->st_nlink);
else if (type == 'i') out('u', stat->st_ino);
else if (type == 'm') {
struct mtab_list *mt = xgetmountlist(0);
dev_t dev = stat->st_rdev ? stat->st_rdev : stat->st_dev;
// This mount point could exist multiple times, so show oldest.
for (dlist_terminate(mt); mt; mt = mt->next) if (mt->stat.st_dev == dev) {
llist_traverse(mt, free);
} else if (type == 'N') {
xprintf("`%s'", TT.file);
if (S_ISLNK(stat->st_mode))
if (readlink0(TT.file, toybuf, sizeof(toybuf)))
xprintf(" -> `%s'", toybuf);
} else if (type == 'o') out('u', stat->st_blksize);
else if (type == 's') out('u', stat->st_size);
else if (type == 't') out('x', dev_major(stat->st_rdev));
else if (type == 'T') out('x', dev_minor(stat->st_rdev));
else if (type == 'u') out('u', stat->st_uid);
else if (type == 'U') strout(getusername(stat->st_uid));
else if (type == 'x') date_stat_format(&stat->st_atim);
else if (type == 'X') out('u', stat->st_atime);
else if (type == 'y') date_stat_format(&stat->st_mtim);
else if (type == 'Y') out('u', stat->st_mtime);
else if (type == 'z') date_stat_format(&stat->st_ctim);
else if (type == 'Z') out('u', stat->st_ctime);
else xprintf("?");
static void print_statfs(char type) {
struct statfs *statfs = (struct statfs *)&TT.stat;
if (type == 'a') out('u', statfs->f_bavail);
else if (type == 'b') out('u', statfs->f_blocks);
else if (type == 'c') out('u', statfs->f_files);
else if (type == 'd') out('u', statfs->f_ffree);
else if (type == 'f') out('u', statfs->f_bfree);
else if (type == 'l') out('d', statfs->f_namelen);
else if (type == 't') out('x', statfs->f_type);
else if (type == 'T') {
char *s = "unknown";
struct {unsigned num; char *name;} nn[] = {
{0xADFF, "affs"}, {0x5346544e, "ntfs"}, {0x1Cd1, "devpts"},
{0x137D, "ext"}, {0xEF51, "ext2"}, {0xEF53, "ext3"},
{0x1BADFACE, "bfs"}, {0x9123683E, "btrfs"}, {0x28cd3d45, "cramfs"},
{0x3153464a, "jfs"}, {0x7275, "romfs"}, {0x01021994, "tmpfs"},
{0x3434, "nilfs"}, {0x6969, "nfs"}, {0x9fa0, "proc"},
{0x534F434B, "sockfs"}, {0x62656572, "sysfs"}, {0x517B, "smb"},
{0x4d44, "msdos"}, {0x4006, "fat"}, {0x43415d53, "smackfs"},
{0x73717368, "squashfs"}
int i;
for (i=0; i<ARRAY_LEN(nn); i++)
if (nn[i].num == statfs->f_type) s = nn[i].name;
} else if (type == 'i') {
char buf[32];
sprintf(buf, "%08x%08x", statfs->f_fsid.__val[0], statfs->f_fsid.__val[1]);
} else if (type == 's') out('d', statfs->f_frsize);
else if (type == 'S') out('d', statfs->f_bsize);
else strout("?");
void stat_main(void)
int flagf = toys.optflags & FLAG_f, i;
char *format, *f;
if (toys.optflags&FLAG_t) {
format = flagf ? "%n %i %l %t %s %S %b %f %a %c %d" :
"%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %o";
} else format = flagf
? " File: \"%n\"\n ID: %i Namelen: %l Type: %t\n"
"Block Size: %s Fundamental block size: %S\n"
"Blocks: Total: %b\tFree: %f\tAvailable: %a\n"
"Inodes: Total: %c\tFree: %d"
: " File: %N\n Size: %s\t Blocks: %b\t IO Blocks: %B\t%F\n"
"Device: %Dh/%dd\t Inode: %i\t Links: %h\n"
"Access: (%a/%A)\tUid: (%5u/%8U)\tGid: (%5g/%8G)\n"
"Access: %x\nModify: %y\nChange: %z";
if (toys.optflags & FLAG_c) format = TT.fmt;
for (i = 0; toys.optargs[i]; i++) {
int L = toys.optflags & FLAG_L;
TT.file = toys.optargs[i];
if (flagf && !statfs(TT.file, (void *)&TT.stat));
else if (flagf || (L ? stat : lstat)(TT.file, (void *)&TT.stat)) {
perror_msg("'%s'", TT.file);
for (f = format; *f; f++) {
if (*f != '%') putchar(*f);
else {
f = next_printf(f, &TT.pattern);
TT.patlen = f-TT.pattern;
if (TT.patlen>99) error_exit("bad %s", TT.pattern);
if (*f == 'n') strout(TT.file);
else if (flagf) print_statfs(*f);
else print_stat(*f);