1 /* stat.c -- display file or file system status
2 Copyright (C) 2001-2008 Free Software Foundation, Inc.
4 This program is free software: you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation, either version 3 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program. If not, see <http://www.gnu.org/licenses/>.
17 Written by Michael Meskes. */
21 /* Keep this conditional in sync with the similar conditional in
22 ../m4/stat-prog.m4. */
24 && (HAVE_STRUCT_STATVFS_F_BASETYPE || HAVE_STRUCT_STATVFS_F_FSTYPENAME \
25 || (! HAVE_STRUCT_STATFS_F_FSTYPENAME && HAVE_STRUCT_STATVFS_F_TYPE)))
26 # define USE_STATVFS 1
28 # define USE_STATVFS 0
33 #include <sys/types.h>
37 # include <sys/statvfs.h>
40 #elif HAVE_SYS_MOUNT_H && HAVE_SYS_PARAM_H
41 /* NOTE: freebsd5.0 needs sys/param.h and sys/mount.h for statfs.
42 It does have statvfs.h, but shouldn't use it, since it doesn't
43 HAVE_STRUCT_STATVFS_F_BASETYPE. So find a clean way to fix it. */
44 /* NetBSD 1.5.2 needs these, for the declaration of struct statfs. */
45 # include <sys/param.h>
46 # include <sys/mount.h>
47 # if HAVE_NETINET_IN_H && HAVE_NFS_NFS_CLNT_H && HAVE_NFS_VFS_H
48 /* Ultrix 4.4 needs these for the declaration of struct statfs. */
49 # include <netinet/in.h>
50 # include <nfs/nfs_clnt.h>
53 #elif HAVE_OS_H /* BeOS */
56 #include <selinux/selinux.h>
62 #include "file-type.h"
67 #include "stat-time.h"
69 #include "areadlink.h"
71 #define alignof(type) offsetof (struct { char c; type x; }, x)
74 # define STRUCT_STATVFS struct statvfs
75 # define STRUCT_STATXFS_F_FSID_IS_INTEGER STRUCT_STATVFS_F_FSID_IS_INTEGER
76 # define HAVE_STRUCT_STATXFS_F_TYPE HAVE_STRUCT_STATVFS_F_TYPE
77 # if HAVE_STRUCT_STATVFS_F_NAMEMAX
78 # define SB_F_NAMEMAX(S) ((S)->f_namemax)
80 # define STATFS statvfs
81 # define STATFS_FRSIZE(S) ((S)->f_frsize)
83 # define HAVE_STRUCT_STATXFS_F_TYPE HAVE_STRUCT_STATFS_F_TYPE
84 # if HAVE_STRUCT_STATFS_F_NAMELEN
85 # define SB_F_NAMEMAX(S) ((S)->f_namelen)
87 # define STATFS statfs
88 # if HAVE_OS_H /* BeOS */
89 /* BeOS has a statvfs function, but it does not return sensible values
90 for f_files, f_ffree and f_favail, and lacks f_type, f_basetype and
91 f_fstypename. Use 'struct fs_info' instead. */
93 statfs (char const *filename
, struct fs_info
*buf
)
95 dev_t device
= dev_for_path (filename
);
98 errno
= (device
== B_ENTRY_NOT_FOUND
? ENOENT
99 : device
== B_BAD_VALUE
? EINVAL
100 : device
== B_NAME_TOO_LONG
? ENAMETOOLONG
101 : device
== B_NO_MEMORY
? ENOMEM
102 : device
== B_FILE_ERROR
? EIO
106 /* If successful, buf->dev will be == device. */
107 return fs_stat_dev (device
, buf
);
110 # define f_blocks total_blocks
111 # define f_bfree free_blocks
112 # define f_bavail free_blocks
113 # define f_bsize io_size
114 # define f_files total_nodes
115 # define f_ffree free_nodes
116 # define STRUCT_STATVFS struct fs_info
117 # define STRUCT_STATXFS_F_FSID_IS_INTEGER true
118 # define STATFS_FRSIZE(S) ((S)->block_size)
120 # define STRUCT_STATVFS struct statfs
121 # define STRUCT_STATXFS_F_FSID_IS_INTEGER STRUCT_STATFS_F_FSID_IS_INTEGER
122 # define STATFS_FRSIZE(S) 0
127 # define OUT_NAMEMAX out_uint
129 /* NetBSD 1.5.2 has neither f_namemax nor f_namelen. */
130 # define SB_F_NAMEMAX(S) "*"
131 # define OUT_NAMEMAX out_string
134 #if HAVE_STRUCT_STATVFS_F_BASETYPE
135 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME f_basetype
137 # if HAVE_STRUCT_STATVFS_F_FSTYPENAME || HAVE_STRUCT_STATFS_F_FSTYPENAME
138 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME f_fstypename
139 # elif HAVE_OS_H /* BeOS */
140 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME fsh_name
144 /* FIXME: these are used by printf.c, too */
145 #define isodigit(c) ('0' <= (c) && (c) <= '7')
146 #define octtobin(c) ((c) - '0')
147 #define hextobin(c) ((c) >= 'a' && (c) <= 'f' ? (c) - 'a' + 10 : \
148 (c) >= 'A' && (c) <= 'F' ? (c) - 'A' + 10 : (c) - '0')
150 #define PROGRAM_NAME "stat"
152 #define AUTHORS proper_name ("Michael Meskes")
156 PRINTF_OPTION
= CHAR_MAX
+ 1
159 static struct option
const long_options
[] =
161 {"context", no_argument
, 0, 'Z'},
162 {"dereference", no_argument
, NULL
, 'L'},
163 {"file-system", no_argument
, NULL
, 'f'},
165 /* obsolete and undocumented alias: FIXME: remove in 2009 */
166 {"filesystem", no_argument
, NULL
, 'f'},
168 {"format", required_argument
, NULL
, 'c'},
169 {"printf", required_argument
, NULL
, PRINTF_OPTION
},
170 {"terse", no_argument
, NULL
, 't'},
171 {GETOPT_HELP_OPTION_DECL
},
172 {GETOPT_VERSION_OPTION_DECL
},
176 /* Whether to follow symbolic links; True for --dereference (-L). */
177 static bool follow_links
;
179 /* Whether to interpret backslash-escape sequences.
180 True for --printf=FMT, not for --format=FMT (-c). */
181 static bool interpret_backslash_escapes
;
183 /* The trailing delimiter string:
184 "" for --printf=FMT, "\n" for --format=FMT (-c). */
185 static char const *trailing_delim
= "";
187 /* Return the type of the specified file system.
188 Some systems have statfvs.f_basetype[FSTYPSZ] (AIX, HP-UX, and Solaris).
189 Others have statvfs.f_fstypename[_VFS_NAMELEN] (NetBSD 3.0).
190 Others have statfs.f_fstypename[MFSNAMELEN] (NetBSD 1.5.2).
191 Still others have neither and have to get by with f_type (Linux).
192 But f_type may only exist in statfs (Cygwin). */
194 human_fstype (STRUCT_STATVFS
const *statfsbuf
)
196 #ifdef STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
197 return statfsbuf
->STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
;
199 switch (statfsbuf
->f_type
)
201 # if defined __linux__
203 /* Compare with what's in libc:
204 f=/a/libc/sysdeps/unix/sysv/linux/linux_fsinfo.h
205 sed -n '/ADFS_SUPER_MAGIC/,/SYSFS_MAGIC/p' $f \
206 | perl -n -e '/#define (.*?)_(?:SUPER_)MAGIC\s+0x(\S+)/' \
207 -e 'and print "case S_MAGIC_$1: /\* 0x" . uc($2) . " *\/\n"' \
209 perl -ne '/^\s+(case S_MAGIC_.*?): \/\* 0x(\S+) \*\//' \
210 -e 'and do { $v=uc$2; print "$1: /\* 0x$v *\/\n"}' stat.c \
212 diff -u sym_stat sym_libc
215 /* Also sync from the list in "man 2 statfs". */
217 /* IMPORTANT NOTE: Each of the following `case S_MAGIC_...:'
218 statements must be followed by a hexadecimal constant in
219 a comment. The S_MAGIC_... name and constant are automatically
220 combined to produce the #define directives in fs.h. */
222 case S_MAGIC_ADFS
: /* 0xADF5 */
224 case S_MAGIC_AFFS
: /* 0xADFF */
226 case S_MAGIC_AUTOFS
: /* 0x187 */
228 case S_MAGIC_BEFS
: /* 0x42465331 */
230 case S_MAGIC_BFS
: /* 0x1BADFACE */
232 case S_MAGIC_BINFMT_MISC
: /* 0x42494e4d */
233 return "binfmt_misc";
234 case S_MAGIC_CODA
: /* 0x73757245 */
236 case S_MAGIC_COH
: /* 0x012FF7B7 */
238 case S_MAGIC_CRAMFS
: /* 0x28CD3D45 */
240 case S_MAGIC_DEVFS
: /* 0x1373 */
242 case S_MAGIC_DEVPTS
: /* 0x1CD1 */
244 case S_MAGIC_EFS
: /* 0x414A53 */
246 case S_MAGIC_EXT
: /* 0x137D */
248 case S_MAGIC_EXT2
: /* 0xEF53 */
250 case S_MAGIC_EXT2_OLD
: /* 0xEF51 */
252 case S_MAGIC_FAT
: /* 0x4006 */
254 case S_MAGIC_FUSECTL
: /* 0x65735543 */
256 case S_MAGIC_HPFS
: /* 0xF995E849 */
258 case S_MAGIC_HUGETLBFS
: /* 0x958458f6 */
260 case S_MAGIC_ISOFS
: /* 0x9660 */
262 case S_MAGIC_ISOFS_R_WIN
: /* 0x4004 */
264 case S_MAGIC_ISOFS_WIN
: /* 0x4000 */
266 case S_MAGIC_JFFS2
: /* 0x72B6 */
268 case S_MAGIC_JFFS
: /* 0x07C0 */
270 case S_MAGIC_JFS
: /* 0x3153464A */
272 case S_MAGIC_MINIX
: /* 0x137F */
274 case S_MAGIC_MINIX_30
: /* 0x138F */
275 return "minix (30 char.)";
276 case S_MAGIC_MINIX_V2
: /* 0x2468 */
278 case S_MAGIC_MINIX_V2_30
: /* 0x2478 */
279 return "minix v2 (30 char.)";
280 case S_MAGIC_MSDOS
: /* 0x4D44 */
282 case S_MAGIC_NCP
: /* 0x564C */
284 case S_MAGIC_NFS
: /* 0x6969 */
286 case S_MAGIC_NFSD
: /* 0x6E667364 */
288 case S_MAGIC_NTFS
: /* 0x5346544E */
290 case S_MAGIC_OPENPROM
: /* 0x9fa1 */
292 case S_MAGIC_PROC
: /* 0x9FA0 */
294 case S_MAGIC_QNX4
: /* 0x002F */
296 case S_MAGIC_RAMFS
: /* 0x858458F6 */
298 case S_MAGIC_REISERFS
: /* 0x52654973 */
300 case S_MAGIC_ROMFS
: /* 0x7275 */
302 case S_MAGIC_SMB
: /* 0x517B */
304 case S_MAGIC_SQUASHFS
: /* 0x73717368 */
306 case S_MAGIC_SYSFS
: /* 0x62656572 */
308 case S_MAGIC_SYSV2
: /* 0x012FF7B6 */
310 case S_MAGIC_SYSV4
: /* 0x012FF7B5 */
312 case S_MAGIC_TMPFS
: /* 0x1021994 */
314 case S_MAGIC_UDF
: /* 0x15013346 */
316 case S_MAGIC_UFS
: /* 0x00011954 */
318 case S_MAGIC_UFS_BYTESWAPPED
: /* 0x54190100 */
320 case S_MAGIC_USBDEVFS
: /* 0x9FA2 */
322 case S_MAGIC_VXFS
: /* 0xA501FCF5 */
324 case S_MAGIC_XENIX
: /* 0x012FF7B4 */
326 case S_MAGIC_XFS
: /* 0x58465342 */
328 case S_MAGIC_XIAFS
: /* 0x012FD16D */
389 unsigned long int type
= statfsbuf
->f_type
;
390 static char buf
[sizeof "UNKNOWN (0x%lx)" - 3
391 + (sizeof type
* CHAR_BIT
+ 3) / 4];
392 sprintf (buf
, "UNKNOWN (0x%lx)", type
);
400 human_access (struct stat
const *statbuf
)
402 static char modebuf
[12];
403 filemodestring (statbuf
, modebuf
);
409 human_time (struct timespec t
)
411 static char str
[MAX (INT_BUFSIZE_BOUND (intmax_t),
412 (INT_STRLEN_BOUND (int) /* YYYY */
413 + 1 /* because YYYY might equal INT_MAX + 1900 */
414 + sizeof "-MM-DD HH:MM:SS.NNNNNNNNN +ZZZZ"))];
415 struct tm
const *tm
= localtime (&t
.tv_sec
);
417 return timetostr (t
.tv_sec
, str
);
418 nstrftime (str
, sizeof str
, "%Y-%m-%d %H:%M:%S.%N %z", tm
, 0, t
.tv_nsec
);
423 out_string (char *pformat
, size_t prefix_len
, char const *arg
)
425 strcpy (pformat
+ prefix_len
, "s");
426 printf (pformat
, arg
);
429 out_int (char *pformat
, size_t prefix_len
, intmax_t arg
)
431 strcpy (pformat
+ prefix_len
, PRIdMAX
);
432 printf (pformat
, arg
);
435 out_uint (char *pformat
, size_t prefix_len
, uintmax_t arg
)
437 strcpy (pformat
+ prefix_len
, PRIuMAX
);
438 printf (pformat
, arg
);
441 out_uint_o (char *pformat
, size_t prefix_len
, uintmax_t arg
)
443 strcpy (pformat
+ prefix_len
, PRIoMAX
);
444 printf (pformat
, arg
);
447 out_uint_x (char *pformat
, size_t prefix_len
, uintmax_t arg
)
449 strcpy (pformat
+ prefix_len
, PRIxMAX
);
450 printf (pformat
, arg
);
453 /* Very specialized function (modifies FORMAT), just so as to avoid
454 duplicating this code between both print_statfs and print_stat. */
456 out_file_context (char const *filename
, char *pformat
, size_t prefix_len
)
460 ? getfilecon (filename
, &scontext
)
461 : lgetfilecon (filename
, &scontext
)) < 0)
463 error (0, errno
, _("failed to get security context of %s"),
467 strcpy (pformat
+ prefix_len
, "s");
468 printf (pformat
, (scontext
? scontext
: "?"));
473 /* print statfs info */
475 print_statfs (char *pformat
, size_t prefix_len
, char m
, char const *filename
,
478 STRUCT_STATVFS
const *statfsbuf
= data
;
483 out_string (pformat
, prefix_len
, filename
);
488 #if STRUCT_STATXFS_F_FSID_IS_INTEGER
489 uintmax_t fsid
= statfsbuf
->f_fsid
;
491 typedef unsigned int fsid_word
;
492 verify (alignof (STRUCT_STATVFS
) % alignof (fsid_word
) == 0);
493 verify (offsetof (STRUCT_STATVFS
, f_fsid
) % alignof (fsid_word
) == 0);
494 verify (sizeof statfsbuf
->f_fsid
% alignof (fsid_word
) == 0);
495 fsid_word
const *p
= (fsid_word
*) &statfsbuf
->f_fsid
;
497 /* Assume a little-endian word order, as that is compatible
498 with glibc's statvfs implementation. */
500 int words
= sizeof statfsbuf
->f_fsid
/ sizeof *p
;
502 for (i
= 0; i
< words
&& i
* sizeof *p
< sizeof fsid
; i
++)
504 uintmax_t u
= p
[words
- 1 - i
];
505 fsid
|= u
<< (i
* CHAR_BIT
* sizeof *p
);
508 out_uint_x (pformat
, prefix_len
, fsid
);
513 OUT_NAMEMAX (pformat
, prefix_len
, SB_F_NAMEMAX (statfsbuf
));
516 #if HAVE_STRUCT_STATXFS_F_TYPE
517 out_uint_x (pformat
, prefix_len
, statfsbuf
->f_type
);
523 out_string (pformat
, prefix_len
, human_fstype (statfsbuf
));
526 out_int (pformat
, prefix_len
, statfsbuf
->f_blocks
);
529 out_int (pformat
, prefix_len
, statfsbuf
->f_bfree
);
532 out_int (pformat
, prefix_len
, statfsbuf
->f_bavail
);
535 out_uint (pformat
, prefix_len
, statfsbuf
->f_bsize
);
539 uintmax_t frsize
= STATFS_FRSIZE (statfsbuf
);
541 frsize
= statfsbuf
->f_bsize
;
542 out_uint (pformat
, prefix_len
, frsize
);
546 out_int (pformat
, prefix_len
, statfsbuf
->f_files
);
549 out_int (pformat
, prefix_len
, statfsbuf
->f_ffree
);
552 out_file_context (filename
, pformat
, prefix_len
);
560 /* print stat info */
562 print_stat (char *pformat
, size_t prefix_len
, char m
,
563 char const *filename
, void const *data
)
565 struct stat
*statbuf
= (struct stat
*) data
;
566 struct passwd
*pw_ent
;
567 struct group
*gw_ent
;
572 out_string (pformat
, prefix_len
, filename
);
575 out_string (pformat
, prefix_len
, quote (filename
));
576 if (S_ISLNK (statbuf
->st_mode
))
578 char *linkname
= areadlink_with_size (filename
, statbuf
->st_size
);
579 if (linkname
== NULL
)
581 error (0, errno
, _("cannot read symbolic link %s"),
586 out_string (pformat
, prefix_len
, quote (linkname
));
590 out_uint (pformat
, prefix_len
, statbuf
->st_dev
);
593 out_uint_x (pformat
, prefix_len
, statbuf
->st_dev
);
596 out_uint (pformat
, prefix_len
, statbuf
->st_ino
);
599 out_uint_o (pformat
, prefix_len
, statbuf
->st_mode
& CHMOD_MODE_BITS
);
602 out_string (pformat
, prefix_len
, human_access (statbuf
));
605 out_uint_x (pformat
, prefix_len
, statbuf
->st_mode
);
608 out_string (pformat
, prefix_len
, file_type (statbuf
));
611 out_uint (pformat
, prefix_len
, statbuf
->st_nlink
);
614 out_uint (pformat
, prefix_len
, statbuf
->st_uid
);
618 pw_ent
= getpwuid (statbuf
->st_uid
);
619 out_string (pformat
, prefix_len
,
620 pw_ent
? pw_ent
->pw_name
: "UNKNOWN");
623 out_uint (pformat
, prefix_len
, statbuf
->st_gid
);
627 gw_ent
= getgrgid (statbuf
->st_gid
);
628 out_string (pformat
, prefix_len
,
629 gw_ent
? gw_ent
->gr_name
: "UNKNOWN");
632 out_uint_x (pformat
, prefix_len
, major (statbuf
->st_rdev
));
635 out_uint_x (pformat
, prefix_len
, minor (statbuf
->st_rdev
));
638 out_uint (pformat
, prefix_len
, statbuf
->st_size
);
641 out_uint (pformat
, prefix_len
, ST_NBLOCKSIZE
);
644 out_uint (pformat
, prefix_len
, ST_NBLOCKS (*statbuf
));
647 out_uint (pformat
, prefix_len
, statbuf
->st_blksize
);
650 out_string (pformat
, prefix_len
, human_time (get_stat_atime (statbuf
)));
653 if (TYPE_SIGNED (time_t))
654 out_int (pformat
, prefix_len
, statbuf
->st_atime
);
656 out_uint (pformat
, prefix_len
, statbuf
->st_atime
);
659 out_string (pformat
, prefix_len
, human_time (get_stat_mtime (statbuf
)));
662 if (TYPE_SIGNED (time_t))
663 out_int (pformat
, prefix_len
, statbuf
->st_mtime
);
665 out_uint (pformat
, prefix_len
, statbuf
->st_mtime
);
668 out_string (pformat
, prefix_len
, human_time (get_stat_ctime (statbuf
)));
671 if (TYPE_SIGNED (time_t))
672 out_int (pformat
, prefix_len
, statbuf
->st_ctime
);
674 out_uint (pformat
, prefix_len
, statbuf
->st_ctime
);
677 out_file_context (filename
, pformat
, prefix_len
);
685 /* Output a single-character \ escape. */
688 print_esc_char (char c
)
692 case 'a': /* Alert. */
695 case 'b': /* Backspace. */
698 case 'f': /* Form feed. */
701 case 'n': /* New line. */
704 case 'r': /* Carriage return. */
707 case 't': /* Horizontal tab. */
710 case 'v': /* Vertical tab. */
717 error (0, 0, _("warning: unrecognized escape `\\%c'"), c
);
724 print_it (char const *format
, char const *filename
,
725 void (*print_func
) (char *, size_t, char, char const *, void const *),
728 /* Add 2 to accommodate our conversion of the stat `%s' format string
729 to the longer printf `%llu' one. */
732 MAX_ADDITIONAL_BYTES
=
733 (MAX (sizeof PRIdMAX
,
734 MAX (sizeof PRIoMAX
, MAX (sizeof PRIuMAX
, sizeof PRIxMAX
)))
737 size_t n_alloc
= strlen (format
) + MAX_ADDITIONAL_BYTES
+ 1;
738 char *dest
= xmalloc (n_alloc
);
740 for (b
= format
; *b
; b
++)
746 size_t len
= strspn (b
+ 1, "#-+.I 0123456789");
747 char const *fmt_char
= b
+ len
+ 1;
748 memcpy (dest
, b
, len
+ 1);
759 dest
[len
+ 1] = *fmt_char
;
760 dest
[len
+ 2] = '\0';
761 error (EXIT_FAILURE
, 0, _("%s: invalid directive"),
762 quotearg_colon (dest
));
767 print_func (dest
, len
+ 1, *fmt_char
, filename
, data
);
774 if ( ! interpret_backslash_escapes
)
782 int esc_value
= octtobin (*b
);
783 int esc_length
= 1; /* number of octal digits */
784 for (++b
; esc_length
< 3 && isodigit (*b
);
787 esc_value
= esc_value
* 8 + octtobin (*b
);
792 else if (*b
== 'x' && isxdigit (to_uchar (b
[1])))
794 int esc_value
= hextobin (b
[1]); /* Value of \xhh escape. */
795 /* A hexadecimal \xhh escape sequence must have
796 1 or 2 hex. digits. */
798 if (isxdigit (to_uchar (b
[1])))
801 esc_value
= esc_value
* 16 + hextobin (*b
);
807 error (0, 0, _("warning: backslash at end of format"));
809 /* Arrange to exit the loop. */
825 fputs (trailing_delim
, stdout
);
828 /* Stat the file system and print what we find. */
830 do_statfs (char const *filename
, bool terse
, char const *format
)
832 STRUCT_STATVFS statfsbuf
;
834 if (STATFS (filename
, &statfsbuf
) != 0)
836 error (0, errno
, _("cannot read file system information for %s"),
844 ? "%n %i %l %t %s %S %b %f %a %c %d\n"
846 " ID: %-8i Namelen: %-7l Type: %T\n"
847 "Block size: %-10s Fundamental block size: %S\n"
848 "Blocks: Total: %-10b Free: %-10f Available: %a\n"
849 "Inodes: Total: %-10c Free: %d\n");
852 print_it (format
, filename
, print_statfs
, &statfsbuf
);
856 /* stat the file and print what we find */
858 do_stat (char const *filename
, bool terse
, char const *format
)
862 if ((follow_links
? stat
: lstat
) (filename
, &statbuf
) != 0)
864 error (0, errno
, _("cannot stat %s"), quote (filename
));
872 format
= "%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %o\n";
876 /* Temporary hack to match original output until conditional
878 if (S_ISBLK (statbuf
.st_mode
) || S_ISCHR (statbuf
.st_mode
))
882 " Size: %-10s\tBlocks: %-10b IO Block: %-6o %F\n"
883 "Device: %Dh/%dd\tInode: %-10i Links: %-5h"
884 " Device type: %t,%T\n"
885 "Access: (%04a/%10.10A) Uid: (%5u/%8U) Gid: (%5g/%8G)\n"
886 "Access: %x\n" "Modify: %y\n" "Change: %z\n";
892 " Size: %-10s\tBlocks: %-10b IO Block: %-6o %F\n"
893 "Device: %Dh/%dd\tInode: %-10i Links: %h\n"
894 "Access: (%04a/%10.10A) Uid: (%5u/%8U) Gid: (%5g/%8G)\n"
895 "Access: %x\n" "Modify: %y\n" "Change: %z\n";
899 print_it (format
, filename
, print_stat
, &statbuf
);
906 if (status
!= EXIT_SUCCESS
)
907 fprintf (stderr
, _("Try `%s --help' for more information.\n"),
911 printf (_("Usage: %s [OPTION]... FILE...\n"), program_name
);
913 Display file or file system status.\n\
915 -L, --dereference follow links\n\
916 -f, --file-system display file system status instead of file status\n\
919 -c --format=FORMAT use the specified FORMAT instead of the default;\n\
920 output a newline after each use of FORMAT\n\
921 --printf=FORMAT like --format, but interpret backslash escapes,\n\
922 and do not output a mandatory trailing newline.\n\
923 If you want a newline, include \\n in FORMAT.\n\
924 -t, --terse print the information in terse form\n\
926 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
927 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
930 The valid format sequences for files (without --file-system):\n\
932 %a Access rights in octal\n\
933 %A Access rights in human readable form\n\
934 %b Number of blocks allocated (see %B)\n\
935 %B The size in bytes of each block reported by %b\n\
936 %C SELinux security context string\n\
939 %d Device number in decimal\n\
940 %D Device number in hex\n\
941 %f Raw mode in hex\n\
943 %g Group ID of owner\n\
944 %G Group name of owner\n\
947 %h Number of hard links\n\
950 %N Quoted file name with dereference if symbolic link\n\
952 %s Total size, in bytes\n\
953 %t Major device type in hex\n\
954 %T Minor device type in hex\n\
957 %u User ID of owner\n\
958 %U User name of owner\n\
959 %x Time of last access\n\
960 %X Time of last access as seconds since Epoch\n\
961 %y Time of last modification\n\
962 %Y Time of last modification as seconds since Epoch\n\
963 %z Time of last change\n\
964 %Z Time of last change as seconds since Epoch\n\
969 Valid format sequences for file systems:\n\
971 %a Free blocks available to non-superuser\n\
972 %b Total data blocks in file system\n\
973 %c Total file nodes in file system\n\
974 %d Free file nodes in file system\n\
975 %f Free blocks in file system\n\
976 %C SELinux security context string\n\
979 %i File System ID in hex\n\
980 %l Maximum length of filenames\n\
982 %s Block size (for faster transfers)\n\
983 %S Fundamental block size (for block counts)\n\
985 %T Type in human readable form\n\
987 printf (USAGE_BUILTIN_WARNING
, PROGRAM_NAME
);
988 emit_bug_reporting_address ();
994 main (int argc
, char *argv
[])
1000 char *format
= NULL
;
1003 initialize_main (&argc
, &argv
);
1004 set_program_name (argv
[0]);
1005 setlocale (LC_ALL
, "");
1006 bindtextdomain (PACKAGE
, LOCALEDIR
);
1007 textdomain (PACKAGE
);
1009 atexit (close_stdout
);
1011 while ((c
= getopt_long (argc
, argv
, "c:fLtZ", long_options
, NULL
)) != -1)
1017 interpret_backslash_escapes
= true;
1018 trailing_delim
= "";
1023 interpret_backslash_escapes
= false;
1024 trailing_delim
= "\n";
1028 follow_links
= true;
1039 case 'Z': /* FIXME: remove in 2010 */
1040 /* Ignore, for compatibility with distributions
1041 that implemented this before upstream.
1042 But warn of impending removal. */
1044 _("the --context (-Z) option is obsolete and will be removed\n"
1045 "in a future release"));
1048 case_GETOPT_HELP_CHAR
;
1050 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
1053 usage (EXIT_FAILURE
);
1059 error (0, 0, _("missing operand"));
1060 usage (EXIT_FAILURE
);
1063 for (i
= optind
; i
< argc
; i
++)
1065 ? do_statfs (argv
[i
], terse
, format
)
1066 : do_stat (argv
[i
], terse
, format
));
1068 exit (ok
? EXIT_SUCCESS
: EXIT_FAILURE
);