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 # 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 local */
242 case S_MAGIC_AFFS
: /* 0xADFF local */
244 case S_MAGIC_AFS
: /* 0x5346414F remote */
246 case S_MAGIC_ANON_INODE_FS
: /* 0x09041934 local */
247 return "anon-inode FS";
248 case S_MAGIC_AUTOFS
: /* 0x0187 local */
250 case S_MAGIC_BEFS
: /* 0x42465331 local */
252 case S_MAGIC_BFS
: /* 0x1BADFACE local */
254 case S_MAGIC_BINFMT_MISC
: /* 0x42494E4D local */
255 return "binfmt_misc";
256 case S_MAGIC_BTRFS
: /* 0x9123683E local */
258 case S_MAGIC_CGROUP
: /* 0x0027E0EB local */
260 case S_MAGIC_CIFS
: /* 0xFF534D42 remote */
262 case S_MAGIC_CODA
: /* 0x73757245 remote */
264 case S_MAGIC_COH
: /* 0x012FF7B7 local */
266 case S_MAGIC_CRAMFS
: /* 0x28CD3D45 local */
268 case S_MAGIC_CRAMFS_WEND
: /* 0x453DCD28 local */
269 return "cramfs-wend";
270 case S_MAGIC_DEBUGFS
: /* 0x64626720 local */
272 case S_MAGIC_DEVFS
: /* 0x1373 local */
274 case S_MAGIC_DEVPTS
: /* 0x1CD1 local */
276 case S_MAGIC_ECRYPTFS
: /* 0xF15F local */
278 case S_MAGIC_EFS
: /* 0x00414A53 local */
280 case S_MAGIC_EXT
: /* 0x137D local */
282 case S_MAGIC_EXT2
: /* 0xEF53 local */
284 case S_MAGIC_EXT2_OLD
: /* 0xEF51 local */
286 case S_MAGIC_FAT
: /* 0x4006 local */
288 case S_MAGIC_FHGFS
: /* 0x19830326 remote */
290 case S_MAGIC_FUSEBLK
: /* 0x65735546 remote */
292 case S_MAGIC_FUSECTL
: /* 0x65735543 remote */
294 case S_MAGIC_FUTEXFS
: /* 0x0BAD1DEA local */
296 case S_MAGIC_GFS
: /* 0x1161970 remote */
298 case S_MAGIC_GPFS
: /* 0x47504653 remote */
300 case S_MAGIC_HFS
: /* 0x4244 local */
302 case S_MAGIC_HPFS
: /* 0xF995E849 local */
304 case S_MAGIC_HUGETLBFS
: /* 0x958458F6 local */
306 case S_MAGIC_INOTIFYFS
: /* 0x2BAD1DEA local */
308 case S_MAGIC_ISOFS
: /* 0x9660 local */
310 case S_MAGIC_ISOFS_R_WIN
: /* 0x4004 local */
312 case S_MAGIC_ISOFS_WIN
: /* 0x4000 local */
314 case S_MAGIC_JFFS
: /* 0x07C0 local */
316 case S_MAGIC_JFFS2
: /* 0x72B6 local */
318 case S_MAGIC_JFS
: /* 0x3153464A local */
320 case S_MAGIC_KAFS
: /* 0x6B414653 remote */
322 case S_MAGIC_LUSTRE
: /* 0x0BD00BD0 remote */
324 case S_MAGIC_MINIX
: /* 0x137F local */
326 case S_MAGIC_MINIX_30
: /* 0x138F local */
327 return "minix (30 char.)";
328 case S_MAGIC_MINIX_V2
: /* 0x2468 local */
330 case S_MAGIC_MINIX_V2_30
: /* 0x2478 local */
331 return "minix v2 (30 char.)";
332 case S_MAGIC_MINIX_V3
: /* 0x4D5A local */
334 case S_MAGIC_MQUEUE
: /* 0x19800202 local */
336 case S_MAGIC_MSDOS
: /* 0x4D44 local */
338 case S_MAGIC_NCP
: /* 0x564C remote */
340 case S_MAGIC_NFS
: /* 0x6969 remote */
342 case S_MAGIC_NFSD
: /* 0x6E667364 remote */
344 case S_MAGIC_NILFS
: /* 0x3434 local */
346 case S_MAGIC_NTFS
: /* 0x5346544E local */
348 case S_MAGIC_OPENPROM
: /* 0x9FA1 local */
350 case S_MAGIC_OCFS2
: /* 0x7461636f remote */
352 case S_MAGIC_PIPEFS
: /* 0x50495045 remote */
353 /* FIXME: change syntax or add an optional attribute like "inotify:no".
354 The above is labeled as "remote" so that tail always uses polling,
355 but this isn't really a remote file system type. */
357 case S_MAGIC_PROC
: /* 0x9FA0 local */
359 case S_MAGIC_PSTOREFS
: /* 0x6165676C local */
361 case S_MAGIC_QNX4
: /* 0x002F local */
363 case S_MAGIC_RAMFS
: /* 0x858458F6 local */
365 case S_MAGIC_REISERFS
: /* 0x52654973 local */
367 case S_MAGIC_ROMFS
: /* 0x7275 local */
369 case S_MAGIC_RPC_PIPEFS
: /* 0x67596969 local */
371 case S_MAGIC_SECURITYFS
: /* 0x73636673 local */
373 case S_MAGIC_SELINUX
: /* 0xF97CFF8C local */
375 case S_MAGIC_SMB
: /* 0x517B remote */
377 case S_MAGIC_SOCKFS
: /* 0x534F434B local */
379 case S_MAGIC_SQUASHFS
: /* 0x73717368 local */
381 case S_MAGIC_SYSFS
: /* 0x62656572 local */
383 case S_MAGIC_SYSV2
: /* 0x012FF7B6 local */
385 case S_MAGIC_SYSV4
: /* 0x012FF7B5 local */
387 case S_MAGIC_TMPFS
: /* 0x01021994 local */
389 case S_MAGIC_UDF
: /* 0x15013346 local */
391 case S_MAGIC_UFS
: /* 0x00011954 local */
393 case S_MAGIC_UFS_BYTESWAPPED
: /* 0x54190100 local */
395 case S_MAGIC_USBDEVFS
: /* 0x9FA2 local */
397 case S_MAGIC_V9FS
: /* 0x01021997 local */
399 case S_MAGIC_VXFS
: /* 0xA501FCF5 local */
401 case S_MAGIC_XENFS
: /* 0xABBA1974 local */
403 case S_MAGIC_XENIX
: /* 0x012FF7B4 local */
405 case S_MAGIC_XFS
: /* 0x58465342 local */
407 case S_MAGIC_XIAFS
: /* 0x012FD16D local */
468 unsigned long int type
= statfsbuf
->f_type
;
469 static char buf
[sizeof "UNKNOWN (0x%lx)" - 3
470 + (sizeof type
* CHAR_BIT
+ 3) / 4];
471 sprintf (buf
, "UNKNOWN (0x%lx)", type
);
478 static char * ATTRIBUTE_WARN_UNUSED_RESULT
479 human_access (struct stat
const *statbuf
)
481 static char modebuf
[12];
482 filemodestring (statbuf
, modebuf
);
487 static char * ATTRIBUTE_WARN_UNUSED_RESULT
488 human_time (struct timespec t
)
490 static char str
[MAX (INT_BUFSIZE_BOUND (intmax_t),
491 (INT_STRLEN_BOUND (int) /* YYYY */
492 + 1 /* because YYYY might equal INT_MAX + 1900 */
493 + sizeof "-MM-DD HH:MM:SS.NNNNNNNNN +ZZZZ"))];
494 struct tm
const *tm
= localtime (&t
.tv_sec
);
496 return timetostr (t
.tv_sec
, str
);
497 nstrftime (str
, sizeof str
, "%Y-%m-%d %H:%M:%S.%N %z", tm
, 0, t
.tv_nsec
);
501 /* PFORMAT points to a '%' followed by a prefix of a format, all of
502 size PREFIX_LEN. The flags allowed for this format are
503 ALLOWED_FLAGS; remove other printf flags from the prefix, then
506 make_format (char *pformat
, size_t prefix_len
, char const *allowed_flags
,
509 char *dst
= pformat
+ 1;
511 char const *srclim
= pformat
+ prefix_len
;
512 for (src
= dst
; src
< srclim
&& strchr (printf_flags
, *src
); src
++)
513 if (strchr (allowed_flags
, *src
))
517 strcpy (dst
, suffix
);
521 out_string (char *pformat
, size_t prefix_len
, char const *arg
)
523 make_format (pformat
, prefix_len
, "-", "s");
524 printf (pformat
, arg
);
527 out_int (char *pformat
, size_t prefix_len
, intmax_t arg
)
529 make_format (pformat
, prefix_len
, "'-+ 0", PRIdMAX
);
530 return printf (pformat
, arg
);
533 out_uint (char *pformat
, size_t prefix_len
, uintmax_t arg
)
535 make_format (pformat
, prefix_len
, "'-0", PRIuMAX
);
536 return printf (pformat
, arg
);
539 out_uint_o (char *pformat
, size_t prefix_len
, uintmax_t arg
)
541 make_format (pformat
, prefix_len
, "-#0", PRIoMAX
);
542 printf (pformat
, arg
);
545 out_uint_x (char *pformat
, size_t prefix_len
, uintmax_t arg
)
547 make_format (pformat
, prefix_len
, "-#0", PRIxMAX
);
548 printf (pformat
, arg
);
551 out_minus_zero (char *pformat
, size_t prefix_len
)
553 make_format (pformat
, prefix_len
, "'-+ 0", ".0f");
554 return printf (pformat
, -0.25);
557 /* Output the number of seconds since the Epoch, using a format that
558 acts like printf's %f format. */
560 out_epoch_sec (char *pformat
, size_t prefix_len
,
561 struct stat
const *statbuf ATTRIBUTE_UNUSED
,
564 char *dot
= memchr (pformat
, '.', prefix_len
);
565 size_t sec_prefix_len
= prefix_len
;
568 bool frac_left_adjust
= false;
572 sec_prefix_len
= dot
- pformat
;
573 pformat
[prefix_len
] = '\0';
575 if (ISDIGIT (dot
[1]))
577 long int lprec
= strtol (dot
+ 1, NULL
, 10);
578 precision
= (lprec
<= INT_MAX
? lprec
: INT_MAX
);
585 if (precision
&& ISDIGIT (dot
[-1]))
587 /* If a nontrivial width is given, subtract the width of the
588 decimal point and PRECISION digits that will be output
595 while (ISDIGIT (p
[-1]));
597 long int lwidth
= strtol (p
, NULL
, 10);
598 width
= (lwidth
<= INT_MAX
? lwidth
: INT_MAX
);
602 sec_prefix_len
= p
- pformat
;
603 int w_d
= (decimal_point_len
< width
604 ? width
- decimal_point_len
608 int w
= w_d
- precision
;
612 for (char const *src
= dst
; src
< p
; src
++)
615 frac_left_adjust
= true;
621 + (frac_left_adjust
? 0 : sprintf (dst
, "%d", w
)));
629 for (int i
= precision
; i
< 9; i
++)
631 int frac_sec
= arg
.tv_nsec
/ divisor
;
634 if (TYPE_SIGNED (time_t))
636 bool minus_zero
= false;
637 if (arg
.tv_sec
< 0 && arg
.tv_nsec
!= 0)
639 int frac_sec_modulus
= 1000000000 / divisor
;
640 frac_sec
= (frac_sec_modulus
- frac_sec
641 - (arg
.tv_nsec
% divisor
!= 0));
642 arg
.tv_sec
+= (frac_sec
!= 0);
643 minus_zero
= (arg
.tv_sec
== 0);
645 int_len
= (minus_zero
646 ? out_minus_zero (pformat
, sec_prefix_len
)
647 : out_int (pformat
, sec_prefix_len
, arg
.tv_sec
));
650 int_len
= out_uint (pformat
, sec_prefix_len
, arg
.tv_sec
);
654 int prec
= (precision
< 9 ? precision
: 9);
655 int trailing_prec
= precision
- prec
;
656 int ilen
= (int_len
< 0 ? 0 : int_len
);
657 int trailing_width
= (ilen
< width
&& decimal_point_len
< width
- ilen
658 ? width
- ilen
- decimal_point_len
- prec
660 printf ("%s%.*d%-*.*d", decimal_point
, prec
, frac_sec
,
661 trailing_width
, trailing_prec
, 0);
665 /* Print the context information of FILENAME, and return true iff the
666 context could not be obtained. */
667 static bool ATTRIBUTE_WARN_UNUSED_RESULT
668 out_file_context (char *pformat
, size_t prefix_len
, char const *filename
)
674 ? getfilecon (filename
, &scontext
)
675 : lgetfilecon (filename
, &scontext
)) < 0)
677 error (0, errno
, _("failed to get security context of %s"),
682 strcpy (pformat
+ prefix_len
, "s");
683 printf (pformat
, (scontext
? scontext
: "?"));
689 /* Print statfs info. Return zero upon success, nonzero upon failure. */
690 static bool ATTRIBUTE_WARN_UNUSED_RESULT
691 print_statfs (char *pformat
, size_t prefix_len
, unsigned int m
,
692 char const *filename
,
695 STRUCT_STATVFS
const *statfsbuf
= data
;
701 out_string (pformat
, prefix_len
, filename
);
706 #if STRUCT_STATXFS_F_FSID_IS_INTEGER
707 uintmax_t fsid
= statfsbuf
->f_fsid
;
709 typedef unsigned int fsid_word
;
710 verify (alignof (STRUCT_STATVFS
) % alignof (fsid_word
) == 0);
711 verify (offsetof (STRUCT_STATVFS
, f_fsid
) % alignof (fsid_word
) == 0);
712 verify (sizeof statfsbuf
->f_fsid
% alignof (fsid_word
) == 0);
713 fsid_word
const *p
= (fsid_word
*) &statfsbuf
->f_fsid
;
715 /* Assume a little-endian word order, as that is compatible
716 with glibc's statvfs implementation. */
718 int words
= sizeof statfsbuf
->f_fsid
/ sizeof *p
;
720 for (i
= 0; i
< words
&& i
* sizeof *p
< sizeof fsid
; i
++)
722 uintmax_t u
= p
[words
- 1 - i
];
723 fsid
|= u
<< (i
* CHAR_BIT
* sizeof *p
);
726 out_uint_x (pformat
, prefix_len
, fsid
);
731 OUT_NAMEMAX (pformat
, prefix_len
, SB_F_NAMEMAX (statfsbuf
));
734 #if HAVE_STRUCT_STATXFS_F_TYPE
735 out_uint_x (pformat
, prefix_len
, statfsbuf
->f_type
);
741 out_string (pformat
, prefix_len
, human_fstype (statfsbuf
));
744 out_int (pformat
, prefix_len
, statfsbuf
->f_blocks
);
747 out_int (pformat
, prefix_len
, statfsbuf
->f_bfree
);
750 out_int (pformat
, prefix_len
, statfsbuf
->f_bavail
);
753 out_uint (pformat
, prefix_len
, statfsbuf
->f_bsize
);
757 uintmax_t frsize
= STATFS_FRSIZE (statfsbuf
);
759 frsize
= statfsbuf
->f_bsize
;
760 out_uint (pformat
, prefix_len
, frsize
);
764 out_uint (pformat
, prefix_len
, statfsbuf
->f_files
);
767 out_int (pformat
, prefix_len
, statfsbuf
->f_ffree
);
776 /* Return any bind mounted source for a path.
777 The caller should not free the returned buffer.
778 Return NULL if no bind mount found. */
779 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
780 find_bind_mount (char const * name
)
782 char const * bind_mount
= NULL
;
784 static struct mount_entry
*mount_list
;
785 static bool tried_mount_list
= false;
786 if (!tried_mount_list
) /* attempt/warn once per process. */
788 if (!(mount_list
= read_file_system_list (false)))
789 error (0, errno
, "%s", _("cannot read table of mounted file systems"));
790 tried_mount_list
= true;
793 struct mount_entry
*me
;
794 for (me
= mount_list
; me
; me
= me
->me_next
)
796 if (me
->me_dummy
&& me
->me_devname
[0] == '/'
797 && STREQ (me
->me_mountdir
, name
))
799 struct stat name_stats
;
800 struct stat dev_stats
;
802 if (stat (name
, &name_stats
) == 0
803 && stat (me
->me_devname
, &dev_stats
) == 0
804 && SAME_INODE (name_stats
, dev_stats
))
806 bind_mount
= me
->me_devname
;
815 /* Print mount point. Return zero upon success, nonzero upon failure. */
816 static bool ATTRIBUTE_WARN_UNUSED_RESULT
817 out_mount_point (char const *filename
, char *pformat
, size_t prefix_len
,
818 const struct stat
*statp
)
821 char const *np
= "?", *bp
= NULL
;
825 /* Look for bind mounts first. Note we output the immediate alias,
826 rather than further resolving to a base device mount point. */
827 if (follow_links
|| !S_ISLNK (statp
->st_mode
))
829 char *resolved
= canonicalize_file_name (filename
);
832 error (0, errno
, _("failed to canonicalize %s"), quote (filename
));
833 goto print_mount_point
;
835 bp
= find_bind_mount (resolved
);
840 goto print_mount_point
;
844 /* If there is no direct bind mount, then navigate
845 back up the tree looking for a device change.
846 Note we don't detect if any of the directory components
847 are bind mounted to the same device, but that's OK
848 since we've not directly queried them. */
849 if ((mp
= find_mount_point (filename
, statp
)))
851 /* This dir might be bind mounted to another device,
852 so we resolve the bound source in that case also. */
853 bp
= find_bind_mount (mp
);
859 out_string (pformat
, prefix_len
, bp
? bp
: mp
? mp
: np
);
864 /* Map a TS with negative TS.tv_nsec to {0,0}. */
865 static inline struct timespec
866 neg_to_zero (struct timespec ts
)
870 struct timespec z
= {0, 0};
874 /* Print stat info. Return zero upon success, nonzero upon failure. */
876 print_stat (char *pformat
, size_t prefix_len
, unsigned int m
,
877 char const *filename
, void const *data
)
879 struct stat
*statbuf
= (struct stat
*) data
;
880 struct passwd
*pw_ent
;
881 struct group
*gw_ent
;
887 out_string (pformat
, prefix_len
, filename
);
890 out_string (pformat
, prefix_len
, quote (filename
));
891 if (S_ISLNK (statbuf
->st_mode
))
893 char *linkname
= areadlink_with_size (filename
, statbuf
->st_size
);
894 if (linkname
== NULL
)
896 error (0, errno
, _("cannot read symbolic link %s"),
901 out_string (pformat
, prefix_len
, quote (linkname
));
906 out_uint (pformat
, prefix_len
, statbuf
->st_dev
);
909 out_uint_x (pformat
, prefix_len
, statbuf
->st_dev
);
912 out_uint (pformat
, prefix_len
, statbuf
->st_ino
);
915 out_uint_o (pformat
, prefix_len
, statbuf
->st_mode
& CHMOD_MODE_BITS
);
918 out_string (pformat
, prefix_len
, human_access (statbuf
));
921 out_uint_x (pformat
, prefix_len
, statbuf
->st_mode
);
924 out_string (pformat
, prefix_len
, file_type (statbuf
));
927 out_uint (pformat
, prefix_len
, statbuf
->st_nlink
);
930 out_uint (pformat
, prefix_len
, statbuf
->st_uid
);
934 pw_ent
= getpwuid (statbuf
->st_uid
);
935 out_string (pformat
, prefix_len
,
936 pw_ent
? pw_ent
->pw_name
: "UNKNOWN");
939 out_uint (pformat
, prefix_len
, statbuf
->st_gid
);
943 gw_ent
= getgrgid (statbuf
->st_gid
);
944 out_string (pformat
, prefix_len
,
945 gw_ent
? gw_ent
->gr_name
: "UNKNOWN");
948 out_uint_x (pformat
, prefix_len
, major (statbuf
->st_rdev
));
951 fail
|= out_mount_point (filename
, pformat
, prefix_len
, statbuf
);
954 out_uint_x (pformat
, prefix_len
, minor (statbuf
->st_rdev
));
957 out_uint (pformat
, prefix_len
, statbuf
->st_size
);
960 out_uint (pformat
, prefix_len
, ST_NBLOCKSIZE
);
963 out_uint (pformat
, prefix_len
, ST_NBLOCKS (*statbuf
));
966 out_uint (pformat
, prefix_len
, ST_BLKSIZE (*statbuf
));
970 struct timespec t
= get_stat_birthtime (statbuf
);
972 out_string (pformat
, prefix_len
, "-");
974 out_string (pformat
, prefix_len
, human_time (t
));
978 out_epoch_sec (pformat
, prefix_len
, statbuf
,
979 neg_to_zero (get_stat_birthtime (statbuf
)));
982 out_string (pformat
, prefix_len
, human_time (get_stat_atime (statbuf
)));
985 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_atime (statbuf
));
988 out_string (pformat
, prefix_len
, human_time (get_stat_mtime (statbuf
)));
991 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_mtime (statbuf
));
994 out_string (pformat
, prefix_len
, human_time (get_stat_ctime (statbuf
)));
997 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_ctime (statbuf
));
1000 fail
|= out_file_context (pformat
, prefix_len
, filename
);
1003 fputc ('?', stdout
);
1009 /* Output a single-character \ escape. */
1012 print_esc_char (char c
)
1016 case 'a': /* Alert. */
1019 case 'b': /* Backspace. */
1022 case 'e': /* Escape. */
1025 case 'f': /* Form feed. */
1028 case 'n': /* New line. */
1031 case 'r': /* Carriage return. */
1034 case 't': /* Horizontal tab. */
1037 case 'v': /* Vertical tab. */
1044 error (0, 0, _("warning: unrecognized escape '\\%c'"), c
);
1050 /* Print the information specified by the format string, FORMAT,
1051 calling PRINT_FUNC for each %-directive encountered.
1052 Return zero upon success, nonzero upon failure. */
1053 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1054 print_it (char const *format
, char const *filename
,
1055 bool (*print_func
) (char *, size_t, unsigned int,
1056 char const *, void const *),
1061 /* Add 2 to accommodate our conversion of the stat '%s' format string
1062 to the longer printf '%llu' one. */
1065 MAX_ADDITIONAL_BYTES
=
1066 (MAX (sizeof PRIdMAX
,
1067 MAX (sizeof PRIoMAX
, MAX (sizeof PRIuMAX
, sizeof PRIxMAX
)))
1070 size_t n_alloc
= strlen (format
) + MAX_ADDITIONAL_BYTES
+ 1;
1071 char *dest
= xmalloc (n_alloc
);
1073 for (b
= format
; *b
; b
++)
1079 size_t len
= strspn (b
+ 1, printf_flags
);
1080 char const *fmt_char
= b
+ len
+ 1;
1081 fmt_char
+= strspn (fmt_char
, digits
);
1082 if (*fmt_char
== '.')
1083 fmt_char
+= 1 + strspn (fmt_char
+ 1, digits
);
1084 len
= fmt_char
- (b
+ 1);
1085 unsigned int fmt_code
= *fmt_char
;
1086 memcpy (dest
, b
, len
+ 1);
1097 dest
[len
+ 1] = *fmt_char
;
1098 dest
[len
+ 2] = '\0';
1099 error (EXIT_FAILURE
, 0, _("%s: invalid directive"),
1100 quotearg_colon (dest
));
1105 fail
|= print_func (dest
, len
+ 1, fmt_code
, filename
, data
);
1112 if ( ! interpret_backslash_escapes
)
1120 int esc_value
= octtobin (*b
);
1121 int esc_length
= 1; /* number of octal digits */
1122 for (++b
; esc_length
< 3 && isodigit (*b
);
1125 esc_value
= esc_value
* 8 + octtobin (*b
);
1127 putchar (esc_value
);
1130 else if (*b
== 'x' && isxdigit (to_uchar (b
[1])))
1132 int esc_value
= hextobin (b
[1]); /* Value of \xhh escape. */
1133 /* A hexadecimal \xhh escape sequence must have
1134 1 or 2 hex. digits. */
1136 if (isxdigit (to_uchar (b
[1])))
1139 esc_value
= esc_value
* 16 + hextobin (*b
);
1141 putchar (esc_value
);
1143 else if (*b
== '\0')
1145 error (0, 0, _("warning: backslash at end of format"));
1147 /* Arrange to exit the loop. */
1152 print_esc_char (*b
);
1163 fputs (trailing_delim
, stdout
);
1168 /* Stat the file system and print what we find. */
1169 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1170 do_statfs (char const *filename
, char const *format
)
1172 STRUCT_STATVFS statfsbuf
;
1174 if (STREQ (filename
, "-"))
1176 error (0, 0, _("using %s to denote standard input does not work"
1177 " in file system mode"), quote (filename
));
1181 if (STATFS (filename
, &statfsbuf
) != 0)
1183 error (0, errno
, _("cannot read file system information for %s"),
1188 bool fail
= print_it (format
, filename
, print_statfs
, &statfsbuf
);
1192 /* stat the file and print what we find */
1193 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1194 do_stat (char const *filename
, char const *format
,
1195 char const *format2
)
1197 struct stat statbuf
;
1199 if (STREQ (filename
, "-"))
1201 if (fstat (STDIN_FILENO
, &statbuf
) != 0)
1203 error (0, errno
, _("cannot stat standard input"));
1207 /* We can't use the shorter
1208 (follow_links?stat:lstat) (filename, &statbug)
1209 since stat might be a function-like macro. */
1210 else if ((follow_links
1211 ? stat (filename
, &statbuf
)
1212 : lstat (filename
, &statbuf
)) != 0)
1214 error (0, errno
, _("cannot stat %s"), quote (filename
));
1218 if (S_ISBLK (statbuf
.st_mode
) || S_ISCHR (statbuf
.st_mode
))
1221 bool fail
= print_it (format
, filename
, print_stat
, &statbuf
);
1225 /* Return an allocated format string in static storage that
1226 corresponds to whether FS and TERSE options were declared. */
1228 default_format (bool fs
, bool terse
, bool device
)
1234 format
= xstrdup ("%n %i %l %t %s %S %b %f %a %c %d\n");
1237 /* TRANSLATORS: This string uses format specifiers from
1238 'stat --help' with --file-system, and NOT from printf. */
1239 format
= xstrdup (_(" File: \"%n\"\n"
1240 " ID: %-8i Namelen: %-7l Type: %T\n"
1241 "Block size: %-10s Fundamental block size: %S\n"
1242 "Blocks: Total: %-10b Free: %-10f Available: %a\n"
1243 "Inodes: Total: %-10c Free: %d\n"));
1250 if (0 < is_selinux_enabled ())
1251 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1252 " %X %Y %Z %W %o %C\n");
1254 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1255 " %X %Y %Z %W %o\n");
1260 /* TRANSLATORS: This string uses format specifiers from
1261 'stat --help' without --file-system, and NOT from printf. */
1262 format
= xstrdup (_("\
1264 Size: %-10s\tBlocks: %-10b IO Block: %-6o %F\n\
1270 /* TRANSLATORS: This string uses format specifiers from
1271 'stat --help' without --file-system, and NOT from printf. */
1272 format
= xasprintf ("%s%s", format
, _("\
1273 " "Device: %Dh/%dd\tInode: %-10i Links: %-5h Device type: %t,%T\n\
1278 /* TRANSLATORS: This string uses format specifiers from
1279 'stat --help' without --file-system, and NOT from printf. */
1280 format
= xasprintf ("%s%s", format
, _("\
1281 " "Device: %Dh/%dd\tInode: %-10i Links: %h\n\
1287 /* TRANSLATORS: This string uses format specifiers from
1288 'stat --help' without --file-system, and NOT from printf. */
1289 format
= xasprintf ("%s%s", format
, _("\
1290 " "Access: (%04a/%10.10A) Uid: (%5u/%8U) Gid: (%5g/%8G)\n\
1294 if (0 < is_selinux_enabled ())
1297 /* TRANSLATORS: This string uses format specifiers from
1298 'stat --help' without --file-system, and NOT from printf. */
1299 format
= xasprintf ("%s%s", format
, _("Context: %C\n"));
1304 /* TRANSLATORS: This string uses format specifiers from
1305 'stat --help' without --file-system, and NOT from printf. */
1306 format
= xasprintf ("%s%s", format
,
1320 if (status
!= EXIT_SUCCESS
)
1324 printf (_("Usage: %s [OPTION]... FILE...\n"), program_name
);
1326 Display file or file system status.\n\
1328 -L, --dereference follow links\n\
1329 -f, --file-system display file system status instead of file status\n\
1332 -c --format=FORMAT use the specified FORMAT instead of the default;\n\
1333 output a newline after each use of FORMAT\n\
1334 --printf=FORMAT like --format, but interpret backslash escapes,\n\
1335 and do not output a mandatory trailing newline.\n\
1336 If you want a newline, include \\n in FORMAT\n\
1337 -t, --terse print the information in terse form\n\
1339 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
1340 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
1343 The valid format sequences for files (without --file-system):\n\
1345 %a access rights in octal\n\
1346 %A access rights in human readable form\n\
1347 %b number of blocks allocated (see %B)\n\
1348 %B the size in bytes of each block reported by %b\n\
1349 %C SELinux security context string\n\
1352 %d device number in decimal\n\
1353 %D device number in hex\n\
1354 %f raw mode in hex\n\
1356 %g group ID of owner\n\
1357 %G group name of owner\n\
1360 %h number of hard links\n\
1364 %N quoted file name with dereference if symbolic link\n\
1365 %o optimal I/O transfer size hint\n\
1366 %s total size, in bytes\n\
1367 %t major device type in hex\n\
1368 %T minor device type in hex\n\
1371 %u user ID of owner\n\
1372 %U user name of owner\n\
1373 %w time of file birth, human-readable; - if unknown\n\
1374 %W time of file birth, seconds since Epoch; 0 if unknown\n\
1375 %x time of last access, human-readable\n\
1376 %X time of last access, seconds since Epoch\n\
1377 %y time of last modification, human-readable\n\
1378 %Y time of last modification, seconds since Epoch\n\
1379 %z time of last change, human-readable\n\
1380 %Z time of last change, seconds since Epoch\n\
1385 Valid format sequences for file systems:\n\
1387 %a free blocks available to non-superuser\n\
1388 %b total data blocks in file system\n\
1389 %c total file nodes in file system\n\
1390 %d free file nodes in file system\n\
1391 %f free blocks in file system\n\
1394 %i file system ID in hex\n\
1395 %l maximum length of filenames\n\
1397 %s block size (for faster transfers)\n\
1398 %S fundamental block size (for block counts)\n\
1399 %t file system type in hex\n\
1400 %T file system type in human readable form\n\
1402 printf (USAGE_BUILTIN_WARNING
, PROGRAM_NAME
);
1403 emit_ancillary_info ();
1409 main (int argc
, char *argv
[])
1415 char *format
= NULL
;
1419 initialize_main (&argc
, &argv
);
1420 set_program_name (argv
[0]);
1421 setlocale (LC_ALL
, "");
1422 bindtextdomain (PACKAGE
, LOCALEDIR
);
1423 textdomain (PACKAGE
);
1425 struct lconv
const *locale
= localeconv ();
1426 decimal_point
= (locale
->decimal_point
[0] ? locale
->decimal_point
: ".");
1427 decimal_point_len
= strlen (decimal_point
);
1429 atexit (close_stdout
);
1431 while ((c
= getopt_long (argc
, argv
, "c:fLt", long_options
, NULL
)) != -1)
1437 interpret_backslash_escapes
= true;
1438 trailing_delim
= "";
1443 interpret_backslash_escapes
= false;
1444 trailing_delim
= "\n";
1448 follow_links
= true;
1459 case_GETOPT_HELP_CHAR
;
1461 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
1464 usage (EXIT_FAILURE
);
1470 error (0, 0, _("missing operand"));
1471 usage (EXIT_FAILURE
);
1478 format
= default_format (fs
, terse
, false);
1479 format2
= default_format (fs
, terse
, true);
1482 for (i
= optind
; i
< argc
; i
++)
1484 ? do_statfs (argv
[i
], format
)
1485 : do_stat (argv
[i
], format
, format2
));
1487 exit (ok
? EXIT_SUCCESS
: EXIT_FAILURE
);