1 /* stat.c -- display file or file system status
2 Copyright (C) 2001-2011 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 # define STATFS_FRSIZE(S) 0
134 # define OUT_NAMEMAX out_uint
136 /* NetBSD 1.5.2 has neither f_namemax nor f_namelen. */
137 # define SB_F_NAMEMAX(S) "*"
138 # define OUT_NAMEMAX out_string
141 #if HAVE_STRUCT_STATVFS_F_BASETYPE
142 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME f_basetype
144 # if HAVE_STRUCT_STATVFS_F_FSTYPENAME || HAVE_STRUCT_STATFS_F_FSTYPENAME
145 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME f_fstypename
146 # elif HAVE_OS_H /* BeOS */
147 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME fsh_name
151 /* FIXME: these are used by printf.c, too */
152 #define isodigit(c) ('0' <= (c) && (c) <= '7')
153 #define octtobin(c) ((c) - '0')
154 #define hextobin(c) ((c) >= 'a' && (c) <= 'f' ? (c) - 'a' + 10 : \
155 (c) >= 'A' && (c) <= 'F' ? (c) - 'A' + 10 : (c) - '0')
157 static char const digits
[] = "0123456789";
159 /* Flags that are portable for use in printf, for at least one
160 conversion specifier; make_format removes unportable flags as
161 needed for particular specifiers. The glibc 2.2 extension "I" is
162 listed here; it is removed by make_format because it has undefined
163 behavior elsewhere and because it is incompatible with
165 static char const printf_flags
[] = "'-+ #0I";
167 #define PROGRAM_NAME "stat"
169 #define AUTHORS proper_name ("Michael Meskes")
173 PRINTF_OPTION
= CHAR_MAX
+ 1
176 static struct option
const long_options
[] =
178 {"context", no_argument
, 0, 'Z'},
179 {"dereference", no_argument
, NULL
, 'L'},
180 {"file-system", no_argument
, NULL
, 'f'},
181 {"format", required_argument
, NULL
, 'c'},
182 {"printf", required_argument
, NULL
, PRINTF_OPTION
},
183 {"terse", no_argument
, NULL
, 't'},
184 {GETOPT_HELP_OPTION_DECL
},
185 {GETOPT_VERSION_OPTION_DECL
},
189 /* Whether to follow symbolic links; True for --dereference (-L). */
190 static bool follow_links
;
192 /* Whether to interpret backslash-escape sequences.
193 True for --printf=FMT, not for --format=FMT (-c). */
194 static bool interpret_backslash_escapes
;
196 /* The trailing delimiter string:
197 "" for --printf=FMT, "\n" for --format=FMT (-c). */
198 static char const *trailing_delim
= "";
200 /* The representation of the decimal point in the current locale. */
201 static char const *decimal_point
;
202 static size_t decimal_point_len
;
204 /* Return the type of the specified file system.
205 Some systems have statfvs.f_basetype[FSTYPSZ] (AIX, HP-UX, and Solaris).
206 Others have statvfs.f_fstypename[_VFS_NAMELEN] (NetBSD 3.0).
207 Others have statfs.f_fstypename[MFSNAMELEN] (NetBSD 1.5.2).
208 Still others have neither and have to get by with f_type (GNU/Linux).
209 But f_type may only exist in statfs (Cygwin). */
210 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
211 human_fstype (STRUCT_STATVFS
const *statfsbuf
)
213 #ifdef STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
214 return statfsbuf
->STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
;
216 switch (statfsbuf
->f_type
)
218 # if defined __linux__
220 /* Compare with what's in libc:
221 f=/a/libc/sysdeps/unix/sysv/linux/linux_fsinfo.h
222 sed -n '/ADFS_SUPER_MAGIC/,/SYSFS_MAGIC/p' $f \
223 | perl -n -e '/#define (.*?)_(?:SUPER_)MAGIC\s+0x(\S+)/' \
224 -e 'and print "case S_MAGIC_$1: /\* 0x" . uc($2) . " *\/\n"' \
226 perl -ne '/^\s+(case S_MAGIC_.*?): \/\* 0x(\S+) \*\//' \
227 -e 'and do { $v=uc$2; print "$1: /\* 0x$v *\/\n"}' stat.c \
229 diff -u sym_stat sym_libc
232 /* Also compare with the list in "man 2 statfs" using the
233 fs-magic-compare make target. */
235 /* IMPORTANT NOTE: Each of the following `case S_MAGIC_...:'
236 statements must be followed by a hexadecimal constant in
237 a comment. The S_MAGIC_... name and constant are automatically
238 combined to produce the #define directives in fs.h. */
240 case S_MAGIC_ADFS
: /* 0xADF5 */
242 case S_MAGIC_AFFS
: /* 0xADFF */
244 case S_MAGIC_AFS
: /* 0x5346414F */
246 case S_MAGIC_ANON_INODE_FS
: /* 0x09041934 */
247 return "anon-inode FS";
248 case S_MAGIC_AUTOFS
: /* 0x0187 */
250 case S_MAGIC_BEFS
: /* 0x42465331 */
252 case S_MAGIC_BFS
: /* 0x1BADFACE */
254 case S_MAGIC_BINFMT_MISC
: /* 0x42494E4D */
255 return "binfmt_misc";
256 case S_MAGIC_BTRFS
: /* 0x9123683E */
258 case S_MAGIC_CGROUP
: /* 0x0027E0EB */
260 case S_MAGIC_CIFS
: /* 0xFF534D42 */
262 case S_MAGIC_CODA
: /* 0x73757245 */
264 case S_MAGIC_COH
: /* 0x012FF7B7 */
266 case S_MAGIC_CRAMFS
: /* 0x28CD3D45 */
268 case S_MAGIC_CRAMFS_WEND
: /* 0x453DCD28 */
269 return "cramfs-wend";
270 case S_MAGIC_DEBUGFS
: /* 0x64626720 */
272 case S_MAGIC_DEVFS
: /* 0x1373 */
274 case S_MAGIC_DEVPTS
: /* 0x1CD1 */
276 case S_MAGIC_ECRYPTFS
: /* 0xF15F */
278 case S_MAGIC_EFS
: /* 0x00414A53 */
280 case S_MAGIC_EXT
: /* 0x137D */
282 case S_MAGIC_EXT2
: /* 0xEF53 */
284 case S_MAGIC_EXT2_OLD
: /* 0xEF51 */
286 case S_MAGIC_FAT
: /* 0x4006 */
288 case S_MAGIC_FUSEBLK
: /* 0x65735546 */
290 case S_MAGIC_FUSECTL
: /* 0x65735543 */
292 case S_MAGIC_FUTEXFS
: /* 0x0BAD1DEA */
294 case S_MAGIC_GFS
: /* 0x1161970 */
296 case S_MAGIC_GPFS
: /* 0x47504653 */
298 case S_MAGIC_HFS
: /* 0x4244 */
300 case S_MAGIC_HPFS
: /* 0xF995E849 */
302 case S_MAGIC_HUGETLBFS
: /* 0x958458F6 */
304 case S_MAGIC_INOTIFYFS
: /* 0x2BAD1DEA */
306 case S_MAGIC_ISOFS
: /* 0x9660 */
308 case S_MAGIC_ISOFS_R_WIN
: /* 0x4004 */
310 case S_MAGIC_ISOFS_WIN
: /* 0x4000 */
312 case S_MAGIC_JFFS
: /* 0x07C0 */
314 case S_MAGIC_JFFS2
: /* 0x72B6 */
316 case S_MAGIC_JFS
: /* 0x3153464A */
318 case S_MAGIC_KAFS
: /* 0x6B414653 */
320 case S_MAGIC_LUSTRE
: /* 0x0BD00BD0 */
322 case S_MAGIC_MINIX
: /* 0x137F */
324 case S_MAGIC_MINIX_30
: /* 0x138F */
325 return "minix (30 char.)";
326 case S_MAGIC_MINIX_V2
: /* 0x2468 */
328 case S_MAGIC_MINIX_V2_30
: /* 0x2478 */
329 return "minix v2 (30 char.)";
330 case S_MAGIC_MINIX_V3
: /* 0x4D5A */
332 case S_MAGIC_MQUEUE
: /* 0x19800202 */
334 case S_MAGIC_MSDOS
: /* 0x4D44 */
336 case S_MAGIC_NCP
: /* 0x564C */
338 case S_MAGIC_NFS
: /* 0x6969 */
340 case S_MAGIC_NFSD
: /* 0x6E667364 */
342 case S_MAGIC_NILFS
: /* 0x3434 */
344 case S_MAGIC_NTFS
: /* 0x5346544E */
346 case S_MAGIC_OPENPROM
: /* 0x9FA1 */
348 case S_MAGIC_OCFS2
: /* 0x7461636f */
350 case S_MAGIC_PROC
: /* 0x9FA0 */
352 case S_MAGIC_PSTOREFS
: /* 0x6165676C */
354 case S_MAGIC_QNX4
: /* 0x002F */
356 case S_MAGIC_RAMFS
: /* 0x858458F6 */
358 case S_MAGIC_REISERFS
: /* 0x52654973 */
360 case S_MAGIC_ROMFS
: /* 0x7275 */
362 case S_MAGIC_RPC_PIPEFS
: /* 0x67596969 */
364 case S_MAGIC_SECURITYFS
: /* 0x73636673 */
366 case S_MAGIC_SELINUX
: /* 0xF97CFF8C */
368 case S_MAGIC_SMB
: /* 0x517B */
370 case S_MAGIC_SOCKFS
: /* 0x534F434B */
372 case S_MAGIC_SQUASHFS
: /* 0x73717368 */
374 case S_MAGIC_SYSFS
: /* 0x62656572 */
376 case S_MAGIC_SYSV2
: /* 0x012FF7B6 */
378 case S_MAGIC_SYSV4
: /* 0x012FF7B5 */
380 case S_MAGIC_TMPFS
: /* 0x01021994 */
382 case S_MAGIC_UDF
: /* 0x15013346 */
384 case S_MAGIC_UFS
: /* 0x00011954 */
386 case S_MAGIC_UFS_BYTESWAPPED
: /* 0x54190100 */
388 case S_MAGIC_USBDEVFS
: /* 0x9FA2 */
390 case S_MAGIC_V9FS
: /* 0x01021997 */
392 case S_MAGIC_VXFS
: /* 0xA501FCF5 */
394 case S_MAGIC_XENFS
: /* 0xABBA1974 */
396 case S_MAGIC_XENIX
: /* 0x012FF7B4 */
398 case S_MAGIC_XFS
: /* 0x58465342 */
400 case S_MAGIC_XIAFS
: /* 0x012FD16D */
461 unsigned long int type
= statfsbuf
->f_type
;
462 static char buf
[sizeof "UNKNOWN (0x%lx)" - 3
463 + (sizeof type
* CHAR_BIT
+ 3) / 4];
464 sprintf (buf
, "UNKNOWN (0x%lx)", type
);
471 static char * ATTRIBUTE_WARN_UNUSED_RESULT
472 human_access (struct stat
const *statbuf
)
474 static char modebuf
[12];
475 filemodestring (statbuf
, modebuf
);
480 static char * ATTRIBUTE_WARN_UNUSED_RESULT
481 human_time (struct timespec t
)
483 static char str
[MAX (INT_BUFSIZE_BOUND (intmax_t),
484 (INT_STRLEN_BOUND (int) /* YYYY */
485 + 1 /* because YYYY might equal INT_MAX + 1900 */
486 + sizeof "-MM-DD HH:MM:SS.NNNNNNNNN +ZZZZ"))];
487 struct tm
const *tm
= localtime (&t
.tv_sec
);
489 return timetostr (t
.tv_sec
, str
);
490 nstrftime (str
, sizeof str
, "%Y-%m-%d %H:%M:%S.%N %z", tm
, 0, t
.tv_nsec
);
494 /* PFORMAT points to a '%' followed by a prefix of a format, all of
495 size PREFIX_LEN. The flags allowed for this format are
496 ALLOWED_FLAGS; remove other printf flags from the prefix, then
499 make_format (char *pformat
, size_t prefix_len
, char const *allowed_flags
,
502 char *dst
= pformat
+ 1;
504 char const *srclim
= pformat
+ prefix_len
;
505 for (src
= dst
; src
< srclim
&& strchr (printf_flags
, *src
); src
++)
506 if (strchr (allowed_flags
, *src
))
510 strcpy (dst
, suffix
);
514 out_string (char *pformat
, size_t prefix_len
, char const *arg
)
516 make_format (pformat
, prefix_len
, "-", "s");
517 printf (pformat
, arg
);
520 out_int (char *pformat
, size_t prefix_len
, intmax_t arg
)
522 make_format (pformat
, prefix_len
, "'-+ 0", PRIdMAX
);
523 return printf (pformat
, arg
);
526 out_uint (char *pformat
, size_t prefix_len
, uintmax_t arg
)
528 make_format (pformat
, prefix_len
, "'-0", PRIuMAX
);
529 return printf (pformat
, arg
);
532 out_uint_o (char *pformat
, size_t prefix_len
, uintmax_t arg
)
534 make_format (pformat
, prefix_len
, "-#0", PRIoMAX
);
535 printf (pformat
, arg
);
538 out_uint_x (char *pformat
, size_t prefix_len
, uintmax_t arg
)
540 make_format (pformat
, prefix_len
, "-#0", PRIxMAX
);
541 printf (pformat
, arg
);
544 out_minus_zero (char *pformat
, size_t prefix_len
)
546 make_format (pformat
, prefix_len
, "'-+ 0", ".0f");
547 return printf (pformat
, -0.25);
550 /* Output the number of seconds since the Epoch, using a format that
551 acts like printf's %f format. */
553 out_epoch_sec (char *pformat
, size_t prefix_len
, struct stat
const *statbuf
,
556 char *dot
= memchr (pformat
, '.', prefix_len
);
557 size_t sec_prefix_len
= prefix_len
;
560 bool frac_left_adjust
= false;
564 sec_prefix_len
= dot
- pformat
;
565 pformat
[prefix_len
] = '\0';
567 if (ISDIGIT (dot
[1]))
569 long int lprec
= strtol (dot
+ 1, NULL
, 10);
570 precision
= (lprec
<= INT_MAX
? lprec
: INT_MAX
);
577 if (precision
&& ISDIGIT (dot
[-1]))
579 /* If a nontrivial width is given, subtract the width of the
580 decimal point and PRECISION digits that will be output
587 while (ISDIGIT (p
[-1]));
589 long int lwidth
= strtol (p
, NULL
, 10);
590 width
= (lwidth
<= INT_MAX
? lwidth
: INT_MAX
);
594 sec_prefix_len
= p
- pformat
;
595 int w_d
= (decimal_point_len
< width
596 ? width
- decimal_point_len
600 int w
= w_d
- precision
;
604 for (char const *src
= dst
; src
< p
; src
++)
607 frac_left_adjust
= true;
613 + (frac_left_adjust
? 0 : sprintf (dst
, "%d", w
)));
621 for (int i
= precision
; i
< 9; i
++)
623 int frac_sec
= arg
.tv_nsec
/ divisor
;
626 if (TYPE_SIGNED (time_t))
628 bool minus_zero
= false;
629 if (arg
.tv_sec
< 0 && arg
.tv_nsec
!= 0)
631 int frac_sec_modulus
= 1000000000 / divisor
;
632 frac_sec
= (frac_sec_modulus
- frac_sec
633 - (arg
.tv_nsec
% divisor
!= 0));
634 arg
.tv_sec
+= (frac_sec
!= 0);
635 minus_zero
= (arg
.tv_sec
== 0);
637 int_len
= (minus_zero
638 ? out_minus_zero (pformat
, sec_prefix_len
)
639 : out_int (pformat
, sec_prefix_len
, arg
.tv_sec
));
642 int_len
= out_uint (pformat
, sec_prefix_len
, arg
.tv_sec
);
646 int prec
= (precision
< 9 ? precision
: 9);
647 int trailing_prec
= precision
- prec
;
648 int ilen
= (int_len
< 0 ? 0 : int_len
);
649 int trailing_width
= (ilen
< width
&& decimal_point_len
< width
- ilen
650 ? width
- ilen
- decimal_point_len
- prec
652 printf ("%s%.*d%-*.*d", decimal_point
, prec
, frac_sec
,
653 trailing_width
, trailing_prec
, 0);
657 /* Print the context information of FILENAME, and return true iff the
658 context could not be obtained. */
659 static bool ATTRIBUTE_WARN_UNUSED_RESULT
660 out_file_context (char *pformat
, size_t prefix_len
, char const *filename
)
666 ? getfilecon (filename
, &scontext
)
667 : lgetfilecon (filename
, &scontext
)) < 0)
669 error (0, errno
, _("failed to get security context of %s"),
674 strcpy (pformat
+ prefix_len
, "s");
675 printf (pformat
, (scontext
? scontext
: "?"));
681 /* Print statfs info. Return zero upon success, nonzero upon failure. */
682 static bool ATTRIBUTE_WARN_UNUSED_RESULT
683 print_statfs (char *pformat
, size_t prefix_len
, unsigned int m
,
684 char const *filename
,
687 STRUCT_STATVFS
const *statfsbuf
= data
;
693 out_string (pformat
, prefix_len
, filename
);
698 #if STRUCT_STATXFS_F_FSID_IS_INTEGER
699 uintmax_t fsid
= statfsbuf
->f_fsid
;
701 typedef unsigned int fsid_word
;
702 verify (alignof (STRUCT_STATVFS
) % alignof (fsid_word
) == 0);
703 verify (offsetof (STRUCT_STATVFS
, f_fsid
) % alignof (fsid_word
) == 0);
704 verify (sizeof statfsbuf
->f_fsid
% alignof (fsid_word
) == 0);
705 fsid_word
const *p
= (fsid_word
*) &statfsbuf
->f_fsid
;
707 /* Assume a little-endian word order, as that is compatible
708 with glibc's statvfs implementation. */
710 int words
= sizeof statfsbuf
->f_fsid
/ sizeof *p
;
712 for (i
= 0; i
< words
&& i
* sizeof *p
< sizeof fsid
; i
++)
714 uintmax_t u
= p
[words
- 1 - i
];
715 fsid
|= u
<< (i
* CHAR_BIT
* sizeof *p
);
718 out_uint_x (pformat
, prefix_len
, fsid
);
723 OUT_NAMEMAX (pformat
, prefix_len
, SB_F_NAMEMAX (statfsbuf
));
726 #if HAVE_STRUCT_STATXFS_F_TYPE
727 out_uint_x (pformat
, prefix_len
, statfsbuf
->f_type
);
733 out_string (pformat
, prefix_len
, human_fstype (statfsbuf
));
736 out_int (pformat
, prefix_len
, statfsbuf
->f_blocks
);
739 out_int (pformat
, prefix_len
, statfsbuf
->f_bfree
);
742 out_int (pformat
, prefix_len
, statfsbuf
->f_bavail
);
745 out_uint (pformat
, prefix_len
, statfsbuf
->f_bsize
);
749 uintmax_t frsize
= STATFS_FRSIZE (statfsbuf
);
751 frsize
= statfsbuf
->f_bsize
;
752 out_uint (pformat
, prefix_len
, frsize
);
756 out_uint (pformat
, prefix_len
, statfsbuf
->f_files
);
759 out_int (pformat
, prefix_len
, statfsbuf
->f_ffree
);
768 /* Return any bind mounted source for a path.
769 The caller should not free the returned buffer.
770 Return NULL if no bind mount found. */
771 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
772 find_bind_mount (char const * name
)
774 char const * bind_mount
= NULL
;
776 static struct mount_entry
*mount_list
;
777 static bool tried_mount_list
= false;
778 if (!tried_mount_list
) /* attempt/warn once per process. */
780 if (!(mount_list
= read_file_system_list (false)))
781 error (0, errno
, "%s", _("cannot read table of mounted file systems"));
782 tried_mount_list
= true;
785 struct mount_entry
*me
;
786 for (me
= mount_list
; me
; me
= me
->me_next
)
788 if (me
->me_dummy
&& me
->me_devname
[0] == '/'
789 && STREQ (me
->me_mountdir
, name
))
791 struct stat name_stats
;
792 struct stat dev_stats
;
794 if (stat (name
, &name_stats
) == 0
795 && stat (me
->me_devname
, &dev_stats
) == 0
796 && SAME_INODE (name_stats
, dev_stats
))
798 bind_mount
= me
->me_devname
;
807 /* Print mount point. Return zero upon success, nonzero upon failure. */
808 static bool ATTRIBUTE_WARN_UNUSED_RESULT
809 out_mount_point (char const *filename
, char *pformat
, size_t prefix_len
,
810 const struct stat
*statp
)
813 char const *np
= "?", *bp
= NULL
;
817 /* Look for bind mounts first. Note we output the immediate alias,
818 rather than further resolving to a base device mount point. */
819 if (follow_links
|| !S_ISLNK (statp
->st_mode
))
821 char *resolved
= canonicalize_file_name (filename
);
824 error (0, errno
, _("failed to canonicalize %s"), quote (filename
));
825 goto print_mount_point
;
827 bp
= find_bind_mount (resolved
);
832 goto print_mount_point
;
836 /* If there is no direct bind mount, then navigate
837 back up the tree looking for a device change.
838 Note we don't detect if any of the directory components
839 are bind mounted to the same device, but that's OK
840 since we've not directly queried them. */
841 if ((mp
= find_mount_point (filename
, statp
)))
843 /* This dir might be bind mounted to another device,
844 so we resolve the bound source in that case also. */
845 bp
= find_bind_mount (mp
);
851 out_string (pformat
, prefix_len
, bp
? bp
: mp
? mp
: np
);
856 /* Map a TS with negative TS.tv_nsec to {0,0}. */
857 static inline struct timespec
858 neg_to_zero (struct timespec ts
)
862 struct timespec z
= {0, 0};
866 /* Print stat info. Return zero upon success, nonzero upon failure. */
868 print_stat (char *pformat
, size_t prefix_len
, unsigned int m
,
869 char const *filename
, void const *data
)
871 struct stat
*statbuf
= (struct stat
*) data
;
872 struct passwd
*pw_ent
;
873 struct group
*gw_ent
;
879 out_string (pformat
, prefix_len
, filename
);
882 out_string (pformat
, prefix_len
, quote (filename
));
883 if (S_ISLNK (statbuf
->st_mode
))
885 char *linkname
= areadlink_with_size (filename
, statbuf
->st_size
);
886 if (linkname
== NULL
)
888 error (0, errno
, _("cannot read symbolic link %s"),
893 out_string (pformat
, prefix_len
, quote (linkname
));
898 out_uint (pformat
, prefix_len
, statbuf
->st_dev
);
901 out_uint_x (pformat
, prefix_len
, statbuf
->st_dev
);
904 out_uint (pformat
, prefix_len
, statbuf
->st_ino
);
907 out_uint_o (pformat
, prefix_len
, statbuf
->st_mode
& CHMOD_MODE_BITS
);
910 out_string (pformat
, prefix_len
, human_access (statbuf
));
913 out_uint_x (pformat
, prefix_len
, statbuf
->st_mode
);
916 out_string (pformat
, prefix_len
, file_type (statbuf
));
919 out_uint (pformat
, prefix_len
, statbuf
->st_nlink
);
922 out_uint (pformat
, prefix_len
, statbuf
->st_uid
);
926 pw_ent
= getpwuid (statbuf
->st_uid
);
927 out_string (pformat
, prefix_len
,
928 pw_ent
? pw_ent
->pw_name
: "UNKNOWN");
931 out_uint (pformat
, prefix_len
, statbuf
->st_gid
);
935 gw_ent
= getgrgid (statbuf
->st_gid
);
936 out_string (pformat
, prefix_len
,
937 gw_ent
? gw_ent
->gr_name
: "UNKNOWN");
940 out_uint_x (pformat
, prefix_len
, major (statbuf
->st_rdev
));
943 fail
|= out_mount_point (filename
, pformat
, prefix_len
, statbuf
);
946 out_uint_x (pformat
, prefix_len
, minor (statbuf
->st_rdev
));
949 out_uint (pformat
, prefix_len
, statbuf
->st_size
);
952 out_uint (pformat
, prefix_len
, ST_NBLOCKSIZE
);
955 out_uint (pformat
, prefix_len
, ST_NBLOCKS (*statbuf
));
958 out_uint (pformat
, prefix_len
, ST_BLKSIZE (*statbuf
));
962 struct timespec t
= get_stat_birthtime (statbuf
);
964 out_string (pformat
, prefix_len
, "-");
966 out_string (pformat
, prefix_len
, human_time (t
));
970 out_epoch_sec (pformat
, prefix_len
, statbuf
,
971 neg_to_zero (get_stat_birthtime (statbuf
)));
974 out_string (pformat
, prefix_len
, human_time (get_stat_atime (statbuf
)));
977 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_atime (statbuf
));
980 out_string (pformat
, prefix_len
, human_time (get_stat_mtime (statbuf
)));
983 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_mtime (statbuf
));
986 out_string (pformat
, prefix_len
, human_time (get_stat_ctime (statbuf
)));
989 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_ctime (statbuf
));
992 fail
|= out_file_context (pformat
, prefix_len
, filename
);
1001 /* Output a single-character \ escape. */
1004 print_esc_char (char c
)
1008 case 'a': /* Alert. */
1011 case 'b': /* Backspace. */
1014 case 'e': /* Escape. */
1017 case 'f': /* Form feed. */
1020 case 'n': /* New line. */
1023 case 'r': /* Carriage return. */
1026 case 't': /* Horizontal tab. */
1029 case 'v': /* Vertical tab. */
1036 error (0, 0, _("warning: unrecognized escape `\\%c'"), c
);
1042 /* Print the information specified by the format string, FORMAT,
1043 calling PRINT_FUNC for each %-directive encountered.
1044 Return zero upon success, nonzero upon failure. */
1045 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1046 print_it (char const *format
, char const *filename
,
1047 bool (*print_func
) (char *, size_t, unsigned int,
1048 char const *, void const *),
1053 /* Add 2 to accommodate our conversion of the stat `%s' format string
1054 to the longer printf `%llu' one. */
1057 MAX_ADDITIONAL_BYTES
=
1058 (MAX (sizeof PRIdMAX
,
1059 MAX (sizeof PRIoMAX
, MAX (sizeof PRIuMAX
, sizeof PRIxMAX
)))
1062 size_t n_alloc
= strlen (format
) + MAX_ADDITIONAL_BYTES
+ 1;
1063 char *dest
= xmalloc (n_alloc
);
1065 for (b
= format
; *b
; b
++)
1071 size_t len
= strspn (b
+ 1, printf_flags
);
1072 char const *fmt_char
= b
+ len
+ 1;
1073 fmt_char
+= strspn (fmt_char
, digits
);
1074 if (*fmt_char
== '.')
1075 fmt_char
+= 1 + strspn (fmt_char
+ 1, digits
);
1076 len
= fmt_char
- (b
+ 1);
1077 unsigned int fmt_code
= *fmt_char
;
1078 memcpy (dest
, b
, len
+ 1);
1089 dest
[len
+ 1] = *fmt_char
;
1090 dest
[len
+ 2] = '\0';
1091 error (EXIT_FAILURE
, 0, _("%s: invalid directive"),
1092 quotearg_colon (dest
));
1097 fail
|= print_func (dest
, len
+ 1, fmt_code
, filename
, data
);
1104 if ( ! interpret_backslash_escapes
)
1112 int esc_value
= octtobin (*b
);
1113 int esc_length
= 1; /* number of octal digits */
1114 for (++b
; esc_length
< 3 && isodigit (*b
);
1117 esc_value
= esc_value
* 8 + octtobin (*b
);
1119 putchar (esc_value
);
1122 else if (*b
== 'x' && isxdigit (to_uchar (b
[1])))
1124 int esc_value
= hextobin (b
[1]); /* Value of \xhh escape. */
1125 /* A hexadecimal \xhh escape sequence must have
1126 1 or 2 hex. digits. */
1128 if (isxdigit (to_uchar (b
[1])))
1131 esc_value
= esc_value
* 16 + hextobin (*b
);
1133 putchar (esc_value
);
1135 else if (*b
== '\0')
1137 error (0, 0, _("warning: backslash at end of format"));
1139 /* Arrange to exit the loop. */
1144 print_esc_char (*b
);
1155 fputs (trailing_delim
, stdout
);
1160 /* Stat the file system and print what we find. */
1161 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1162 do_statfs (char const *filename
, bool terse
, char const *format
)
1164 STRUCT_STATVFS statfsbuf
;
1166 if (STREQ (filename
, "-"))
1168 error (0, 0, _("using %s to denote standard input does not work"
1169 " in file system mode"), quote (filename
));
1173 if (STATFS (filename
, &statfsbuf
) != 0)
1175 error (0, errno
, _("cannot read file system information for %s"),
1180 bool fail
= print_it (format
, filename
, print_statfs
, &statfsbuf
);
1184 /* stat the file and print what we find */
1185 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1186 do_stat (char const *filename
, bool terse
, char const *format
,
1187 char const *format2
)
1189 struct stat statbuf
;
1191 if (STREQ (filename
, "-"))
1193 if (fstat (STDIN_FILENO
, &statbuf
) != 0)
1195 error (0, errno
, _("cannot stat standard input"));
1199 /* We can't use the shorter
1200 (follow_links?stat:lstat) (filename, &statbug)
1201 since stat might be a function-like macro. */
1202 else if ((follow_links
1203 ? stat (filename
, &statbuf
)
1204 : lstat (filename
, &statbuf
)) != 0)
1206 error (0, errno
, _("cannot stat %s"), quote (filename
));
1210 if (S_ISBLK (statbuf
.st_mode
) || S_ISCHR (statbuf
.st_mode
))
1213 bool fail
= print_it (format
, filename
, print_stat
, &statbuf
);
1217 /* Return an allocated format string in static storage that
1218 corresponds to whether FS and TERSE options were declared. */
1220 default_format (bool fs
, bool terse
, bool device
)
1226 format
= xstrdup ("%n %i %l %t %s %S %b %f %a %c %d\n");
1229 /* TRANSLATORS: This string uses format specifiers from
1230 'stat --help' with --file-system, and NOT from printf. */
1231 format
= xstrdup (_("\
1233 ID: %-8i Namelen: %-7l Type: %T\n\
1234 Block size: %-10s Fundamental block size: %S\n\
1235 Blocks: Total: %-10b Free: %-10f Available: %a\n\
1236 Inodes: Total: %-10c Free: %d\n\
1244 if (0 < is_selinux_enabled ())
1245 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1246 " %X %Y %Z %W %o %C\n");
1248 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1249 " %X %Y %Z %W %o\n");
1254 /* TRANSLATORS: This string uses format specifiers from
1255 'stat --help' without --file-system, and NOT from printf. */
1256 format
= xstrdup (_("\
1258 Size: %-10s\tBlocks: %-10b IO Block: %-6o %F\n\
1264 /* TRANSLATORS: This string uses format specifiers from
1265 'stat --help' without --file-system, and NOT from printf. */
1266 format
= xasprintf ("%s%s", format
, _("\
1267 Device: %Dh/%dd\tInode: %-10i Links: %-5h Device type: %t,%T\n\
1272 /* TRANSLATORS: This string uses format specifiers from
1273 'stat --help' without --file-system, and NOT from printf. */
1274 format
= xasprintf ("%s%s", format
, _("\
1275 Device: %Dh/%dd\tInode: %-10i Links: %h\n\
1281 /* TRANSLATORS: This string uses format specifiers from
1282 'stat --help' without --file-system, and NOT from printf. */
1283 format
= xasprintf ("%s%s", format
, _("\
1284 Access: (%04a/%10.10A) Uid: (%5u/%8U) Gid: (%5g/%8G)\n\
1288 if (0 < is_selinux_enabled ())
1291 /* TRANSLATORS: This string uses format specifiers from
1292 'stat --help' without --file-system, and NOT from printf. */
1293 format
= xasprintf ("%s%s", format
, _("\
1300 /* TRANSLATORS: This string uses format specifiers from
1301 'stat --help' without --file-system, and NOT from printf. */
1302 format
= xasprintf ("%s%s", format
, _("\
1317 if (status
!= EXIT_SUCCESS
)
1318 fprintf (stderr
, _("Try `%s --help' for more information.\n"),
1322 printf (_("Usage: %s [OPTION]... FILE...\n"), program_name
);
1324 Display file or file system status.\n\
1326 -L, --dereference follow links\n\
1327 -f, --file-system display file system status instead of file status\n\
1330 -c --format=FORMAT use the specified FORMAT instead of the default;\n\
1331 output a newline after each use of FORMAT\n\
1332 --printf=FORMAT like --format, but interpret backslash escapes,\n\
1333 and do not output a mandatory trailing newline.\n\
1334 If you want a newline, include \\n in FORMAT\n\
1335 -t, --terse print the information in terse form\n\
1337 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
1338 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
1341 The valid format sequences for files (without --file-system):\n\
1343 %a Access rights in octal\n\
1344 %A Access rights in human readable form\n\
1345 %b Number of blocks allocated (see %B)\n\
1346 %B The size in bytes of each block reported by %b\n\
1347 %C SELinux security context string\n\
1350 %d Device number in decimal\n\
1351 %D Device number in hex\n\
1352 %f Raw mode in hex\n\
1354 %g Group ID of owner\n\
1355 %G Group name of owner\n\
1358 %h Number of hard links\n\
1362 %N Quoted file name with dereference if symbolic link\n\
1363 %o I/O block size\n\
1364 %s Total size, in bytes\n\
1365 %t Major device type in hex\n\
1366 %T Minor device type in hex\n\
1369 %u User ID of owner\n\
1370 %U User name of owner\n\
1371 %w Time of file birth, human-readable; - if unknown\n\
1372 %W Time of file birth, seconds since Epoch; 0 if unknown\n\
1373 %x Time of last access, human-readable\n\
1374 %X Time of last access, seconds since Epoch\n\
1375 %y Time of last modification, human-readable\n\
1376 %Y Time of last modification, seconds since Epoch\n\
1377 %z Time of last change, human-readable\n\
1378 %Z Time of last change, seconds since Epoch\n\
1383 Valid format sequences for file systems:\n\
1385 %a Free blocks available to non-superuser\n\
1386 %b Total data blocks in file system\n\
1387 %c Total file nodes in file system\n\
1388 %d Free file nodes in file system\n\
1389 %f Free blocks in file system\n\
1392 %i File System ID in hex\n\
1393 %l Maximum length of filenames\n\
1395 %s Block size (for faster transfers)\n\
1396 %S Fundamental block size (for block counts)\n\
1398 %T Type in human readable form\n\
1400 printf (USAGE_BUILTIN_WARNING
, PROGRAM_NAME
);
1401 emit_ancillary_info ();
1407 main (int argc
, char *argv
[])
1413 char *format
= NULL
;
1417 initialize_main (&argc
, &argv
);
1418 set_program_name (argv
[0]);
1419 setlocale (LC_ALL
, "");
1420 bindtextdomain (PACKAGE
, LOCALEDIR
);
1421 textdomain (PACKAGE
);
1423 struct lconv
const *locale
= localeconv ();
1424 decimal_point
= (locale
->decimal_point
[0] ? locale
->decimal_point
: ".");
1425 decimal_point_len
= strlen (decimal_point
);
1427 atexit (close_stdout
);
1429 while ((c
= getopt_long (argc
, argv
, "c:fLt", long_options
, NULL
)) != -1)
1435 interpret_backslash_escapes
= true;
1436 trailing_delim
= "";
1441 interpret_backslash_escapes
= false;
1442 trailing_delim
= "\n";
1446 follow_links
= true;
1457 case_GETOPT_HELP_CHAR
;
1459 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
1462 usage (EXIT_FAILURE
);
1468 error (0, 0, _("missing operand"));
1469 usage (EXIT_FAILURE
);
1476 format
= default_format (fs
, terse
, false);
1477 format2
= default_format (fs
, terse
, true);
1480 for (i
= optind
; i
< argc
; i
++)
1482 ? do_statfs (argv
[i
], terse
, format
)
1483 : do_stat (argv
[i
], terse
, format
, format2
));
1485 exit (ok
? EXIT_SUCCESS
: EXIT_FAILURE
);