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. */
24 && (HAVE_STRUCT_STATVFS_F_BASETYPE || HAVE_STRUCT_STATVFS_F_FSTYPENAME \
25 || (! HAVE_STRUCT_STATFS_F_FSTYPENAME && HAVE_STRUCT_STATVFS_F_TYPE)))
26 # define USE_STATVFS 1
28 # define USE_STATVFS 0
33 #include <sys/types.h>
37 # include <sys/statvfs.h>
40 #elif HAVE_SYS_MOUNT_H && HAVE_SYS_PARAM_H
41 /* NOTE: freebsd5.0 needs sys/param.h and sys/mount.h for statfs.
42 It does have statvfs.h, but shouldn't use it, since it doesn't
43 HAVE_STRUCT_STATVFS_F_BASETYPE. So find a clean way to fix it. */
44 /* NetBSD 1.5.2 needs these, for the declaration of struct statfs. */
45 # include <sys/param.h>
46 # include <sys/mount.h>
47 # if HAVE_NFS_NFS_CLNT_H && HAVE_NFS_VFS_H
48 /* Ultrix 4.4 needs these for the declaration of struct statfs. */
49 # include <netinet/in.h>
50 # include <nfs/nfs_clnt.h>
53 #elif HAVE_OS_H /* BeOS */
56 #include <selinux/selinux.h>
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 # define STATFS statvfs
84 # define STATFS_FRSIZE(S) ((S)->f_frsize)
86 # define HAVE_STRUCT_STATXFS_F_TYPE HAVE_STRUCT_STATFS_F_TYPE
87 # if HAVE_STRUCT_STATFS_F_NAMELEN
88 # define SB_F_NAMEMAX(S) ((S)->f_namelen)
90 # define STATFS statfs
91 # if HAVE_OS_H /* BeOS */
92 /* BeOS has a statvfs function, but it does not return sensible values
93 for f_files, f_ffree and f_favail, and lacks f_type, f_basetype and
94 f_fstypename. Use 'struct fs_info' instead. */
95 static int ATTRIBUTE_WARN_UNUSED_RESULT
96 statfs (char const *filename
, struct fs_info
*buf
)
98 dev_t device
= dev_for_path (filename
);
101 errno
= (device
== B_ENTRY_NOT_FOUND
? ENOENT
102 : device
== B_BAD_VALUE
? EINVAL
103 : device
== B_NAME_TOO_LONG
? ENAMETOOLONG
104 : device
== B_NO_MEMORY
? ENOMEM
105 : device
== B_FILE_ERROR
? EIO
109 /* If successful, buf->dev will be == device. */
110 return fs_stat_dev (device
, buf
);
113 # define f_blocks total_blocks
114 # define f_bfree free_blocks
115 # define f_bavail free_blocks
116 # define f_bsize io_size
117 # define f_files total_nodes
118 # define f_ffree free_nodes
119 # define STRUCT_STATVFS struct fs_info
120 # define STRUCT_STATXFS_F_FSID_IS_INTEGER true
121 # define STATFS_FRSIZE(S) ((S)->block_size)
123 # define STRUCT_STATVFS struct statfs
124 # define STRUCT_STATXFS_F_FSID_IS_INTEGER STRUCT_STATFS_F_FSID_IS_INTEGER
125 # define STATFS_FRSIZE(S) 0
130 # define OUT_NAMEMAX out_uint
132 /* NetBSD 1.5.2 has neither f_namemax nor f_namelen. */
133 # define SB_F_NAMEMAX(S) "*"
134 # define OUT_NAMEMAX out_string
137 #if HAVE_STRUCT_STATVFS_F_BASETYPE
138 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME f_basetype
140 # if HAVE_STRUCT_STATVFS_F_FSTYPENAME || HAVE_STRUCT_STATFS_F_FSTYPENAME
141 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME f_fstypename
142 # elif HAVE_OS_H /* BeOS */
143 # define STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME fsh_name
147 /* FIXME: these are used by printf.c, too */
148 #define isodigit(c) ('0' <= (c) && (c) <= '7')
149 #define octtobin(c) ((c) - '0')
150 #define hextobin(c) ((c) >= 'a' && (c) <= 'f' ? (c) - 'a' + 10 : \
151 (c) >= 'A' && (c) <= 'F' ? (c) - 'A' + 10 : (c) - '0')
153 static char const digits
[] = "0123456789";
155 /* Flags that are portable for use in printf, for at least one
156 conversion specifier; make_format removes unportable flags as
157 needed for particular specifiers. The glibc 2.2 extension "I" is
158 listed here; it is removed by make_format because it has undefined
159 behavior elsewhere and because it is incompatible with
161 static char const printf_flags
[] = "'-+ #0I";
163 #define PROGRAM_NAME "stat"
165 #define AUTHORS proper_name ("Michael Meskes")
169 PRINTF_OPTION
= CHAR_MAX
+ 1
172 static struct option
const long_options
[] =
174 {"context", no_argument
, 0, 'Z'},
175 {"dereference", no_argument
, NULL
, 'L'},
176 {"file-system", no_argument
, NULL
, 'f'},
177 {"format", required_argument
, NULL
, 'c'},
178 {"printf", required_argument
, NULL
, PRINTF_OPTION
},
179 {"terse", no_argument
, NULL
, 't'},
180 {GETOPT_HELP_OPTION_DECL
},
181 {GETOPT_VERSION_OPTION_DECL
},
185 /* Whether to follow symbolic links; True for --dereference (-L). */
186 static bool follow_links
;
188 /* Whether to interpret backslash-escape sequences.
189 True for --printf=FMT, not for --format=FMT (-c). */
190 static bool interpret_backslash_escapes
;
192 /* The trailing delimiter string:
193 "" for --printf=FMT, "\n" for --format=FMT (-c). */
194 static char const *trailing_delim
= "";
196 /* The representation of the decimal point in the current locale. */
197 static char const *decimal_point
;
198 static size_t decimal_point_len
;
200 /* Return the type of the specified file system.
201 Some systems have statfvs.f_basetype[FSTYPSZ] (AIX, HP-UX, and Solaris).
202 Others have statvfs.f_fstypename[_VFS_NAMELEN] (NetBSD 3.0).
203 Others have statfs.f_fstypename[MFSNAMELEN] (NetBSD 1.5.2).
204 Still others have neither and have to get by with f_type (GNU/Linux).
205 But f_type may only exist in statfs (Cygwin). */
206 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
207 human_fstype (STRUCT_STATVFS
const *statfsbuf
)
209 #ifdef STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
210 return statfsbuf
->STATXFS_FILE_SYSTEM_TYPE_MEMBER_NAME
;
212 switch (statfsbuf
->f_type
)
214 # if defined __linux__
216 /* Compare with what's in libc:
217 f=/a/libc/sysdeps/unix/sysv/linux/linux_fsinfo.h
218 sed -n '/ADFS_SUPER_MAGIC/,/SYSFS_MAGIC/p' $f \
219 | perl -n -e '/#define (.*?)_(?:SUPER_)MAGIC\s+0x(\S+)/' \
220 -e 'and print "case S_MAGIC_$1: /\* 0x" . uc($2) . " *\/\n"' \
222 perl -ne '/^\s+(case S_MAGIC_.*?): \/\* 0x(\S+) \*\//' \
223 -e 'and do { $v=uc$2; print "$1: /\* 0x$v *\/\n"}' stat.c \
225 diff -u sym_stat sym_libc
228 /* Also compare with the list in "man 2 statfs" using the
229 fs-magic-compare make target. */
231 /* IMPORTANT NOTE: Each of the following `case S_MAGIC_...:'
232 statements must be followed by a hexadecimal constant in
233 a comment. The S_MAGIC_... name and constant are automatically
234 combined to produce the #define directives in fs.h. */
236 case S_MAGIC_ADFS
: /* 0xADF5 */
238 case S_MAGIC_AFFS
: /* 0xADFF */
240 case S_MAGIC_AFS
: /* 0x5346414F */
242 case S_MAGIC_ANON_INODE_FS
: /* 0x09041934 */
243 return "anon-inode FS";
244 case S_MAGIC_AUTOFS
: /* 0x0187 */
246 case S_MAGIC_BEFS
: /* 0x42465331 */
248 case S_MAGIC_BFS
: /* 0x1BADFACE */
250 case S_MAGIC_BINFMT_MISC
: /* 0x42494E4D */
251 return "binfmt_misc";
252 case S_MAGIC_BTRFS
: /* 0x9123683E */
254 case S_MAGIC_CGROUP
: /* 0x0027E0EB */
256 case S_MAGIC_CIFS
: /* 0xFF534D42 */
258 case S_MAGIC_CODA
: /* 0x73757245 */
260 case S_MAGIC_COH
: /* 0x012FF7B7 */
262 case S_MAGIC_CRAMFS
: /* 0x28CD3D45 */
264 case S_MAGIC_CRAMFS_WEND
: /* 0x453DCD28 */
265 return "cramfs-wend";
266 case S_MAGIC_DEBUGFS
: /* 0x64626720 */
268 case S_MAGIC_DEVFS
: /* 0x1373 */
270 case S_MAGIC_DEVPTS
: /* 0x1CD1 */
272 case S_MAGIC_ECRYPTFS
: /* 0xF15F */
274 case S_MAGIC_EFS
: /* 0x00414A53 */
276 case S_MAGIC_EXT
: /* 0x137D */
278 case S_MAGIC_EXT2
: /* 0xEF53 */
280 case S_MAGIC_EXT2_OLD
: /* 0xEF51 */
282 case S_MAGIC_FAT
: /* 0x4006 */
284 case S_MAGIC_FUSEBLK
: /* 0x65735546 */
286 case S_MAGIC_FUSECTL
: /* 0x65735543 */
288 case S_MAGIC_FUTEXFS
: /* 0x0BAD1DEA */
290 case S_MAGIC_GFS
: /* 0x1161970 */
292 case S_MAGIC_HFS
: /* 0x4244 */
294 case S_MAGIC_HPFS
: /* 0xF995E849 */
296 case S_MAGIC_HUGETLBFS
: /* 0x958458F6 */
298 case S_MAGIC_INOTIFYFS
: /* 0x2BAD1DEA */
300 case S_MAGIC_ISOFS
: /* 0x9660 */
302 case S_MAGIC_ISOFS_R_WIN
: /* 0x4004 */
304 case S_MAGIC_ISOFS_WIN
: /* 0x4000 */
306 case S_MAGIC_JFFS
: /* 0x07C0 */
308 case S_MAGIC_JFFS2
: /* 0x72B6 */
310 case S_MAGIC_JFS
: /* 0x3153464A */
312 case S_MAGIC_KAFS
: /* 0x6B414653 */
314 case S_MAGIC_LUSTRE
: /* 0x0BD00BD0 */
316 case S_MAGIC_MINIX
: /* 0x137F */
318 case S_MAGIC_MINIX_30
: /* 0x138F */
319 return "minix (30 char.)";
320 case S_MAGIC_MINIX_V2
: /* 0x2468 */
322 case S_MAGIC_MINIX_V2_30
: /* 0x2478 */
323 return "minix v2 (30 char.)";
324 case S_MAGIC_MINIX_V3
: /* 0x4D5A */
326 case S_MAGIC_MQUEUE
: /* 0x19800202 */
328 case S_MAGIC_MSDOS
: /* 0x4D44 */
330 case S_MAGIC_NCP
: /* 0x564C */
332 case S_MAGIC_NFS
: /* 0x6969 */
334 case S_MAGIC_NFSD
: /* 0x6E667364 */
336 case S_MAGIC_NILFS
: /* 0x3434 */
338 case S_MAGIC_NTFS
: /* 0x5346544E */
340 case S_MAGIC_OPENPROM
: /* 0x9FA1 */
342 case S_MAGIC_OCFS2
: /* 0x7461636f */
344 case S_MAGIC_PROC
: /* 0x9FA0 */
346 case S_MAGIC_PSTOREFS
: /* 0x6165676C */
348 case S_MAGIC_QNX4
: /* 0x002F */
350 case S_MAGIC_RAMFS
: /* 0x858458F6 */
352 case S_MAGIC_REISERFS
: /* 0x52654973 */
354 case S_MAGIC_ROMFS
: /* 0x7275 */
356 case S_MAGIC_RPC_PIPEFS
: /* 0x67596969 */
358 case S_MAGIC_SECURITYFS
: /* 0x73636673 */
360 case S_MAGIC_SELINUX
: /* 0xF97CFF8C */
362 case S_MAGIC_SMB
: /* 0x517B */
364 case S_MAGIC_SOCKFS
: /* 0x534F434B */
366 case S_MAGIC_SQUASHFS
: /* 0x73717368 */
368 case S_MAGIC_SYSFS
: /* 0x62656572 */
370 case S_MAGIC_SYSV2
: /* 0x012FF7B6 */
372 case S_MAGIC_SYSV4
: /* 0x012FF7B5 */
374 case S_MAGIC_TMPFS
: /* 0x01021994 */
376 case S_MAGIC_UDF
: /* 0x15013346 */
378 case S_MAGIC_UFS
: /* 0x00011954 */
380 case S_MAGIC_UFS_BYTESWAPPED
: /* 0x54190100 */
382 case S_MAGIC_USBDEVFS
: /* 0x9FA2 */
384 case S_MAGIC_V9FS
: /* 0x01021997 */
386 case S_MAGIC_VXFS
: /* 0xA501FCF5 */
388 case S_MAGIC_XENFS
: /* 0xABBA1974 */
390 case S_MAGIC_XENIX
: /* 0x012FF7B4 */
392 case S_MAGIC_XFS
: /* 0x58465342 */
394 case S_MAGIC_XIAFS
: /* 0x012FD16D */
455 unsigned long int type
= statfsbuf
->f_type
;
456 static char buf
[sizeof "UNKNOWN (0x%lx)" - 3
457 + (sizeof type
* CHAR_BIT
+ 3) / 4];
458 sprintf (buf
, "UNKNOWN (0x%lx)", type
);
465 static char * ATTRIBUTE_WARN_UNUSED_RESULT
466 human_access (struct stat
const *statbuf
)
468 static char modebuf
[12];
469 filemodestring (statbuf
, modebuf
);
474 static char * ATTRIBUTE_WARN_UNUSED_RESULT
475 human_time (struct timespec t
)
477 static char str
[MAX (INT_BUFSIZE_BOUND (intmax_t),
478 (INT_STRLEN_BOUND (int) /* YYYY */
479 + 1 /* because YYYY might equal INT_MAX + 1900 */
480 + sizeof "-MM-DD HH:MM:SS.NNNNNNNNN +ZZZZ"))];
481 struct tm
const *tm
= localtime (&t
.tv_sec
);
483 return timetostr (t
.tv_sec
, str
);
484 nstrftime (str
, sizeof str
, "%Y-%m-%d %H:%M:%S.%N %z", tm
, 0, t
.tv_nsec
);
488 /* PFORMAT points to a '%' followed by a prefix of a format, all of
489 size PREFIX_LEN. The flags allowed for this format are
490 ALLOWED_FLAGS; remove other printf flags from the prefix, then
493 make_format (char *pformat
, size_t prefix_len
, char const *allowed_flags
,
496 char *dst
= pformat
+ 1;
498 char const *srclim
= pformat
+ prefix_len
;
499 for (src
= dst
; src
< srclim
&& strchr (printf_flags
, *src
); src
++)
500 if (strchr (allowed_flags
, *src
))
504 strcpy (dst
, suffix
);
508 out_string (char *pformat
, size_t prefix_len
, char const *arg
)
510 make_format (pformat
, prefix_len
, "-", "s");
511 printf (pformat
, arg
);
514 out_int (char *pformat
, size_t prefix_len
, intmax_t arg
)
516 make_format (pformat
, prefix_len
, "'-+ 0", PRIdMAX
);
517 return printf (pformat
, arg
);
520 out_uint (char *pformat
, size_t prefix_len
, uintmax_t arg
)
522 make_format (pformat
, prefix_len
, "'-0", PRIuMAX
);
523 return printf (pformat
, arg
);
526 out_uint_o (char *pformat
, size_t prefix_len
, uintmax_t arg
)
528 make_format (pformat
, prefix_len
, "-#0", PRIoMAX
);
529 printf (pformat
, arg
);
532 out_uint_x (char *pformat
, size_t prefix_len
, uintmax_t arg
)
534 make_format (pformat
, prefix_len
, "-#0", PRIxMAX
);
535 printf (pformat
, arg
);
538 out_minus_zero (char *pformat
, size_t prefix_len
)
540 make_format (pformat
, prefix_len
, "'-+ 0", ".0f");
541 return printf (pformat
, -0.25);
544 /* Output the number of seconds since the Epoch, using a format that
545 acts like printf's %f format. */
547 out_epoch_sec (char *pformat
, size_t prefix_len
, struct stat
const *statbuf
,
550 char *dot
= memchr (pformat
, '.', prefix_len
);
551 size_t sec_prefix_len
= prefix_len
;
554 bool frac_left_adjust
= false;
558 sec_prefix_len
= dot
- pformat
;
559 pformat
[prefix_len
] = '\0';
561 if (ISDIGIT (dot
[1]))
563 long int lprec
= strtol (dot
+ 1, NULL
, 10);
564 precision
= (lprec
<= INT_MAX
? lprec
: INT_MAX
);
571 if (precision
&& ISDIGIT (dot
[-1]))
573 /* If a nontrivial width is given, subtract the width of the
574 decimal point and PRECISION digits that will be output
581 while (ISDIGIT (p
[-1]));
583 long int lwidth
= strtol (p
, NULL
, 10);
584 width
= (lwidth
<= INT_MAX
? lwidth
: INT_MAX
);
588 sec_prefix_len
= p
- pformat
;
589 int w_d
= (decimal_point_len
< width
590 ? width
- decimal_point_len
594 int w
= w_d
- precision
;
598 for (char const *src
= dst
; src
< p
; src
++)
601 frac_left_adjust
= true;
607 + (frac_left_adjust
? 0 : sprintf (dst
, "%d", w
)));
615 for (int i
= precision
; i
< 9; i
++)
617 int frac_sec
= arg
.tv_nsec
/ divisor
;
620 if (TYPE_SIGNED (time_t))
622 bool minus_zero
= false;
623 if (arg
.tv_sec
< 0 && arg
.tv_nsec
!= 0)
625 int frac_sec_modulus
= 1000000000 / divisor
;
626 frac_sec
= (frac_sec_modulus
- frac_sec
627 - (arg
.tv_nsec
% divisor
!= 0));
628 arg
.tv_sec
+= (frac_sec
!= 0);
629 minus_zero
= (arg
.tv_sec
== 0);
631 int_len
= (minus_zero
632 ? out_minus_zero (pformat
, sec_prefix_len
)
633 : out_int (pformat
, sec_prefix_len
, arg
.tv_sec
));
636 int_len
= out_uint (pformat
, sec_prefix_len
, arg
.tv_sec
);
640 int prec
= (precision
< 9 ? precision
: 9);
641 int trailing_prec
= precision
- prec
;
642 int ilen
= (int_len
< 0 ? 0 : int_len
);
643 int trailing_width
= (ilen
< width
&& decimal_point_len
< width
- ilen
644 ? width
- ilen
- decimal_point_len
- prec
646 printf ("%s%.*d%-*.*d", decimal_point
, prec
, frac_sec
,
647 trailing_width
, trailing_prec
, 0);
651 /* Print the context information of FILENAME, and return true iff the
652 context could not be obtained. */
653 static bool ATTRIBUTE_WARN_UNUSED_RESULT
654 out_file_context (char *pformat
, size_t prefix_len
, char const *filename
)
660 ? getfilecon (filename
, &scontext
)
661 : lgetfilecon (filename
, &scontext
)) < 0)
663 error (0, errno
, _("failed to get security context of %s"),
668 strcpy (pformat
+ prefix_len
, "s");
669 printf (pformat
, (scontext
? scontext
: "?"));
675 /* Print statfs info. Return zero upon success, nonzero upon failure. */
676 static bool ATTRIBUTE_WARN_UNUSED_RESULT
677 print_statfs (char *pformat
, size_t prefix_len
, unsigned int m
,
678 char const *filename
,
681 STRUCT_STATVFS
const *statfsbuf
= data
;
687 out_string (pformat
, prefix_len
, filename
);
692 #if STRUCT_STATXFS_F_FSID_IS_INTEGER
693 uintmax_t fsid
= statfsbuf
->f_fsid
;
695 typedef unsigned int fsid_word
;
696 verify (alignof (STRUCT_STATVFS
) % alignof (fsid_word
) == 0);
697 verify (offsetof (STRUCT_STATVFS
, f_fsid
) % alignof (fsid_word
) == 0);
698 verify (sizeof statfsbuf
->f_fsid
% alignof (fsid_word
) == 0);
699 fsid_word
const *p
= (fsid_word
*) &statfsbuf
->f_fsid
;
701 /* Assume a little-endian word order, as that is compatible
702 with glibc's statvfs implementation. */
704 int words
= sizeof statfsbuf
->f_fsid
/ sizeof *p
;
706 for (i
= 0; i
< words
&& i
* sizeof *p
< sizeof fsid
; i
++)
708 uintmax_t u
= p
[words
- 1 - i
];
709 fsid
|= u
<< (i
* CHAR_BIT
* sizeof *p
);
712 out_uint_x (pformat
, prefix_len
, fsid
);
717 OUT_NAMEMAX (pformat
, prefix_len
, SB_F_NAMEMAX (statfsbuf
));
720 #if HAVE_STRUCT_STATXFS_F_TYPE
721 out_uint_x (pformat
, prefix_len
, statfsbuf
->f_type
);
727 out_string (pformat
, prefix_len
, human_fstype (statfsbuf
));
730 out_int (pformat
, prefix_len
, statfsbuf
->f_blocks
);
733 out_int (pformat
, prefix_len
, statfsbuf
->f_bfree
);
736 out_int (pformat
, prefix_len
, statfsbuf
->f_bavail
);
739 out_uint (pformat
, prefix_len
, statfsbuf
->f_bsize
);
743 uintmax_t frsize
= STATFS_FRSIZE (statfsbuf
);
745 frsize
= statfsbuf
->f_bsize
;
746 out_uint (pformat
, prefix_len
, frsize
);
750 out_uint (pformat
, prefix_len
, statfsbuf
->f_files
);
753 out_int (pformat
, prefix_len
, statfsbuf
->f_ffree
);
762 /* Return any bind mounted source for a path.
763 The caller should not free the returned buffer.
764 Return NULL if no bind mount found. */
765 static char const * ATTRIBUTE_WARN_UNUSED_RESULT
766 find_bind_mount (char const * name
)
768 char const * bind_mount
= NULL
;
770 static struct mount_entry
*mount_list
;
771 static bool tried_mount_list
= false;
772 if (!tried_mount_list
) /* attempt/warn once per process. */
774 if (!(mount_list
= read_file_system_list (false)))
775 error (0, errno
, "%s", _("cannot read table of mounted file systems"));
776 tried_mount_list
= true;
779 struct mount_entry
*me
;
780 for (me
= mount_list
; me
; me
= me
->me_next
)
782 if (me
->me_dummy
&& me
->me_devname
[0] == '/'
783 && STREQ (me
->me_mountdir
, name
))
785 struct stat name_stats
;
786 struct stat dev_stats
;
788 if (stat (name
, &name_stats
) == 0
789 && stat (me
->me_devname
, &dev_stats
) == 0
790 && SAME_INODE (name_stats
, dev_stats
))
792 bind_mount
= me
->me_devname
;
801 /* Print mount point. Return zero upon success, nonzero upon failure. */
802 static bool ATTRIBUTE_WARN_UNUSED_RESULT
803 out_mount_point (char const *filename
, char *pformat
, size_t prefix_len
,
804 const struct stat
*statp
)
807 char const *np
= "?", *bp
= NULL
;
811 /* Look for bind mounts first. Note we output the immediate alias,
812 rather than further resolving to a base device mount point. */
813 if (follow_links
|| !S_ISLNK (statp
->st_mode
))
815 char *resolved
= canonicalize_file_name (filename
);
818 error (0, errno
, _("failed to canonicalize %s"), quote (filename
));
819 goto print_mount_point
;
821 bp
= find_bind_mount (resolved
);
826 goto print_mount_point
;
830 /* If there is no direct bind mount, then navigate
831 back up the tree looking for a device change.
832 Note we don't detect if any of the directory components
833 are bind mounted to the same device, but that's OK
834 since we've not directly queried them. */
835 if ((mp
= find_mount_point (filename
, statp
)))
837 /* This dir might be bind mounted to another device,
838 so we resolve the bound source in that case also. */
839 bp
= find_bind_mount (mp
);
845 out_string (pformat
, prefix_len
, bp
? bp
: mp
? mp
: np
);
850 /* Map a TS with negative TS.tv_nsec to {0,0}. */
851 static inline struct timespec
852 neg_to_zero (struct timespec ts
)
856 struct timespec z
= {0, 0};
860 /* Print stat info. Return zero upon success, nonzero upon failure. */
862 print_stat (char *pformat
, size_t prefix_len
, unsigned int m
,
863 char const *filename
, void const *data
)
865 struct stat
*statbuf
= (struct stat
*) data
;
866 struct passwd
*pw_ent
;
867 struct group
*gw_ent
;
873 out_string (pformat
, prefix_len
, filename
);
876 out_string (pformat
, prefix_len
, quote (filename
));
877 if (S_ISLNK (statbuf
->st_mode
))
879 char *linkname
= areadlink_with_size (filename
, statbuf
->st_size
);
880 if (linkname
== NULL
)
882 error (0, errno
, _("cannot read symbolic link %s"),
887 out_string (pformat
, prefix_len
, quote (linkname
));
892 out_uint (pformat
, prefix_len
, statbuf
->st_dev
);
895 out_uint_x (pformat
, prefix_len
, statbuf
->st_dev
);
898 out_uint (pformat
, prefix_len
, statbuf
->st_ino
);
901 out_uint_o (pformat
, prefix_len
, statbuf
->st_mode
& CHMOD_MODE_BITS
);
904 out_string (pformat
, prefix_len
, human_access (statbuf
));
907 out_uint_x (pformat
, prefix_len
, statbuf
->st_mode
);
910 out_string (pformat
, prefix_len
, file_type (statbuf
));
913 out_uint (pformat
, prefix_len
, statbuf
->st_nlink
);
916 out_uint (pformat
, prefix_len
, statbuf
->st_uid
);
920 pw_ent
= getpwuid (statbuf
->st_uid
);
921 out_string (pformat
, prefix_len
,
922 pw_ent
? pw_ent
->pw_name
: "UNKNOWN");
925 out_uint (pformat
, prefix_len
, statbuf
->st_gid
);
929 gw_ent
= getgrgid (statbuf
->st_gid
);
930 out_string (pformat
, prefix_len
,
931 gw_ent
? gw_ent
->gr_name
: "UNKNOWN");
934 out_uint_x (pformat
, prefix_len
, major (statbuf
->st_rdev
));
937 fail
|= out_mount_point (filename
, pformat
, prefix_len
, statbuf
);
940 out_uint_x (pformat
, prefix_len
, minor (statbuf
->st_rdev
));
943 out_uint (pformat
, prefix_len
, statbuf
->st_size
);
946 out_uint (pformat
, prefix_len
, ST_NBLOCKSIZE
);
949 out_uint (pformat
, prefix_len
, ST_NBLOCKS (*statbuf
));
952 out_uint (pformat
, prefix_len
, statbuf
->st_blksize
);
956 struct timespec t
= get_stat_birthtime (statbuf
);
958 out_string (pformat
, prefix_len
, "-");
960 out_string (pformat
, prefix_len
, human_time (t
));
964 out_epoch_sec (pformat
, prefix_len
, statbuf
,
965 neg_to_zero (get_stat_birthtime (statbuf
)));
968 out_string (pformat
, prefix_len
, human_time (get_stat_atime (statbuf
)));
971 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_atime (statbuf
));
974 out_string (pformat
, prefix_len
, human_time (get_stat_mtime (statbuf
)));
977 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_mtime (statbuf
));
980 out_string (pformat
, prefix_len
, human_time (get_stat_ctime (statbuf
)));
983 out_epoch_sec (pformat
, prefix_len
, statbuf
, get_stat_ctime (statbuf
));
986 fail
|= out_file_context (pformat
, prefix_len
, filename
);
995 /* Output a single-character \ escape. */
998 print_esc_char (char c
)
1002 case 'a': /* Alert. */
1005 case 'b': /* Backspace. */
1008 case 'e': /* Escape. */
1011 case 'f': /* Form feed. */
1014 case 'n': /* New line. */
1017 case 'r': /* Carriage return. */
1020 case 't': /* Horizontal tab. */
1023 case 'v': /* Vertical tab. */
1030 error (0, 0, _("warning: unrecognized escape `\\%c'"), c
);
1036 /* Print the information specified by the format string, FORMAT,
1037 calling PRINT_FUNC for each %-directive encountered.
1038 Return zero upon success, nonzero upon failure. */
1039 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1040 print_it (char const *format
, char const *filename
,
1041 bool (*print_func
) (char *, size_t, unsigned int,
1042 char const *, void const *),
1047 /* Add 2 to accommodate our conversion of the stat `%s' format string
1048 to the longer printf `%llu' one. */
1051 MAX_ADDITIONAL_BYTES
=
1052 (MAX (sizeof PRIdMAX
,
1053 MAX (sizeof PRIoMAX
, MAX (sizeof PRIuMAX
, sizeof PRIxMAX
)))
1056 size_t n_alloc
= strlen (format
) + MAX_ADDITIONAL_BYTES
+ 1;
1057 char *dest
= xmalloc (n_alloc
);
1059 for (b
= format
; *b
; b
++)
1065 size_t len
= strspn (b
+ 1, printf_flags
);
1066 char const *fmt_char
= b
+ len
+ 1;
1067 fmt_char
+= strspn (fmt_char
, digits
);
1068 if (*fmt_char
== '.')
1069 fmt_char
+= 1 + strspn (fmt_char
+ 1, digits
);
1070 len
= fmt_char
- (b
+ 1);
1071 unsigned int fmt_code
= *fmt_char
;
1072 memcpy (dest
, b
, len
+ 1);
1083 dest
[len
+ 1] = *fmt_char
;
1084 dest
[len
+ 2] = '\0';
1085 error (EXIT_FAILURE
, 0, _("%s: invalid directive"),
1086 quotearg_colon (dest
));
1091 fail
|= print_func (dest
, len
+ 1, fmt_code
, filename
, data
);
1098 if ( ! interpret_backslash_escapes
)
1106 int esc_value
= octtobin (*b
);
1107 int esc_length
= 1; /* number of octal digits */
1108 for (++b
; esc_length
< 3 && isodigit (*b
);
1111 esc_value
= esc_value
* 8 + octtobin (*b
);
1113 putchar (esc_value
);
1116 else if (*b
== 'x' && isxdigit (to_uchar (b
[1])))
1118 int esc_value
= hextobin (b
[1]); /* Value of \xhh escape. */
1119 /* A hexadecimal \xhh escape sequence must have
1120 1 or 2 hex. digits. */
1122 if (isxdigit (to_uchar (b
[1])))
1125 esc_value
= esc_value
* 16 + hextobin (*b
);
1127 putchar (esc_value
);
1129 else if (*b
== '\0')
1131 error (0, 0, _("warning: backslash at end of format"));
1133 /* Arrange to exit the loop. */
1138 print_esc_char (*b
);
1149 fputs (trailing_delim
, stdout
);
1154 /* Stat the file system and print what we find. */
1155 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1156 do_statfs (char const *filename
, bool terse
, char const *format
)
1158 STRUCT_STATVFS statfsbuf
;
1160 if (STREQ (filename
, "-"))
1162 error (0, 0, _("using %s to denote standard input does not work"
1163 " in file system mode"), quote (filename
));
1167 if (STATFS (filename
, &statfsbuf
) != 0)
1169 error (0, errno
, _("cannot read file system information for %s"),
1174 bool fail
= print_it (format
, filename
, print_statfs
, &statfsbuf
);
1178 /* stat the file and print what we find */
1179 static bool ATTRIBUTE_WARN_UNUSED_RESULT
1180 do_stat (char const *filename
, bool terse
, char const *format
,
1181 char const *format2
)
1183 struct stat statbuf
;
1185 if (STREQ (filename
, "-"))
1187 if (fstat (STDIN_FILENO
, &statbuf
) != 0)
1189 error (0, errno
, _("cannot stat standard input"));
1193 /* We can't use the shorter
1194 (follow_links?stat:lstat) (filename, &statbug)
1195 since stat might be a function-like macro. */
1196 else if ((follow_links
1197 ? stat (filename
, &statbuf
)
1198 : lstat (filename
, &statbuf
)) != 0)
1200 error (0, errno
, _("cannot stat %s"), quote (filename
));
1204 if (S_ISBLK (statbuf
.st_mode
) || S_ISCHR (statbuf
.st_mode
))
1207 bool fail
= print_it (format
, filename
, print_stat
, &statbuf
);
1211 /* Return an allocated format string in static storage that
1212 corresponds to whether FS and TERSE options were declared. */
1214 default_format (bool fs
, bool terse
, bool device
)
1220 format
= xstrdup ("%n %i %l %t %s %S %b %f %a %c %d\n");
1223 /* TRANSLATORS: This string uses format specifiers from
1224 'stat --help' with --file-system, and NOT from printf. */
1225 format
= xstrdup (_("\
1227 ID: %-8i Namelen: %-7l Type: %T\n\
1228 Block size: %-10s Fundamental block size: %S\n\
1229 Blocks: Total: %-10b Free: %-10f Available: %a\n\
1230 Inodes: Total: %-10c Free: %d\n\
1238 if (0 < is_selinux_enabled ())
1239 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1240 " %X %Y %Z %W %o %C\n");
1242 format
= xstrdup ("%n %s %b %f %u %g %D %i %h %t %T"
1243 " %X %Y %Z %W %o\n");
1248 /* TRANSLATORS: This string uses format specifiers from
1249 'stat --help' without --file-system, and NOT from printf. */
1250 format
= xstrdup (_("\
1252 Size: %-10s\tBlocks: %-10b IO Block: %-6o %F\n\
1258 /* TRANSLATORS: This string uses format specifiers from
1259 'stat --help' without --file-system, and NOT from printf. */
1260 format
= xasprintf ("%s%s", format
, _("\
1261 Device: %Dh/%dd\tInode: %-10i Links: %-5h Device type: %t,%T\n\
1266 /* TRANSLATORS: This string uses format specifiers from
1267 'stat --help' without --file-system, and NOT from printf. */
1268 format
= xasprintf ("%s%s", format
, _("\
1269 Device: %Dh/%dd\tInode: %-10i Links: %h\n\
1275 /* TRANSLATORS: This string uses format specifiers from
1276 'stat --help' without --file-system, and NOT from printf. */
1277 format
= xasprintf ("%s%s", format
, _("\
1278 Access: (%04a/%10.10A) Uid: (%5u/%8U) Gid: (%5g/%8G)\n\
1282 if (0 < is_selinux_enabled ())
1285 /* TRANSLATORS: This string uses format specifiers from
1286 'stat --help' without --file-system, and NOT from printf. */
1287 format
= xasprintf ("%s%s", format
, _("\
1294 /* TRANSLATORS: This string uses format specifiers from
1295 'stat --help' without --file-system, and NOT from printf. */
1296 format
= xasprintf ("%s%s", format
, _("\
1311 if (status
!= EXIT_SUCCESS
)
1312 fprintf (stderr
, _("Try `%s --help' for more information.\n"),
1316 printf (_("Usage: %s [OPTION]... FILE...\n"), program_name
);
1318 Display file or file system status.\n\
1320 -L, --dereference follow links\n\
1321 -f, --file-system display file system status instead of file status\n\
1324 -c --format=FORMAT use the specified FORMAT instead of the default;\n\
1325 output a newline after each use of FORMAT\n\
1326 --printf=FORMAT like --format, but interpret backslash escapes,\n\
1327 and do not output a mandatory trailing newline.\n\
1328 If you want a newline, include \\n in FORMAT\n\
1329 -t, --terse print the information in terse form\n\
1331 fputs (HELP_OPTION_DESCRIPTION
, stdout
);
1332 fputs (VERSION_OPTION_DESCRIPTION
, stdout
);
1335 The valid format sequences for files (without --file-system):\n\
1337 %a Access rights in octal\n\
1338 %A Access rights in human readable form\n\
1339 %b Number of blocks allocated (see %B)\n\
1340 %B The size in bytes of each block reported by %b\n\
1341 %C SELinux security context string\n\
1344 %d Device number in decimal\n\
1345 %D Device number in hex\n\
1346 %f Raw mode in hex\n\
1348 %g Group ID of owner\n\
1349 %G Group name of owner\n\
1352 %h Number of hard links\n\
1356 %N Quoted file name with dereference if symbolic link\n\
1357 %o I/O block size\n\
1358 %s Total size, in bytes\n\
1359 %t Major device type in hex\n\
1360 %T Minor device type in hex\n\
1363 %u User ID of owner\n\
1364 %U User name of owner\n\
1365 %w Time of file birth, human-readable; - if unknown\n\
1366 %W Time of file birth, seconds since Epoch; 0 if unknown\n\
1367 %x Time of last access, human-readable\n\
1368 %X Time of last access, seconds since Epoch\n\
1369 %y Time of last modification, human-readable\n\
1370 %Y Time of last modification, seconds since Epoch\n\
1371 %z Time of last change, human-readable\n\
1372 %Z Time of last change, seconds since Epoch\n\
1377 Valid format sequences for file systems:\n\
1379 %a Free blocks available to non-superuser\n\
1380 %b Total data blocks in file system\n\
1381 %c Total file nodes in file system\n\
1382 %d Free file nodes in file system\n\
1383 %f Free blocks in file system\n\
1386 %i File System ID in hex\n\
1387 %l Maximum length of filenames\n\
1389 %s Block size (for faster transfers)\n\
1390 %S Fundamental block size (for block counts)\n\
1392 %T Type in human readable form\n\
1394 printf (USAGE_BUILTIN_WARNING
, PROGRAM_NAME
);
1395 emit_ancillary_info ();
1401 main (int argc
, char *argv
[])
1407 char *format
= NULL
;
1411 initialize_main (&argc
, &argv
);
1412 set_program_name (argv
[0]);
1413 setlocale (LC_ALL
, "");
1414 bindtextdomain (PACKAGE
, LOCALEDIR
);
1415 textdomain (PACKAGE
);
1417 struct lconv
const *locale
= localeconv ();
1418 decimal_point
= (locale
->decimal_point
[0] ? locale
->decimal_point
: ".");
1419 decimal_point_len
= strlen (decimal_point
);
1421 atexit (close_stdout
);
1423 while ((c
= getopt_long (argc
, argv
, "c:fLt", long_options
, NULL
)) != -1)
1429 interpret_backslash_escapes
= true;
1430 trailing_delim
= "";
1435 interpret_backslash_escapes
= false;
1436 trailing_delim
= "\n";
1440 follow_links
= true;
1451 case_GETOPT_HELP_CHAR
;
1453 case_GETOPT_VERSION_CHAR (PROGRAM_NAME
, AUTHORS
);
1456 usage (EXIT_FAILURE
);
1462 error (0, 0, _("missing operand"));
1463 usage (EXIT_FAILURE
);
1470 format
= default_format (fs
, terse
, false);
1471 format2
= default_format (fs
, terse
, true);
1474 for (i
= optind
; i
< argc
; i
++)
1476 ? do_statfs (argv
[i
], terse
, format
)
1477 : do_stat (argv
[i
], terse
, format
, format2
));
1479 exit (ok
? EXIT_SUCCESS
: EXIT_FAILURE
);