1 /* stat.c -- display file or file system status
2 Copyright (C) 2001-2012 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. */
23 #if ((STAT_STATVFS || STAT_STATVFS64) \
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
34 #include <sys/types.h>
38 # include <sys/statvfs.h>
41 #elif HAVE_SYS_MOUNT_H && HAVE_SYS_PARAM_H
42 /* NOTE: freebsd5.0 needs sys/param.h and sys/mount.h for statfs.
43 It does have statvfs.h, but shouldn't use it, since it doesn't
44 HAVE_STRUCT_STATVFS_F_BASETYPE. So find a clean way to fix it. */
45 /* NetBSD 1.5.2 needs these, for the declaration of struct statfs. */
46 # include <sys/param.h>
47 # include <sys/mount.h>
48 # if HAVE_NFS_NFS_CLNT_H && HAVE_NFS_VFS_H
49 /* Ultrix 4.4 needs these for the declaration of struct statfs. */
50 # include <netinet/in.h>
51 # include <nfs/nfs_clnt.h>
54 #elif HAVE_OS_H /* BeOS */
57 #include <selinux/selinux.h>
61 #include "areadlink.h"
63 #include "file-type.h"
67 #include "mountlist.h"
70 #include "stat-size.h"
71 #include "stat-time.h"
73 #include "find-mount-point.h"
74 #include "xvasprintf.h"
77 # define STRUCT_STATVFS struct statvfs
78 # define STRUCT_STATXFS_F_FSID_IS_INTEGER STRUCT_STATVFS_F_FSID_IS_INTEGER
79 # define HAVE_STRUCT_STATXFS_F_TYPE HAVE_STRUCT_STATVFS_F_TYPE
80 # if HAVE_STRUCT_STATVFS_F_NAMEMAX
81 # define SB_F_NAMEMAX(S) ((S)->f_namemax)
83 # if ! STAT_STATVFS && STAT_STATVFS64
84 # define STATFS statvfs64
86 # define STATFS statvfs
88 # define STATFS_FRSIZE(S) ((S)->f_frsize)
90 # define HAVE_STRUCT_STATXFS_F_TYPE HAVE_STRUCT_STATFS_F_TYPE
91 # if HAVE_STRUCT_STATFS_F_NAMELEN
92 # define SB_F_NAMEMAX(S) ((S)->f_namelen)
94 # define STATFS statfs
95 # if HAVE_OS_H /* BeOS */
96 /* BeOS has a statvfs function, but it does not return sensible values
97 for f_files, f_ffree and f_favail, and lacks f_type, f_basetype and
98 f_fstypename. Use 'struct fs_info' instead. */
99 static int ATTRIBUTE_WARN_UNUSED_RESULT
100 statfs (char const *filename
, struct fs_info
*buf
)
102 dev_t device
= dev_for_path (filename
);
105 errno
= (device
== B_ENTRY_NOT_FOUND
? ENOENT
106 : device
== B_BAD_VALUE
? EINVAL
107 : device
== B_NAME_TOO_LONG
? ENAMETOOLONG
108 : device
== B_NO_MEMORY
? ENOMEM
109 : device
== B_FILE_ERROR
? EIO
113 /* If successful, buf->dev will be == device. */
114 return fs_stat_dev (device
, buf
);
117 # define f_blocks total_blocks
118 # define f_bfree free_blocks
119 # define f_bavail free_blocks
120 # define f_bsize io_size
121 # define f_files total_nodes
122 # define f_ffree free_nodes
123 # define STRUCT_STATVFS struct fs_info
124 # define STRUCT_STATXFS_F_FSID_IS_INTEGER true
125 # define STATFS_FRSIZE(S) ((S)->block_size)
127 # define STRUCT_STATVFS struct statfs
128 # define STRUCT_STATXFS_F_FSID_IS_INTEGER STRUCT_STATFS_F_FSID_IS_INTEGER
129 # if HAVE_STRUCT_STATFS_F_FRSIZE
130 # define STATFS_FRSIZE(S) ((S)->f_frsize)
132 # define STATFS_FRSIZE(S) 0
138 # define OUT_NAMEMAX out_uint
140 /* NetBSD 1.5.2 has neither f_namemax nor f_namelen. */
141 # define SB_F_NAMEMAX(S) "*"
142 # define OUT_NAMEMAX out_string
145 #if HAVE_STRUCT_STATVFS_F_BASETYPE
146 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME f_basetype
148 # if HAVE_STRUCT_STATVFS_F_FSTYPENAME || HAVE_STRUCT_STATFS_F_FSTYPENAME
149 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME f_fstypename
150 # elif HAVE_OS_H /* BeOS */
151 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME fsh_name
155 /* FIXME: these are used by printf.c, too */
156 #define isodigit(c) ('0' <= (c) && (c) <= '7')
157 #define octtobin(c) ((c) - '0')
158 #define hextobin(c) ((c) >= 'a' && (c) <= 'f' ? (c) - 'a' + 10 : \
159 (c) >= 'A' && (c) <= 'F' ? (c) - 'A' + 10 : (c) - '0')
161 static char const digits
[] = "0123456789";
163 /* Flags that are portable for use in printf, for at least one
164 conversion specifier; make_format removes unportable flags as
165 needed for particular specifiers. The glibc 2.2 extension "I" is
166 listed here; it is removed by make_format because it has undefined
167 behavior elsewhere and because it is incompatible with
169 static char const printf_flags
[] = "'-+ #0I";
171 #define PROGRAM_NAME "stat"
173 #define AUTHORS proper_name ("Michael Meskes")
177 PRINTF_OPTION
= CHAR_MAX
+ 1
180 static struct option
const long_options
[] =
182 {"context", no_argument
, 0, 'Z'},
183 {"dereference", no_argument
, NULL
, 'L'},
184 {"file-system", no_argument
, NULL
, 'f'},
185 {"format", required_argument
, NULL
, 'c'},
186 {"printf", required_argument
, NULL
, PRINTF_OPTION
},
187 {"terse", no_argument
, NULL
, 't'},
188 {GETOPT_HELP_OPTION_DECL
},
189 {GETOPT_VERSION_OPTION_DECL
},
193 /* Whether to follow symbolic links; True for --dereference (-L). */
194 static bool follow_links
;
196 /* Whether to interpret backslash-escape sequences.
197 True for --printf=FMT, not for --format=FMT (-c). */
198 static bool interpret_backslash_escapes
;
200 /* The trailing delimiter string:
201 "" for --printf=FMT, "\n" for --format=FMT (-c). */
202 static char const *trailing_delim
= "";
204 /* The representation of the decimal point in the current locale. */
205 static char const *decimal_point
;
206 static size_t decimal_point_len
;
208 /* Return the type of the specified file system.
209 Some systems have statfvs.f_basetype[FSTYPSZ] (AIX, HP-UX, and Solaris).
210 Others have statvfs.f_fstypename[_VFS_NAMELEN] (NetBSD 3.0).
211 Others have statfs.f_fstypename[MFSNAMELEN] (NetBSD 1.5.2).
212 Still others have neither and have to get by with f_type (GNU/Linux).
213 But f_type may only exist in statfs (Cygwin). */
214 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
215 human_fstype (STRUCT_STATVFS
const *statfsbuf
)
217 #ifdef STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
218 return statfsbuf
->STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
;
220 switch (statfsbuf
->f_type
)
222 # if defined __linux__
224 /* Compare with what's in libc:
225 f=/a/libc/sysdeps/unix/sysv/linux/linux_fsinfo.h
226 sed -n '/ADFS_SUPER_MAGIC/,/SYSFS_MAGIC/p' $f \
227 | perl -n -e '/#define (.*?)_(?:SUPER_)MAGIC\s+0x(\S+)/' \
228 -e 'and print "case S_MAGIC_$1: /\* 0x" . uc($2) . " *\/\n"' \
230 perl -ne '/^\s+(case S_MAGIC_.*?): \/\* 0x(\S+) \*\//' \
231 -e 'and do { $v=uc$2; print "$1: /\* 0x$v *\/\n"}' stat.c \
233 diff -u sym_stat sym_libc
236 /* Also compare with the list in "man 2 statfs" using the
237 fs-magic-compare make target. */
239 /* IMPORTANT NOTE: Each of the following 'case S_MAGIC_...:'
240 statements must be followed by a hexadecimal constant in
241 a comment. The S_MAGIC_... name and constant are automatically
242 combined to produce the #define directives in fs.h. */
244 case S_MAGIC_ADFS
: /* 0xADF5 local */
246 case S_MAGIC_AFFS
: /* 0xADFF local */
248 case S_MAGIC_AFS
: /* 0x5346414F remote */
250 case S_MAGIC_ANON_INODE_FS
: /* 0x09041934 local */
251 return "anon-inode FS";
252 case S_MAGIC_AUFS
: /* 0x61756673 remote */
253 /* FIXME: change syntax or add an optional attribute like "inotify:no".
254 The above is labeled as "remote" so that tail always uses polling,
255 but this isn't really a remote file system type. */
257 case S_MAGIC_AUTOFS
: /* 0x0187 local */
259 case S_MAGIC_BEFS
: /* 0x42465331 local */
261 case S_MAGIC_BDEVFS
: /* 0x62646576 local */
263 case S_MAGIC_BFS
: /* 0x1BADFACE local */
265 case S_MAGIC_BINFMTFS
: /* 0x42494E4D local */
266 return "binfmt_misc";
267 case S_MAGIC_BTRFS
: /* 0x9123683E local */
269 case S_MAGIC_CGROUP
: /* 0x0027E0EB local */
271 case S_MAGIC_CIFS
: /* 0xFF534D42 remote */
273 case S_MAGIC_CODA
: /* 0x73757245 remote */
275 case S_MAGIC_COH
: /* 0x012FF7B7 local */
277 case S_MAGIC_CRAMFS
: /* 0x28CD3D45 local */
279 case S_MAGIC_CRAMFS_WEND
: /* 0x453DCD28 local */
280 return "cramfs-wend";
281 case S_MAGIC_DEBUGFS
: /* 0x64626720 local */
283 case S_MAGIC_DEVFS
: /* 0x1373 local */
285 case S_MAGIC_DEVPTS
: /* 0x1CD1 local */
287 case S_MAGIC_ECRYPTFS
: /* 0xF15F local */
289 case S_MAGIC_EFS
: /* 0x00414A53 local */
291 case S_MAGIC_EXT
: /* 0x137D local */
293 case S_MAGIC_EXT2
: /* 0xEF53 local */
295 case S_MAGIC_EXT2_OLD
: /* 0xEF51 local */
297 case S_MAGIC_FAT
: /* 0x4006 local */
299 case S_MAGIC_FHGFS
: /* 0x19830326 remote */
301 case S_MAGIC_FUSEBLK
: /* 0x65735546 remote */
303 case S_MAGIC_FUSECTL
: /* 0x65735543 remote */
305 case S_MAGIC_FUTEXFS
: /* 0x0BAD1DEA local */
307 case S_MAGIC_GFS
: /* 0x1161970 remote */
309 case S_MAGIC_GPFS
: /* 0x47504653 remote */
311 case S_MAGIC_HFS
: /* 0x4244 local */
313 case S_MAGIC_HPFS
: /* 0xF995E849 local */
315 case S_MAGIC_HUGETLBFS
: /* 0x958458F6 local */
317 case S_MAGIC_MTD_INODE_FS
: /* 0x11307854 local */
319 case S_MAGIC_INOTIFYFS
: /* 0x2BAD1DEA local */
321 case S_MAGIC_ISOFS
: /* 0x9660 local */
323 case S_MAGIC_ISOFS_R_WIN
: /* 0x4004 local */
325 case S_MAGIC_ISOFS_WIN
: /* 0x4000 local */
327 case S_MAGIC_JFFS
: /* 0x07C0 local */
329 case S_MAGIC_JFFS2
: /* 0x72B6 local */
331 case S_MAGIC_JFS
: /* 0x3153464A local */
333 case S_MAGIC_KAFS
: /* 0x6B414653 remote */
335 case S_MAGIC_LUSTRE
: /* 0x0BD00BD0 remote */
337 case S_MAGIC_MINIX
: /* 0x137F local */
339 case S_MAGIC_MINIX_30
: /* 0x138F local */
340 return "minix (30 char.)";
341 case S_MAGIC_MINIX_V2
: /* 0x2468 local */
343 case S_MAGIC_MINIX_V2_30
: /* 0x2478 local */
344 return "minix v2 (30 char.)";
345 case S_MAGIC_MINIX_V3
: /* 0x4D5A local */
347 case S_MAGIC_MQUEUE
: /* 0x19800202 local */
349 case S_MAGIC_MSDOS
: /* 0x4D44 local */
351 case S_MAGIC_NCP
: /* 0x564C remote */
353 case S_MAGIC_NFS
: /* 0x6969 remote */
355 case S_MAGIC_NFSD
: /* 0x6E667364 remote */
357 case S_MAGIC_NILFS
: /* 0x3434 local */
359 case S_MAGIC_NTFS
: /* 0x5346544E local */
361 case S_MAGIC_OPENPROM
: /* 0x9FA1 local */
363 case S_MAGIC_OCFS2
: /* 0x7461636f remote */
365 case S_MAGIC_PANFS
: /* 0xAAD7AAEA remote */
367 case S_MAGIC_PIPEFS
: /* 0x50495045 remote */
368 /* FIXME: change syntax or add an optional attribute like "inotify:no".
369 The above is labeled as "remote" so that tail always uses polling,
370 but this isn't really a remote file system type. */
372 case S_MAGIC_PROC
: /* 0x9FA0 local */
374 case S_MAGIC_PSTOREFS
: /* 0x6165676C local */
376 case S_MAGIC_QNX4
: /* 0x002F local */
378 case S_MAGIC_QNX6
: /* 0x68191122 local */
380 case S_MAGIC_RAMFS
: /* 0x858458F6 local */
382 case S_MAGIC_REISERFS
: /* 0x52654973 local */
384 case S_MAGIC_ROMFS
: /* 0x7275 local */
386 case S_MAGIC_RPC_PIPEFS
: /* 0x67596969 local */
388 case S_MAGIC_SECURITYFS
: /* 0x73636673 local */
390 case S_MAGIC_SELINUX
: /* 0xF97CFF8C local */
392 case S_MAGIC_SMB
: /* 0x517B remote */
394 case S_MAGIC_SOCKFS
: /* 0x534F434B local */
396 case S_MAGIC_SQUASHFS
: /* 0x73717368 local */
398 case S_MAGIC_SYSFS
: /* 0x62656572 local */
400 case S_MAGIC_SYSV2
: /* 0x012FF7B6 local */
402 case S_MAGIC_SYSV4
: /* 0x012FF7B5 local */
404 case S_MAGIC_TMPFS
: /* 0x01021994 local */
406 case S_MAGIC_UDF
: /* 0x15013346 local */
408 case S_MAGIC_UFS
: /* 0x00011954 local */
410 case S_MAGIC_UFS_BYTESWAPPED
: /* 0x54190100 local */
412 case S_MAGIC_USBDEVFS
: /* 0x9FA2 local */
414 case S_MAGIC_V9FS
: /* 0x01021997 local */
416 case S_MAGIC_VMHGFS
: /* 0xBACBACBC remote */
418 case S_MAGIC_VXFS
: /* 0xA501FCF5 local */
420 case S_MAGIC_VZFS
: /* 0x565A4653 local */
422 case S_MAGIC_XENFS
: /* 0xABBA1974 local */
424 case S_MAGIC_XENIX
: /* 0x012FF7B4 local */
426 case S_MAGIC_XFS
: /* 0x58465342 local */
428 case S_MAGIC_XIAFS
: /* 0x012FD16D local */
430 case S_MAGIC_ZFS
: /* 0x2FC12FC1 local */
491 unsigned long int type
= statfsbuf
->f_type
;
492 static char buf
[sizeof "UNKNOWN (0x%lx)" - 3
493 + (sizeof type
* CHAR_BIT
+ 3) / 4];
494 sprintf (buf
, "UNKNOWN (0x%lx)", type
);
501 static char * ATTRIBUTE_WARN_UNUSED_RESULT
502 human_access (struct stat
const *statbuf
)
504 static char modebuf
[12];
505 filemodestring (statbuf
, modebuf
);
510 static char * ATTRIBUTE_WARN_UNUSED_RESULT
511 human_time (struct timespec t
)
513 static char str
[MAX (INT_BUFSIZE_BOUND (intmax_t),
514 (INT_STRLEN_BOUND (int) /* YYYY */
515 + 1 /* because YYYY might equal INT_MAX + 1900 */
516 + sizeof "-MM-DD HH:MM:SS.NNNNNNNNN +ZZZZ"))];
517 struct tm
const *tm
= localtime (&t
.tv_sec
);
519 return timetostr (t
.tv_sec
, str
);
520 nstrftime (str
, sizeof str
, "%Y-%m-%d %H:%M:%S.%N %z", tm
, 0, t
.tv_nsec
);
524 /* PFORMAT points to a '%' followed by a prefix of a format, all of
525 size PREFIX_LEN. The flags allowed for this format are
526 ALLOWED_FLAGS; remove other printf flags from the prefix, then
529 make_format (char *pformat
, size_t prefix_len
, char const *allowed_flags
,
532 char *dst
= pformat
+ 1;
534 char const *srclim
= pformat
+ prefix_len
;
535 for (src
= dst
; src
< srclim
&& strchr (printf_flags
, *src
); src
++)
536 if (strchr (allowed_flags
, *src
))
540 strcpy (dst
, suffix
);
544 out_string (char *pformat
, size_t prefix_len
, char const *arg
)
546 make_format (pformat
, prefix_len
, "-", "s");
547 printf (pformat
, arg
);
550 out_int (char *pformat
, size_t prefix_len
, intmax_t arg
)
552 make_format (pformat
, prefix_len
, "'-+ 0", PRIdMAX
);
553 return printf (pformat
, arg
);
556 out_uint (char *pformat
, size_t prefix_len
, uintmax_t arg
)
558 make_format (pformat
, prefix_len
, "'-0", PRIuMAX
);
559 return printf (pformat
, arg
);
562 out_uint_o (char *pformat
, size_t prefix_len
, uintmax_t arg
)
564 make_format (pformat
, prefix_len
, "-#0", PRIoMAX
);
565 printf (pformat
, arg
);
568 out_uint_x (char *pformat
, size_t prefix_len
, uintmax_t arg
)
570 make_format (pformat
, prefix_len
, "-#0", PRIxMAX
);
571 printf (pformat
, arg
);
574 out_minus_zero (char *pformat
, size_t prefix_len
)
576 make_format (pformat
, prefix_len
, "'-+ 0", ".0f");
577 return printf (pformat
, -0.25);
580 /* Output the number of seconds since the Epoch, using a format that
581 acts like printf's %f format. */
583 out_epoch_sec (char *pformat
, size_t prefix_len
,
584 struct stat
const *statbuf ATTRIBUTE_UNUSED
,
587 char *dot
= memchr (pformat
, '.', prefix_len
);
588 size_t sec_prefix_len
= prefix_len
;
591 bool frac_left_adjust
= false;
595 sec_prefix_len
= dot
- pformat
;
596 pformat
[prefix_len
] = '\0';
598 if (ISDIGIT (dot
[1]))
600 long int lprec
= strtol (dot
+ 1, NULL
, 10);
601 precision
= (lprec
<= INT_MAX
? lprec
: INT_MAX
);
608 if (precision
&& ISDIGIT (dot
[-1]))
610 /* If a nontrivial width is given, subtract the width of the
611 decimal point and PRECISION digits that will be output
618 while (ISDIGIT (p
[-1]));
620 long int lwidth
= strtol (p
, NULL
, 10);
621 width
= (lwidth
<= INT_MAX
? lwidth
: INT_MAX
);
625 sec_prefix_len
= p
- pformat
;
626 int w_d
= (decimal_point_len
< width
627 ? width
- decimal_point_len
631 int w
= w_d
- precision
;
635 for (char const *src
= dst
; src
< p
; src
++)
638 frac_left_adjust
= true;
644 + (frac_left_adjust
? 0 : sprintf (dst
, "%d", w
)));
652 for (int i
= precision
; i
< 9; i
++)
654 int frac_sec
= arg
.tv_nsec
/ divisor
;
657 if (TYPE_SIGNED (time_t))
659 bool minus_zero
= false;
660 if (arg
.tv_sec
< 0 && arg
.tv_nsec
!= 0)
662 int frac_sec_modulus
= 1000000000 / divisor
;
663 frac_sec
= (frac_sec_modulus
- frac_sec
664 - (arg
.tv_nsec
% divisor
!= 0));
665 arg
.tv_sec
+= (frac_sec
!= 0);
666 minus_zero
= (arg
.tv_sec
== 0);
668 int_len
= (minus_zero
669 ? out_minus_zero (pformat
, sec_prefix_len
)
670 : out_int (pformat
, sec_prefix_len
, arg
.tv_sec
));
673 int_len
= out_uint (pformat
, sec_prefix_len
, arg
.tv_sec
);
677 int prec
= (precision
< 9 ? precision
: 9);
678 int trailing_prec
= precision
- prec
;
679 int ilen
= (int_len
< 0 ? 0 : int_len
);
680 int trailing_width
= (ilen
< width
&& decimal_point_len
< width
- ilen
681 ? width
- ilen
- decimal_point_len
- prec
683 printf ("%s%.*d%-*.*d", decimal_point
, prec
, frac_sec
,
684 trailing_width
, trailing_prec
, 0);
688 /* Print the context information of FILENAME, and return true iff the
689 context could not be obtained. */
690 static bool ATTRIBUTE_WARN_UNUSED_RESULT
691 out_file_context (char *pformat
, size_t prefix_len
, char const *filename
)
697 ? getfilecon (filename
, &scontext
)
698 : lgetfilecon (filename
, &scontext
)) < 0)
700 error (0, errno
, _("failed to get security context of %s"),
705 strcpy (pformat
+ prefix_len
, "s");
706 printf (pformat
, (scontext
? scontext
: "?"));
712 /* Print statfs info. Return zero upon success, nonzero upon failure. */
713 static bool ATTRIBUTE_WARN_UNUSED_RESULT
714 print_statfs (char *pformat
, size_t prefix_len
, unsigned int m
,
715 char const *filename
,
718 STRUCT_STATVFS
const *statfsbuf
= data
;
724 out_string (pformat
, prefix_len
, filename
);
729 #if STRUCT_STATXFS_F_FSID_IS_INTEGER
730 uintmax_t fsid
= statfsbuf
->f_fsid
;
732 typedef unsigned int fsid_word
;
733 verify (alignof (STRUCT_STATVFS
) % alignof (fsid_word
) == 0);
734 verify (offsetof (STRUCT_STATVFS
, f_fsid
) % alignof (fsid_word
) == 0);
735 verify (sizeof statfsbuf
->f_fsid
% alignof (fsid_word
) == 0);
736 fsid_word
const *p
= (fsid_word
*) &statfsbuf
->f_fsid
;
738 /* Assume a little-endian word order, as that is compatible
739 with glibc's statvfs implementation. */
741 int words
= sizeof statfsbuf
->f_fsid
/ sizeof *p
;
743 for (i
= 0; i
< words
&& i
* sizeof *p
< sizeof fsid
; i
++)
745 uintmax_t u
= p
[words
- 1 - i
];
746 fsid
|= u
<< (i
* CHAR_BIT
* sizeof *p
);
749 out_uint_x (pformat
, prefix_len
, fsid
);
754 OUT_NAMEMAX (pformat
, prefix_len
, SB_F_NAMEMAX (statfsbuf
));
757 #if HAVE_STRUCT_STATXFS_F_TYPE
758 out_uint_x (pformat
, prefix_len
, statfsbuf
->f_type
);
764 out_string (pformat
, prefix_len
, human_fstype (statfsbuf
));
767 out_int (pformat
, prefix_len
, statfsbuf
->f_blocks
);
770 out_int (pformat
, prefix_len
, statfsbuf
->f_bfree
);
773 out_int (pformat
, prefix_len
, statfsbuf
->f_bavail
);
776 out_uint (pformat
, prefix_len
, statfsbuf
->f_bsize
);
780 uintmax_t frsize
= STATFS_FRSIZE (statfsbuf
);
782 frsize
= statfsbuf
->f_bsize
;
783 out_uint (pformat
, prefix_len
, frsize
);
787 out_uint (pformat
, prefix_len
, statfsbuf
->f_files
);
790 out_int (pformat
, prefix_len
, statfsbuf
->f_ffree
);
799 /* Return any bind mounted source for a path.
800 The caller should not free the returned buffer.
801 Return NULL if no bind mount found. */
802 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
803 find_bind_mount (char const * name
)
805 char const * bind_mount
= NULL
;
807 static struct mount_entry
*mount_list
;
808 static bool tried_mount_list
= false;
809 if (!tried_mount_list
) /* attempt/warn once per process. */
811 if (!(mount_list
= read_file_system_list (false)))
812 error (0, errno
, "%s", _("cannot read table of mounted file systems"));
813 tried_mount_list
= true;
816 struct mount_entry
*me
;
817 for (me
= mount_list
; me
; me
= me
->me_next
)
819 if (me
->me_dummy
&& me
->me_devname
[0] == '/'
820 && STREQ (me
->me_mountdir
, name
))
822 struct stat name_stats
;
823 struct stat dev_stats
;
825 if (stat (name
, &name_stats
) == 0
826 && stat (me
->me_devname
, &dev_stats
) == 0
827 && SAME_INODE (name_stats
, dev_stats
))
829 bind_mount
= me
->me_devname
;
838 /* Print mount point. Return zero upon success, nonzero upon failure. */
839 static bool ATTRIBUTE_WARN_UNUSED_RESULT
840 out_mount_point (char const *filename
, char *pformat
, size_t prefix_len
,
841 const struct stat
*statp
)
844 char const *np
= "?", *bp
= NULL
;
848 /* Look for bind mounts first. Note we output the immediate alias,
849 rather than further resolving to a base device mount point. */
850 if (follow_links
|| !S_ISLNK (statp
->st_mode
))
852 char *resolved
= canonicalize_file_name (filename
);
855 error (0, errno
, _("failed to canonicalize %s"), quote (filename
));
856 goto print_mount_point
;
858 bp
= find_bind_mount (resolved
);
863 goto print_mount_point
;
867 /* If there is no direct bind mount, then navigate
868 back up the tree looking for a device change.
869 Note we don't detect if any of the directory components
870 are bind mounted to the same device, but that's OK
871 since we've not directly queried them. */
872 if ((mp
= find_mount_point (filename
, statp
)))
874 /* This dir might be bind mounted to another device,
875 so we resolve the bound source in that case also. */
876 bp
= find_bind_mount (mp
);
882 out_string (pformat
, prefix_len
, bp
? bp
: mp
? mp
: np
);
887 /* Map a TS with negative TS.tv_nsec to {0,0}. */
888 static inline struct timespec
889 neg_to_zero (struct timespec ts
)
893 struct timespec z
= {0, 0};
897 /* Print stat info. Return zero upon success, nonzero upon failure. */
899 print_stat (char *pformat
, size_t prefix_len
, unsigned int m
,
900 char const *filename
, void const *data
)
902 struct stat
*statbuf
= (struct stat
*) data
;
903 struct passwd
*pw_ent
;
904 struct group
*gw_ent
;
910 out_string (pformat
, prefix_len
, filename
);
913 out_string (pformat
, prefix_len
, quote (filename
));
914 if (S_ISLNK (statbuf
->st_mode
))
916 char *linkname
= areadlink_with_size (filename
, statbuf
->st_size
);
917 if (linkname
== NULL
)
919 error (0, errno
, _("cannot read symbolic link %s"),
924 out_string (pformat
, prefix_len
, quote (linkname
));
929 out_uint (pformat
, prefix_len
, statbuf
->st_dev
);
932 out_uint_x (pformat
, prefix_len
, statbuf
->st_dev
);
935 out_uint (pformat
, prefix_len
, statbuf
->st_ino
);
938 out_uint_o (pformat
, prefix_len
, statbuf
->st_mode
& CHMOD_MODE_BITS
);
941 out_string (pformat
, prefix_len
, human_access (statbuf
));
944 out_uint_x (pformat
, prefix_len
, statbuf
->st_mode
);
947 out_string (pformat
, prefix_len
, file_type (statbuf
));
950 out_uint (pformat
, prefix_len
, statbuf
->st_nlink
);
953 out_uint (pformat
, prefix_len
, statbuf
->st_uid
);
957 pw_ent
= getpwuid (statbuf
->st_uid
);
958 out_string (pformat
, prefix_len
,
959 pw_ent
? pw_ent
->pw_name
: "UNKNOWN");
962 out_uint (pformat
, prefix_len
, statbuf
->st_gid
);
966 gw_ent
= getgrgid (statbuf
->st_gid
);
967 out_string (pformat
, prefix_len
,
968 gw_ent
? gw_ent
->gr_name
: "UNKNOWN");
971 out_uint_x (pformat
, prefix_len
, major (statbuf
->st_rdev
));
974 fail
|= out_mount_point (filename
, pformat
, prefix_len
, statbuf
);
977 out_uint_x (pformat
, prefix_len
, minor (statbuf
->st_rdev
));
980 out_int (pformat
, prefix_len
, statbuf
->st_size
);
983 out_uint (pformat
, prefix_len
, ST_NBLOCKSIZE
);
986 out_uint (pformat
, prefix_len
, ST_NBLOCKS (*statbuf
));
989 out_uint (pformat
, prefix_len
, ST_BLKSIZE (*statbuf
));
993 struct timespec t
= get_stat_birthtime (statbuf
);
995 out_string (pformat
, prefix_len
, "-");
997 out_string (pformat
, prefix_len
, human_time (t
));
1001 out_epoch_sec (pformat
, prefix_len
, statbuf
,
1002 neg_to_zero (get_stat_birthtime (statbuf
)));
1005 out_string (pformat
, prefix_len
, human_time (get_stat_atime (statbuf
)));
1008 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_atime (statbuf
));
1011 out_string (pformat
, prefix_len
, human_time (get_stat_mtime (statbuf
)));
1014 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_mtime (statbuf
));
1017 out_string (pformat
, prefix_len
, human_time (get_stat_ctime (statbuf
)));
1020 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_ctime (statbuf
));
1023 fail
|= out_file_context (pformat
, prefix_len
, filename
);
1026 fputc ('?', stdout
);
1032 /* Output a single-character \ escape. */
1035 print_esc_char (char c
)
1039 case 'a': /* Alert. */
1042 case 'b': /* Backspace. */
1045 case 'e': /* Escape. */
1048 case 'f': /* Form feed. */
1051 case 'n': /* New line. */
1054 case 'r': /* Carriage return. */
1057 case 't': /* Horizontal tab. */
1060 case 'v': /* Vertical tab. */
1067 error (0, 0, _("warning: unrecognized escape '\\%c'"), c
);
1073 /* Print the information specified by the format string, FORMAT,
1074 calling PRINT_FUNC for each %-directive encountered.
1075 Return zero upon success, nonzero upon failure. */
1076 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1077 print_it (char const *format
, char const *filename
,
1078 bool (*print_func
) (char *, size_t, unsigned int,
1079 char const *, void const *),
1084 /* Add 2 to accommodate our conversion of the stat '%s' format string
1085 to the longer printf '%llu' one. */
1088 MAX_ADDITIONAL_BYTES
=
1089 (MAX (sizeof PRIdMAX
,
1090 MAX (sizeof PRIoMAX
, MAX (sizeof PRIuMAX
, sizeof PRIxMAX
)))
1093 size_t n_alloc
= strlen (format
) + MAX_ADDITIONAL_BYTES
+ 1;
1094 char *dest
= xmalloc (n_alloc
);
1096 for (b
= format
; *b
; b
++)
1102 size_t len
= strspn (b
+ 1, printf_flags
);
1103 char const *fmt_char
= b
+ len
+ 1;
1104 fmt_char
+= strspn (fmt_char
, digits
);
1105 if (*fmt_char
== '.')
1106 fmt_char
+= 1 + strspn (fmt_char
+ 1, digits
);
1107 len
= fmt_char
- (b
+ 1);
1108 unsigned int fmt_code
= *fmt_char
;
1109 memcpy (dest
, b
, len
+ 1);
1120 dest
[len
+ 1] = *fmt_char
;
1121 dest
[len
+ 2] = '\0';
1122 error (EXIT_FAILURE
, 0, _("%s: invalid directive"),
1123 quotearg_colon (dest
));
1128 fail
|= print_func (dest
, len
+ 1, fmt_code
, filename
, data
);
1135 if ( ! interpret_backslash_escapes
)
1143 int esc_value
= octtobin (*b
);
1144 int esc_length
= 1; /* number of octal digits */
1145 for (++b
; esc_length
< 3 && isodigit (*b
);
1148 esc_value
= esc_value
* 8 + octtobin (*b
);
1150 putchar (esc_value
);
1153 else if (*b
== 'x' && isxdigit (to_uchar (b
[1])))
1155 int esc_value
= hextobin (b
[1]); /* Value of \xhh escape. */
1156 /* A hexadecimal \xhh escape sequence must have
1157 1 or 2 hex. digits. */
1159 if (isxdigit (to_uchar (b
[1])))
1162 esc_value
= esc_value
* 16 + hextobin (*b
);
1164 putchar (esc_value
);
1166 else if (*b
== '\0')
1168 error (0, 0, _("warning: backslash at end of format"));
1170 /* Arrange to exit the loop. */
1175 print_esc_char (*b
);
1186 fputs (trailing_delim
, stdout
);
1191 /* Stat the file system and print what we find. */
1192 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1193 do_statfs (char const *filename
, char const *format
)
1195 STRUCT_STATVFS statfsbuf
;
1197 if (STREQ (filename
, "-"))
1199 error (0, 0, _("using %s to denote standard input does not work"
1200 " in file system mode"), quote (filename
));
1204 if (STATFS (filename
, &statfsbuf
) != 0)
1206 error (0, errno
, _("cannot read file system information for %s"),
1211 bool fail
= print_it (format
, filename
, print_statfs
, &statfsbuf
);
1215 /* stat the file and print what we find */
1216 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1217 do_stat (char const *filename
, char const *format
,
1218 char const *format2
)
1220 struct stat statbuf
;
1222 if (STREQ (filename
, "-"))
1224 if (fstat (STDIN_FILENO
, &statbuf
) != 0)
1226 error (0, errno
, _("cannot stat standard input"));
1230 /* We can't use the shorter
1231 (follow_links?stat:lstat) (filename, &statbug)
1232 since stat might be a function-like macro. */
1233 else if ((follow_links
1234 ? stat (filename
, &statbuf
)
1235 : lstat (filename
, &statbuf
)) != 0)
1237 error (0, errno
, _("cannot stat %s"), quote (filename
));
1241 if (S_ISBLK (statbuf
.st_mode
) || S_ISCHR (statbuf
.st_mode
))
1244 bool fail
= print_it (format
, filename
, print_stat
, &statbuf
);
1248 /* Return an allocated format string in static storage that
1249 corresponds to whether FS and TERSE options were declared. */
1251 default_format (bool fs
, bool terse
, bool device
)
1257 format
= xstrdup ("%n %i %l %t %s %S %b %f %a %c %d\n");
1260 /* TRANSLATORS: This string uses format specifiers from
1261 'stat --help' with --file-system, and NOT from printf. */
1262 format
= xstrdup (_(" File: \"%n\"\n"
1263 " ID: %-8i Namelen: %-7l Type: %T\n"
1264 "Block size: %-10s Fundamental block size: %S\n"
1265 "Blocks: Total: %-10b Free: %-10f Available: %a\n"
1266 "Inodes: Total: %-10c Free: %d\n"));
1273 if (0 < is_selinux_enabled ())
1274 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1275 " %X %Y %Z %W %o %C\n");
1277 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1278 " %X %Y %Z %W %o\n");
1283 /* TRANSLATORS: This string uses format specifiers from
1284 'stat --help' without --file-system, and NOT from printf. */
1285 format
= xstrdup (_("\
1287 Size: %-10s\tBlocks: %-10b IO Block: %-6o %F\n\
1293 /* TRANSLATORS: This string uses format specifiers from
1294 'stat --help' without --file-system, and NOT from printf. */
1295 format
= xasprintf ("%s%s", format
, _("\
1296 " "Device: %Dh/%dd\tInode: %-10i Links: %-5h Device type: %t,%T\n\
1301 /* TRANSLATORS: This string uses format specifiers from
1302 'stat --help' without --file-system, and NOT from printf. */
1303 format
= xasprintf ("%s%s", format
, _("\
1304 " "Device: %Dh/%dd\tInode: %-10i Links: %h\n\
1310 /* TRANSLATORS: This string uses format specifiers from
1311 'stat --help' without --file-system, and NOT from printf. */
1312 format
= xasprintf ("%s%s", format
, _("\
1313 " "Access: (%04a/%10.10A) Uid: (%5u/%8U) Gid: (%5g/%8G)\n\
1317 if (0 < is_selinux_enabled ())
1320 /* TRANSLATORS: This string uses format specifiers from
1321 'stat --help' without --file-system, and NOT from printf. */
1322 format
= xasprintf ("%s%s", format
, _("Context: %C\n"));
1327 /* TRANSLATORS: This string uses format specifiers from
1328 'stat --help' without --file-system, and NOT from printf. */
1329 format
= xasprintf ("%s%s", format
,
1343 if (status
!= EXIT_SUCCESS
)
1347 printf (_("Usage: %s [OPTION]... FILE...\n"), program_name
);
1349 Display file or file system status.\n\
1351 -L, --dereference follow links\n\
1352 -f, --file-system display file system status instead of file status\n\
1355 -c --format=FORMAT use the specified FORMAT instead of the default;\n\
1356 output a newline after each use of FORMAT\n\
1357 --printf=FORMAT like --format, but interpret backslash escapes,\n\
1358 and do not output a mandatory trailing newline.\n\
1359 If you want a newline, include \\n in FORMAT\n\
1360 -t, --terse print the information in terse form\n\
1362 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
1363 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
1366 The valid format sequences for files (without --file-system):\n\
1368 %a access rights in octal\n\
1369 %A access rights in human readable form\n\
1370 %b number of blocks allocated (see %B)\n\
1371 %B the size in bytes of each block reported by %b\n\
1372 %C SELinux security context string\n\
1375 %d device number in decimal\n\
1376 %D device number in hex\n\
1377 %f raw mode in hex\n\
1379 %g group ID of owner\n\
1380 %G group name of owner\n\
1383 %h number of hard links\n\
1387 %N quoted file name with dereference if symbolic link\n\
1388 %o optimal I/O transfer size hint\n\
1389 %s total size, in bytes\n\
1390 %t major device type in hex\n\
1391 %T minor device type in hex\n\
1394 %u user ID of owner\n\
1395 %U user name of owner\n\
1396 %w time of file birth, human-readable; - if unknown\n\
1397 %W time of file birth, seconds since Epoch; 0 if unknown\n\
1398 %x time of last access, human-readable\n\
1399 %X time of last access, seconds since Epoch\n\
1400 %y time of last modification, human-readable\n\
1401 %Y time of last modification, seconds since Epoch\n\
1402 %z time of last change, human-readable\n\
1403 %Z time of last change, seconds since Epoch\n\
1408 Valid format sequences for file systems:\n\
1410 %a free blocks available to non-superuser\n\
1411 %b total data blocks in file system\n\
1412 %c total file nodes in file system\n\
1413 %d free file nodes in file system\n\
1414 %f free blocks in file system\n\
1417 %i file system ID in hex\n\
1418 %l maximum length of filenames\n\
1420 %s block size (for faster transfers)\n\
1421 %S fundamental block size (for block counts)\n\
1422 %t file system type in hex\n\
1423 %T file system type in human readable form\n\
1425 printf (USAGE_BUILTIN_WARNING
, PROGRAM_NAME
);
1426 emit_ancillary_info ();
1432 main (int argc
, char *argv
[])
1438 char *format
= NULL
;
1442 initialize_main (&argc
, &argv
);
1443 set_program_name (argv
[0]);
1444 setlocale (LC_ALL
, "");
1445 bindtextdomain (PACKAGE
, LOCALEDIR
);
1446 textdomain (PACKAGE
);
1448 struct lconv
const *locale
= localeconv ();
1449 decimal_point
= (locale
->decimal_point
[0] ? locale
->decimal_point
: ".");
1450 decimal_point_len
= strlen (decimal_point
);
1452 atexit (close_stdout
);
1454 while ((c
= getopt_long (argc
, argv
, "c:fLt", long_options
, NULL
)) != -1)
1460 interpret_backslash_escapes
= true;
1461 trailing_delim
= "";
1466 interpret_backslash_escapes
= false;
1467 trailing_delim
= "\n";
1471 follow_links
= true;
1482 case_GETOPT_HELP_CHAR
;
1484 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
1487 usage (EXIT_FAILURE
);
1493 error (0, 0, _("missing operand"));
1494 usage (EXIT_FAILURE
);
1501 format
= default_format (fs
, terse
, false);
1502 format2
= default_format (fs
, terse
, true);
1505 for (i
= optind
; i
< argc
; i
++)
1507 ? do_statfs (argv
[i
], format
)
1508 : do_stat (argv
[i
], format
, format2
));
1510 exit (ok
? EXIT_SUCCESS
: EXIT_FAILURE
);