1 /* stat.c -- display file or file system status
2 Copyright (C) 2001-2013 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 {"dereference", no_argument
, NULL
, 'L'},
183 {"file-system", no_argument
, NULL
, 'f'},
184 {"format", required_argument
, NULL
, 'c'},
185 {"printf", required_argument
, NULL
, PRINTF_OPTION
},
186 {"terse", no_argument
, NULL
, 't'},
187 {GETOPT_HELP_OPTION_DECL
},
188 {GETOPT_VERSION_OPTION_DECL
},
192 /* Whether to follow symbolic links; True for --dereference (-L). */
193 static bool follow_links
;
195 /* Whether to interpret backslash-escape sequences.
196 True for --printf=FMT, not for --format=FMT (-c). */
197 static bool interpret_backslash_escapes
;
199 /* The trailing delimiter string:
200 "" for --printf=FMT, "\n" for --format=FMT (-c). */
201 static char const *trailing_delim
= "";
203 /* The representation of the decimal point in the current locale. */
204 static char const *decimal_point
;
205 static size_t decimal_point_len
;
207 /* Return the type of the specified file system.
208 Some systems have statfvs.f_basetype[FSTYPSZ] (AIX, HP-UX, and Solaris).
209 Others have statvfs.f_fstypename[_VFS_NAMELEN] (NetBSD 3.0).
210 Others have statfs.f_fstypename[MFSNAMELEN] (NetBSD 1.5.2).
211 Still others have neither and have to get by with f_type (GNU/Linux).
212 But f_type may only exist in statfs (Cygwin). */
213 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
214 human_fstype (STRUCT_STATVFS
const *statfsbuf
)
216 #ifdef STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
217 return statfsbuf
->STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
;
219 switch (statfsbuf
->f_type
)
221 # if defined __linux__
223 /* Compare with what's in libc:
224 f=/a/libc/sysdeps/unix/sysv/linux/linux_fsinfo.h
225 sed -n '/ADFS_SUPER_MAGIC/,/SYSFS_MAGIC/p' $f \
226 | perl -n -e '/#define (.*?)_(?:SUPER_)MAGIC\s+0x(\S+)/' \
227 -e 'and print "case S_MAGIC_$1: /\* 0x" . uc($2) . " *\/\n"' \
229 perl -ne '/^\s+(case S_MAGIC_.*?): \/\* 0x(\S+) \*\//' \
230 -e 'and do { $v=uc$2; print "$1: /\* 0x$v *\/\n"}' stat.c \
232 diff -u sym_stat sym_libc
235 /* Also compare with the list in "man 2 statfs" using the
236 fs-magic-compare make target. */
238 /* IMPORTANT NOTE: Each of the following 'case S_MAGIC_...:'
239 statements must be followed by a hexadecimal constant in
240 a comment. The S_MAGIC_... name and constant are automatically
241 combined to produce the #define directives in fs.h. */
243 case S_MAGIC_ADFS
: /* 0xADF5 local */
245 case S_MAGIC_AFFS
: /* 0xADFF local */
247 case S_MAGIC_AFS
: /* 0x5346414F remote */
249 case S_MAGIC_ANON_INODE_FS
: /* 0x09041934 local */
250 return "anon-inode FS";
251 case S_MAGIC_AUFS
: /* 0x61756673 remote */
252 /* FIXME: change syntax or add an optional attribute like "inotify:no".
253 The above is labeled as "remote" so that tail always uses polling,
254 but this isn't really a remote file system type. */
256 case S_MAGIC_AUTOFS
: /* 0x0187 local */
258 case S_MAGIC_BEFS
: /* 0x42465331 local */
260 case S_MAGIC_BDEVFS
: /* 0x62646576 local */
262 case S_MAGIC_BFS
: /* 0x1BADFACE local */
264 case S_MAGIC_BINFMTFS
: /* 0x42494E4D local */
265 return "binfmt_misc";
266 case S_MAGIC_BTRFS
: /* 0x9123683E local */
268 case S_MAGIC_CEPH
: /* 0x00C36400 remote */
270 case S_MAGIC_CGROUP
: /* 0x0027E0EB local */
272 case S_MAGIC_CIFS
: /* 0xFF534D42 remote */
274 case S_MAGIC_CODA
: /* 0x73757245 remote */
276 case S_MAGIC_COH
: /* 0x012FF7B7 local */
278 case S_MAGIC_CRAMFS
: /* 0x28CD3D45 local */
280 case S_MAGIC_CRAMFS_WEND
: /* 0x453DCD28 local */
281 return "cramfs-wend";
282 case S_MAGIC_DEBUGFS
: /* 0x64626720 local */
284 case S_MAGIC_DEVFS
: /* 0x1373 local */
286 case S_MAGIC_DEVPTS
: /* 0x1CD1 local */
288 case S_MAGIC_ECRYPTFS
: /* 0xF15F local */
290 case S_MAGIC_EFIVARFS
: /* 0xDE5E81E4 local */
292 case S_MAGIC_EFS
: /* 0x00414A53 local */
294 case S_MAGIC_EXOFS
: /* 0x5DF5 local */
296 case S_MAGIC_EXT
: /* 0x137D local */
298 case S_MAGIC_EXT2
: /* 0xEF53 local */
300 case S_MAGIC_EXT2_OLD
: /* 0xEF51 local */
302 case S_MAGIC_F2FS
: /* 0xF2F52010 local */
304 case S_MAGIC_FAT
: /* 0x4006 local */
306 case S_MAGIC_FHGFS
: /* 0x19830326 remote */
308 case S_MAGIC_FUSEBLK
: /* 0x65735546 remote */
310 case S_MAGIC_FUSECTL
: /* 0x65735543 remote */
312 case S_MAGIC_FUTEXFS
: /* 0x0BAD1DEA local */
314 case S_MAGIC_GFS
: /* 0x1161970 remote */
316 case S_MAGIC_GPFS
: /* 0x47504653 remote */
318 case S_MAGIC_HFS
: /* 0x4244 local */
320 case S_MAGIC_HPFS
: /* 0xF995E849 local */
322 case S_MAGIC_HUGETLBFS
: /* 0x958458F6 local */
324 case S_MAGIC_MTD_INODE_FS
: /* 0x11307854 local */
326 case S_MAGIC_INOTIFYFS
: /* 0x2BAD1DEA local */
328 case S_MAGIC_ISOFS
: /* 0x9660 local */
330 case S_MAGIC_ISOFS_R_WIN
: /* 0x4004 local */
332 case S_MAGIC_ISOFS_WIN
: /* 0x4000 local */
334 case S_MAGIC_JFFS
: /* 0x07C0 local */
336 case S_MAGIC_JFFS2
: /* 0x72B6 local */
338 case S_MAGIC_JFS
: /* 0x3153464A local */
340 case S_MAGIC_KAFS
: /* 0x6B414653 remote */
342 case S_MAGIC_LUSTRE
: /* 0x0BD00BD0 remote */
344 case S_MAGIC_MINIX
: /* 0x137F local */
346 case S_MAGIC_MINIX_30
: /* 0x138F local */
347 return "minix (30 char.)";
348 case S_MAGIC_MINIX_V2
: /* 0x2468 local */
350 case S_MAGIC_MINIX_V2_30
: /* 0x2478 local */
351 return "minix v2 (30 char.)";
352 case S_MAGIC_MINIX_V3
: /* 0x4D5A local */
354 case S_MAGIC_MQUEUE
: /* 0x19800202 local */
356 case S_MAGIC_MSDOS
: /* 0x4D44 local */
358 case S_MAGIC_NCP
: /* 0x564C remote */
360 case S_MAGIC_NFS
: /* 0x6969 remote */
362 case S_MAGIC_NFSD
: /* 0x6E667364 remote */
364 case S_MAGIC_NILFS
: /* 0x3434 local */
366 case S_MAGIC_NTFS
: /* 0x5346544E local */
368 case S_MAGIC_OPENPROM
: /* 0x9FA1 local */
370 case S_MAGIC_OCFS2
: /* 0x7461636f remote */
372 case S_MAGIC_PANFS
: /* 0xAAD7AAEA remote */
374 case S_MAGIC_PIPEFS
: /* 0x50495045 remote */
375 /* FIXME: change syntax or add an optional attribute like "inotify:no".
376 The above is labeled as "remote" so that tail always uses polling,
377 but this isn't really a remote file system type. */
379 case S_MAGIC_PROC
: /* 0x9FA0 local */
381 case S_MAGIC_PSTOREFS
: /* 0x6165676C local */
383 case S_MAGIC_QNX4
: /* 0x002F local */
385 case S_MAGIC_QNX6
: /* 0x68191122 local */
387 case S_MAGIC_RAMFS
: /* 0x858458F6 local */
389 case S_MAGIC_REISERFS
: /* 0x52654973 local */
391 case S_MAGIC_ROMFS
: /* 0x7275 local */
393 case S_MAGIC_RPC_PIPEFS
: /* 0x67596969 local */
395 case S_MAGIC_SECURITYFS
: /* 0x73636673 local */
397 case S_MAGIC_SELINUX
: /* 0xF97CFF8C local */
399 case S_MAGIC_SMB
: /* 0x517B remote */
401 case S_MAGIC_SNFS
: /* 0xBEEFDEAD remote */
403 case S_MAGIC_SOCKFS
: /* 0x534F434B local */
405 case S_MAGIC_SQUASHFS
: /* 0x73717368 local */
407 case S_MAGIC_SYSFS
: /* 0x62656572 local */
409 case S_MAGIC_SYSV2
: /* 0x012FF7B6 local */
411 case S_MAGIC_SYSV4
: /* 0x012FF7B5 local */
413 case S_MAGIC_TMPFS
: /* 0x01021994 local */
415 case S_MAGIC_UBIFS
: /* 0x24051905 local */
417 case S_MAGIC_UDF
: /* 0x15013346 local */
419 case S_MAGIC_UFS
: /* 0x00011954 local */
421 case S_MAGIC_UFS_BYTESWAPPED
: /* 0x54190100 local */
423 case S_MAGIC_USBDEVFS
: /* 0x9FA2 local */
425 case S_MAGIC_V9FS
: /* 0x01021997 local */
427 case S_MAGIC_VMHGFS
: /* 0xBACBACBC remote */
429 case S_MAGIC_VXFS
: /* 0xA501FCF5 local */
431 case S_MAGIC_VZFS
: /* 0x565A4653 local */
433 case S_MAGIC_XENFS
: /* 0xABBA1974 local */
435 case S_MAGIC_XENIX
: /* 0x012FF7B4 local */
437 case S_MAGIC_XFS
: /* 0x58465342 local */
439 case S_MAGIC_XIAFS
: /* 0x012FD16D local */
441 case S_MAGIC_ZFS
: /* 0x2FC12FC1 local */
502 unsigned long int type
= statfsbuf
->f_type
;
503 static char buf
[sizeof "UNKNOWN (0x%lx)" - 3
504 + (sizeof type
* CHAR_BIT
+ 3) / 4];
505 sprintf (buf
, "UNKNOWN (0x%lx)", type
);
512 static char * ATTRIBUTE_WARN_UNUSED_RESULT
513 human_access (struct stat
const *statbuf
)
515 static char modebuf
[12];
516 filemodestring (statbuf
, modebuf
);
521 static char * ATTRIBUTE_WARN_UNUSED_RESULT
522 human_time (struct timespec t
)
524 static char str
[MAX (INT_BUFSIZE_BOUND (intmax_t),
525 (INT_STRLEN_BOUND (int) /* YYYY */
526 + 1 /* because YYYY might equal INT_MAX + 1900 */
527 + sizeof "-MM-DD HH:MM:SS.NNNNNNNNN +ZZZZ"))];
528 struct tm
const *tm
= localtime (&t
.tv_sec
);
530 return timetostr (t
.tv_sec
, str
);
531 nstrftime (str
, sizeof str
, "%Y-%m-%d %H:%M:%S.%N %z", tm
, 0, t
.tv_nsec
);
535 /* PFORMAT points to a '%' followed by a prefix of a format, all of
536 size PREFIX_LEN. The flags allowed for this format are
537 ALLOWED_FLAGS; remove other printf flags from the prefix, then
540 make_format (char *pformat
, size_t prefix_len
, char const *allowed_flags
,
543 char *dst
= pformat
+ 1;
545 char const *srclim
= pformat
+ prefix_len
;
546 for (src
= dst
; src
< srclim
&& strchr (printf_flags
, *src
); src
++)
547 if (strchr (allowed_flags
, *src
))
551 strcpy (dst
, suffix
);
555 out_string (char *pformat
, size_t prefix_len
, char const *arg
)
557 make_format (pformat
, prefix_len
, "-", "s");
558 printf (pformat
, arg
);
561 out_int (char *pformat
, size_t prefix_len
, intmax_t arg
)
563 make_format (pformat
, prefix_len
, "'-+ 0", PRIdMAX
);
564 return printf (pformat
, arg
);
567 out_uint (char *pformat
, size_t prefix_len
, uintmax_t arg
)
569 make_format (pformat
, prefix_len
, "'-0", PRIuMAX
);
570 return printf (pformat
, arg
);
573 out_uint_o (char *pformat
, size_t prefix_len
, uintmax_t arg
)
575 make_format (pformat
, prefix_len
, "-#0", PRIoMAX
);
576 printf (pformat
, arg
);
579 out_uint_x (char *pformat
, size_t prefix_len
, uintmax_t arg
)
581 make_format (pformat
, prefix_len
, "-#0", PRIxMAX
);
582 printf (pformat
, arg
);
585 out_minus_zero (char *pformat
, size_t prefix_len
)
587 make_format (pformat
, prefix_len
, "'-+ 0", ".0f");
588 return printf (pformat
, -0.25);
591 /* Output the number of seconds since the Epoch, using a format that
592 acts like printf's %f format. */
594 out_epoch_sec (char *pformat
, size_t prefix_len
,
595 struct stat
const *statbuf _GL_UNUSED
,
598 char *dot
= memchr (pformat
, '.', prefix_len
);
599 size_t sec_prefix_len
= prefix_len
;
602 bool frac_left_adjust
= false;
606 sec_prefix_len
= dot
- pformat
;
607 pformat
[prefix_len
] = '\0';
609 if (ISDIGIT (dot
[1]))
611 long int lprec
= strtol (dot
+ 1, NULL
, 10);
612 precision
= (lprec
<= INT_MAX
? lprec
: INT_MAX
);
619 if (precision
&& ISDIGIT (dot
[-1]))
621 /* If a nontrivial width is given, subtract the width of the
622 decimal point and PRECISION digits that will be output
629 while (ISDIGIT (p
[-1]));
631 long int lwidth
= strtol (p
, NULL
, 10);
632 width
= (lwidth
<= INT_MAX
? lwidth
: INT_MAX
);
636 sec_prefix_len
= p
- pformat
;
637 int w_d
= (decimal_point_len
< width
638 ? width
- decimal_point_len
642 int w
= w_d
- precision
;
646 for (char const *src
= dst
; src
< p
; src
++)
649 frac_left_adjust
= true;
655 + (frac_left_adjust
? 0 : sprintf (dst
, "%d", w
)));
663 for (int i
= precision
; i
< 9; i
++)
665 int frac_sec
= arg
.tv_nsec
/ divisor
;
668 if (TYPE_SIGNED (time_t))
670 bool minus_zero
= false;
671 if (arg
.tv_sec
< 0 && arg
.tv_nsec
!= 0)
673 int frac_sec_modulus
= 1000000000 / divisor
;
674 frac_sec
= (frac_sec_modulus
- frac_sec
675 - (arg
.tv_nsec
% divisor
!= 0));
676 arg
.tv_sec
+= (frac_sec
!= 0);
677 minus_zero
= (arg
.tv_sec
== 0);
679 int_len
= (minus_zero
680 ? out_minus_zero (pformat
, sec_prefix_len
)
681 : out_int (pformat
, sec_prefix_len
, arg
.tv_sec
));
684 int_len
= out_uint (pformat
, sec_prefix_len
, arg
.tv_sec
);
688 int prec
= (precision
< 9 ? precision
: 9);
689 int trailing_prec
= precision
- prec
;
690 int ilen
= (int_len
< 0 ? 0 : int_len
);
691 int trailing_width
= (ilen
< width
&& decimal_point_len
< width
- ilen
692 ? width
- ilen
- decimal_point_len
- prec
694 printf ("%s%.*d%-*.*d", decimal_point
, prec
, frac_sec
,
695 trailing_width
, trailing_prec
, 0);
699 /* Print the context information of FILENAME, and return true iff the
700 context could not be obtained. */
701 static bool ATTRIBUTE_WARN_UNUSED_RESULT
702 out_file_context (char *pformat
, size_t prefix_len
, char const *filename
)
708 ? getfilecon (filename
, &scontext
)
709 : lgetfilecon (filename
, &scontext
)) < 0)
711 error (0, errno
, _("failed to get security context of %s"),
716 strcpy (pformat
+ prefix_len
, "s");
717 printf (pformat
, (scontext
? scontext
: "?"));
723 /* Print statfs info. Return zero upon success, nonzero upon failure. */
724 static bool ATTRIBUTE_WARN_UNUSED_RESULT
725 print_statfs (char *pformat
, size_t prefix_len
, unsigned int m
,
726 char const *filename
,
729 STRUCT_STATVFS
const *statfsbuf
= data
;
735 out_string (pformat
, prefix_len
, filename
);
740 #if STRUCT_STATXFS_F_FSID_IS_INTEGER
741 uintmax_t fsid
= statfsbuf
->f_fsid
;
743 typedef unsigned int fsid_word
;
744 verify (alignof (STRUCT_STATVFS
) % alignof (fsid_word
) == 0);
745 verify (offsetof (STRUCT_STATVFS
, f_fsid
) % alignof (fsid_word
) == 0);
746 verify (sizeof statfsbuf
->f_fsid
% alignof (fsid_word
) == 0);
747 fsid_word
const *p
= (fsid_word
*) &statfsbuf
->f_fsid
;
749 /* Assume a little-endian word order, as that is compatible
750 with glibc's statvfs implementation. */
752 int words
= sizeof statfsbuf
->f_fsid
/ sizeof *p
;
754 for (i
= 0; i
< words
&& i
* sizeof *p
< sizeof fsid
; i
++)
756 uintmax_t u
= p
[words
- 1 - i
];
757 fsid
|= u
<< (i
* CHAR_BIT
* sizeof *p
);
760 out_uint_x (pformat
, prefix_len
, fsid
);
765 OUT_NAMEMAX (pformat
, prefix_len
, SB_F_NAMEMAX (statfsbuf
));
768 #if HAVE_STRUCT_STATXFS_F_TYPE
769 out_uint_x (pformat
, prefix_len
, statfsbuf
->f_type
);
775 out_string (pformat
, prefix_len
, human_fstype (statfsbuf
));
778 out_int (pformat
, prefix_len
, statfsbuf
->f_blocks
);
781 out_int (pformat
, prefix_len
, statfsbuf
->f_bfree
);
784 out_int (pformat
, prefix_len
, statfsbuf
->f_bavail
);
787 out_uint (pformat
, prefix_len
, statfsbuf
->f_bsize
);
791 uintmax_t frsize
= STATFS_FRSIZE (statfsbuf
);
793 frsize
= statfsbuf
->f_bsize
;
794 out_uint (pformat
, prefix_len
, frsize
);
798 out_uint (pformat
, prefix_len
, statfsbuf
->f_files
);
801 out_int (pformat
, prefix_len
, statfsbuf
->f_ffree
);
810 /* Return any bind mounted source for a path.
811 The caller should not free the returned buffer.
812 Return NULL if no bind mount found. */
813 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
814 find_bind_mount (char const * name
)
816 char const * bind_mount
= NULL
;
818 static struct mount_entry
*mount_list
;
819 static bool tried_mount_list
= false;
820 if (!tried_mount_list
) /* attempt/warn once per process. */
822 if (!(mount_list
= read_file_system_list (false)))
823 error (0, errno
, "%s", _("cannot read table of mounted file systems"));
824 tried_mount_list
= true;
827 struct mount_entry
*me
;
828 for (me
= mount_list
; me
; me
= me
->me_next
)
830 if (me
->me_dummy
&& me
->me_devname
[0] == '/'
831 && STREQ (me
->me_mountdir
, name
))
833 struct stat name_stats
;
834 struct stat dev_stats
;
836 if (stat (name
, &name_stats
) == 0
837 && stat (me
->me_devname
, &dev_stats
) == 0
838 && SAME_INODE (name_stats
, dev_stats
))
840 bind_mount
= me
->me_devname
;
849 /* Print mount point. Return zero upon success, nonzero upon failure. */
850 static bool ATTRIBUTE_WARN_UNUSED_RESULT
851 out_mount_point (char const *filename
, char *pformat
, size_t prefix_len
,
852 const struct stat
*statp
)
855 char const *np
= "?", *bp
= NULL
;
859 /* Look for bind mounts first. Note we output the immediate alias,
860 rather than further resolving to a base device mount point. */
861 if (follow_links
|| !S_ISLNK (statp
->st_mode
))
863 char *resolved
= canonicalize_file_name (filename
);
866 error (0, errno
, _("failed to canonicalize %s"), quote (filename
));
867 goto print_mount_point
;
869 bp
= find_bind_mount (resolved
);
874 goto print_mount_point
;
878 /* If there is no direct bind mount, then navigate
879 back up the tree looking for a device change.
880 Note we don't detect if any of the directory components
881 are bind mounted to the same device, but that's OK
882 since we've not directly queried them. */
883 if ((mp
= find_mount_point (filename
, statp
)))
885 /* This dir might be bind mounted to another device,
886 so we resolve the bound source in that case also. */
887 bp
= find_bind_mount (mp
);
893 out_string (pformat
, prefix_len
, bp
? bp
: mp
? mp
: np
);
898 /* Map a TS with negative TS.tv_nsec to {0,0}. */
899 static inline struct timespec
900 neg_to_zero (struct timespec ts
)
904 struct timespec z
= {0, 0};
908 /* Print stat info. Return zero upon success, nonzero upon failure. */
910 print_stat (char *pformat
, size_t prefix_len
, unsigned int m
,
911 char const *filename
, void const *data
)
913 struct stat
*statbuf
= (struct stat
*) data
;
914 struct passwd
*pw_ent
;
915 struct group
*gw_ent
;
921 out_string (pformat
, prefix_len
, filename
);
924 out_string (pformat
, prefix_len
, quote (filename
));
925 if (S_ISLNK (statbuf
->st_mode
))
927 char *linkname
= areadlink_with_size (filename
, statbuf
->st_size
);
928 if (linkname
== NULL
)
930 error (0, errno
, _("cannot read symbolic link %s"),
935 out_string (pformat
, prefix_len
, quote (linkname
));
940 out_uint (pformat
, prefix_len
, statbuf
->st_dev
);
943 out_uint_x (pformat
, prefix_len
, statbuf
->st_dev
);
946 out_uint (pformat
, prefix_len
, statbuf
->st_ino
);
949 out_uint_o (pformat
, prefix_len
, statbuf
->st_mode
& CHMOD_MODE_BITS
);
952 out_string (pformat
, prefix_len
, human_access (statbuf
));
955 out_uint_x (pformat
, prefix_len
, statbuf
->st_mode
);
958 out_string (pformat
, prefix_len
, file_type (statbuf
));
961 out_uint (pformat
, prefix_len
, statbuf
->st_nlink
);
964 out_uint (pformat
, prefix_len
, statbuf
->st_uid
);
967 pw_ent
= getpwuid (statbuf
->st_uid
);
968 out_string (pformat
, prefix_len
,
969 pw_ent
? pw_ent
->pw_name
: "UNKNOWN");
972 out_uint (pformat
, prefix_len
, statbuf
->st_gid
);
975 gw_ent
= getgrgid (statbuf
->st_gid
);
976 out_string (pformat
, prefix_len
,
977 gw_ent
? gw_ent
->gr_name
: "UNKNOWN");
980 out_uint_x (pformat
, prefix_len
, major (statbuf
->st_rdev
));
983 fail
|= out_mount_point (filename
, pformat
, prefix_len
, statbuf
);
986 out_uint_x (pformat
, prefix_len
, minor (statbuf
->st_rdev
));
989 out_int (pformat
, prefix_len
, statbuf
->st_size
);
992 out_uint (pformat
, prefix_len
, ST_NBLOCKSIZE
);
995 out_uint (pformat
, prefix_len
, ST_NBLOCKS (*statbuf
));
998 out_uint (pformat
, prefix_len
, ST_BLKSIZE (*statbuf
));
1002 struct timespec t
= get_stat_birthtime (statbuf
);
1004 out_string (pformat
, prefix_len
, "-");
1006 out_string (pformat
, prefix_len
, human_time (t
));
1010 out_epoch_sec (pformat
, prefix_len
, statbuf
,
1011 neg_to_zero (get_stat_birthtime (statbuf
)));
1014 out_string (pformat
, prefix_len
, human_time (get_stat_atime (statbuf
)));
1017 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_atime (statbuf
));
1020 out_string (pformat
, prefix_len
, human_time (get_stat_mtime (statbuf
)));
1023 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_mtime (statbuf
));
1026 out_string (pformat
, prefix_len
, human_time (get_stat_ctime (statbuf
)));
1029 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_ctime (statbuf
));
1032 fail
|= out_file_context (pformat
, prefix_len
, filename
);
1035 fputc ('?', stdout
);
1041 /* Output a single-character \ escape. */
1044 print_esc_char (char c
)
1048 case 'a': /* Alert. */
1051 case 'b': /* Backspace. */
1054 case 'e': /* Escape. */
1057 case 'f': /* Form feed. */
1060 case 'n': /* New line. */
1063 case 'r': /* Carriage return. */
1066 case 't': /* Horizontal tab. */
1069 case 'v': /* Vertical tab. */
1076 error (0, 0, _("warning: unrecognized escape '\\%c'"), c
);
1082 /* Print the information specified by the format string, FORMAT,
1083 calling PRINT_FUNC for each %-directive encountered.
1084 Return zero upon success, nonzero upon failure. */
1085 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1086 print_it (char const *format
, char const *filename
,
1087 bool (*print_func
) (char *, size_t, unsigned int,
1088 char const *, void const *),
1093 /* Add 2 to accommodate our conversion of the stat '%s' format string
1094 to the longer printf '%llu' one. */
1097 MAX_ADDITIONAL_BYTES
=
1098 (MAX (sizeof PRIdMAX
,
1099 MAX (sizeof PRIoMAX
, MAX (sizeof PRIuMAX
, sizeof PRIxMAX
)))
1102 size_t n_alloc
= strlen (format
) + MAX_ADDITIONAL_BYTES
+ 1;
1103 char *dest
= xmalloc (n_alloc
);
1105 for (b
= format
; *b
; b
++)
1111 size_t len
= strspn (b
+ 1, printf_flags
);
1112 char const *fmt_char
= b
+ len
+ 1;
1113 fmt_char
+= strspn (fmt_char
, digits
);
1114 if (*fmt_char
== '.')
1115 fmt_char
+= 1 + strspn (fmt_char
+ 1, digits
);
1116 len
= fmt_char
- (b
+ 1);
1117 unsigned int fmt_code
= *fmt_char
;
1118 memcpy (dest
, b
, len
+ 1);
1129 dest
[len
+ 1] = *fmt_char
;
1130 dest
[len
+ 2] = '\0';
1131 error (EXIT_FAILURE
, 0, _("%s: invalid directive"),
1132 quotearg_colon (dest
));
1137 fail
|= print_func (dest
, len
+ 1, fmt_code
, filename
, data
);
1144 if ( ! interpret_backslash_escapes
)
1152 int esc_value
= octtobin (*b
);
1153 int esc_length
= 1; /* number of octal digits */
1154 for (++b
; esc_length
< 3 && isodigit (*b
);
1157 esc_value
= esc_value
* 8 + octtobin (*b
);
1159 putchar (esc_value
);
1162 else if (*b
== 'x' && isxdigit (to_uchar (b
[1])))
1164 int esc_value
= hextobin (b
[1]); /* Value of \xhh escape. */
1165 /* A hexadecimal \xhh escape sequence must have
1166 1 or 2 hex. digits. */
1168 if (isxdigit (to_uchar (b
[1])))
1171 esc_value
= esc_value
* 16 + hextobin (*b
);
1173 putchar (esc_value
);
1175 else if (*b
== '\0')
1177 error (0, 0, _("warning: backslash at end of format"));
1179 /* Arrange to exit the loop. */
1184 print_esc_char (*b
);
1195 fputs (trailing_delim
, stdout
);
1200 /* Stat the file system and print what we find. */
1201 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1202 do_statfs (char const *filename
, char const *format
)
1204 STRUCT_STATVFS statfsbuf
;
1206 if (STREQ (filename
, "-"))
1208 error (0, 0, _("using %s to denote standard input does not work"
1209 " in file system mode"), quote (filename
));
1213 if (STATFS (filename
, &statfsbuf
) != 0)
1215 error (0, errno
, _("cannot read file system information for %s"),
1220 bool fail
= print_it (format
, filename
, print_statfs
, &statfsbuf
);
1224 /* stat the file and print what we find */
1225 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1226 do_stat (char const *filename
, char const *format
,
1227 char const *format2
)
1229 struct stat statbuf
;
1231 if (STREQ (filename
, "-"))
1233 if (fstat (STDIN_FILENO
, &statbuf
) != 0)
1235 error (0, errno
, _("cannot stat standard input"));
1239 /* We can't use the shorter
1240 (follow_links?stat:lstat) (filename, &statbug)
1241 since stat might be a function-like macro. */
1242 else if ((follow_links
1243 ? stat (filename
, &statbuf
)
1244 : lstat (filename
, &statbuf
)) != 0)
1246 error (0, errno
, _("cannot stat %s"), quote (filename
));
1250 if (S_ISBLK (statbuf
.st_mode
) || S_ISCHR (statbuf
.st_mode
))
1253 bool fail
= print_it (format
, filename
, print_stat
, &statbuf
);
1257 /* Return an allocated format string in static storage that
1258 corresponds to whether FS and TERSE options were declared. */
1260 default_format (bool fs
, bool terse
, bool device
)
1266 format
= xstrdup ("%n %i %l %t %s %S %b %f %a %c %d\n");
1269 /* TRANSLATORS: This string uses format specifiers from
1270 'stat --help' with --file-system, and NOT from printf. */
1271 format
= xstrdup (_(" File: \"%n\"\n"
1272 " ID: %-8i Namelen: %-7l Type: %T\n"
1273 "Block size: %-10s Fundamental block size: %S\n"
1274 "Blocks: Total: %-10b Free: %-10f Available: %a\n"
1275 "Inodes: Total: %-10c Free: %d\n"));
1282 if (0 < is_selinux_enabled ())
1283 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1284 " %X %Y %Z %W %o %C\n");
1286 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1287 " %X %Y %Z %W %o\n");
1292 /* TRANSLATORS: This string uses format specifiers from
1293 'stat --help' without --file-system, and NOT from printf. */
1294 format
= xstrdup (_("\
1296 Size: %-10s\tBlocks: %-10b IO Block: %-6o %F\n\
1302 /* TRANSLATORS: This string uses format specifiers from
1303 'stat --help' without --file-system, and NOT from printf. */
1304 format
= xasprintf ("%s%s", format
, _("\
1305 " "Device: %Dh/%dd\tInode: %-10i Links: %-5h Device type: %t,%T\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 " "Device: %Dh/%dd\tInode: %-10i Links: %h\n\
1319 /* TRANSLATORS: This string uses format specifiers from
1320 'stat --help' without --file-system, and NOT from printf. */
1321 format
= xasprintf ("%s%s", format
, _("\
1322 " "Access: (%04a/%10.10A) Uid: (%5u/%8U) Gid: (%5g/%8G)\n\
1326 if (0 < is_selinux_enabled ())
1329 /* TRANSLATORS: This string uses format specifiers from
1330 'stat --help' without --file-system, and NOT from printf. */
1331 format
= xasprintf ("%s%s", format
, _("Context: %C\n"));
1336 /* TRANSLATORS: This string uses format specifiers from
1337 'stat --help' without --file-system, and NOT from printf. */
1338 format
= xasprintf ("%s%s", format
,
1352 if (status
!= EXIT_SUCCESS
)
1356 printf (_("Usage: %s [OPTION]... FILE...\n"), program_name
);
1358 Display file or file system status.\n\
1361 emit_mandatory_arg_note ();
1364 -L, --dereference follow links\n\
1365 -f, --file-system display file system status instead of file status\n\
1368 -c --format=FORMAT use the specified FORMAT instead of the default;\n\
1369 output a newline after each use of FORMAT\n\
1370 --printf=FORMAT like --format, but interpret backslash escapes,\n\
1371 and do not output a mandatory trailing newline;\n\
1372 if you want a newline, include \\n in FORMAT\n\
1373 -t, --terse print the information in terse form\n\
1375 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
1376 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
1379 The valid format sequences for files (without --file-system):\n\
1381 %a access rights in octal\n\
1382 %A access rights in human readable form\n\
1383 %b number of blocks allocated (see %B)\n\
1384 %B the size in bytes of each block reported by %b\n\
1385 %C SELinux security context string\n\
1388 %d device number in decimal\n\
1389 %D device number in hex\n\
1390 %f raw mode in hex\n\
1392 %g group ID of owner\n\
1393 %G group name of owner\n\
1396 %h number of hard links\n\
1400 %N quoted file name with dereference if symbolic link\n\
1401 %o optimal I/O transfer size hint\n\
1402 %s total size, in bytes\n\
1403 %t major device type in hex, for character/block device special files\n\
1404 %T minor device type in hex, for character/block device special files\n\
1407 %u user ID of owner\n\
1408 %U user name of owner\n\
1409 %w time of file birth, human-readable; - if unknown\n\
1410 %W time of file birth, seconds since Epoch; 0 if unknown\n\
1411 %x time of last access, human-readable\n\
1412 %X time of last access, seconds since Epoch\n\
1413 %y time of last modification, human-readable\n\
1414 %Y time of last modification, seconds since Epoch\n\
1415 %z time of last change, human-readable\n\
1416 %Z time of last change, seconds since Epoch\n\
1421 Valid format sequences for file systems:\n\
1423 %a free blocks available to non-superuser\n\
1424 %b total data blocks in file system\n\
1425 %c total file nodes in file system\n\
1426 %d free file nodes in file system\n\
1427 %f free blocks in file system\n\
1430 %i file system ID in hex\n\
1431 %l maximum length of filenames\n\
1433 %s block size (for faster transfers)\n\
1434 %S fundamental block size (for block counts)\n\
1435 %t file system type in hex\n\
1436 %T file system type in human readable form\n\
1438 printf (USAGE_BUILTIN_WARNING
, PROGRAM_NAME
);
1439 emit_ancillary_info ();
1445 main (int argc
, char *argv
[])
1451 char *format
= NULL
;
1455 initialize_main (&argc
, &argv
);
1456 set_program_name (argv
[0]);
1457 setlocale (LC_ALL
, "");
1458 bindtextdomain (PACKAGE
, LOCALEDIR
);
1459 textdomain (PACKAGE
);
1461 struct lconv
const *locale
= localeconv ();
1462 decimal_point
= (locale
->decimal_point
[0] ? locale
->decimal_point
: ".");
1463 decimal_point_len
= strlen (decimal_point
);
1465 atexit (close_stdout
);
1467 while ((c
= getopt_long (argc
, argv
, "c:fLt", long_options
, NULL
)) != -1)
1473 interpret_backslash_escapes
= true;
1474 trailing_delim
= "";
1479 interpret_backslash_escapes
= false;
1480 trailing_delim
= "\n";
1484 follow_links
= true;
1495 case_GETOPT_HELP_CHAR
;
1497 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
1500 usage (EXIT_FAILURE
);
1506 error (0, 0, _("missing operand"));
1507 usage (EXIT_FAILURE
);
1514 format
= default_format (fs
, terse
, false);
1515 format2
= default_format (fs
, terse
, true);
1518 for (i
= optind
; i
< argc
; i
++)
1520 ? do_statfs (argv
[i
], format
)
1521 : do_stat (argv
[i
], format
, format2
));
1523 exit (ok
? EXIT_SUCCESS
: EXIT_FAILURE
);