/* df - summarize free file system space Copyright (C) 1991-2023 Free Software Foundation, Inc. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see . */ /* Written by David MacKenzie . --human-readable option added by lm@sgi.com. --si and large file support added by eggert@twinsun.com. */ #include #include #include #include #include #include #include "system.h" #include "assure.h" #include "canonicalize.h" #include "fsusage.h" #include "human.h" #include "mbswidth.h" #include "mountlist.h" #include "quote.h" #include "find-mount-point.h" #include "hash.h" #include "xstrtol-error.h" /* The official name of this program (e.g., no 'g' prefix). */ #define PROGRAM_NAME "df" #define AUTHORS \ proper_name_lite ("Torbjorn Granlund", "Torbj\303\266rn Granlund"), \ proper_name ("David MacKenzie"), \ proper_name ("Paul Eggert") struct devlist { dev_t dev_num; struct mount_entry *me; struct devlist *next; struct devlist *seen_last; /* valid for hashed devlist entries only */ }; /* Filled with device numbers of examined file systems to avoid duplicates in output. */ static Hash_table *devlist_table; /* If true, show even file systems with zero size or uninteresting types. */ static bool show_all_fs; /* If true, show only local file systems. */ static bool show_local_fs; /* If true, output data for each file system corresponding to a command line argument -- even if it's a dummy (automounter) entry. */ static bool show_listed_fs; /* Human-readable options for output. */ static int human_output_opts; /* The units to use when printing sizes. */ static uintmax_t output_block_size; /* True if a file system has been processed for output. */ static bool file_systems_processed; /* If true, invoke the 'sync' system call before getting any usage data. Using this option can make df very slow, especially with many or very busy file systems. This may make a difference on some systems -- SunOS 4.1.3, for one. It is *not* necessary on GNU/Linux. */ static bool require_sync; /* Desired exit status. */ static int exit_status; /* A file system type to display. */ struct fs_type_list { char *fs_name; struct fs_type_list *fs_next; }; /* Linked list of file system types to display. If 'fs_select_list' is null, list all types. This table is generated dynamically from command-line options, rather than hardcoding into the program what it thinks are the valid file system types; let the user specify any file system type they want to, and if there are any file systems of that type, they will be shown. Some file system types: 4.2 4.3 ufs nfs swap ignore io vm efs dbg */ static struct fs_type_list *fs_select_list; /* Linked list of file system types to omit. If the list is empty, don't exclude any types. */ static struct fs_type_list *fs_exclude_list; /* Linked list of mounted file systems. */ static struct mount_entry *mount_list; /* If true, print file system type as well. */ static bool print_type; /* If true, print a grand total at the end. */ static bool print_grand_total; /* Grand total data. */ static struct fs_usage grand_fsu; /* Display modes. */ static enum { DEFAULT_MODE, INODES_MODE, HUMAN_MODE, POSIX_MODE, OUTPUT_MODE } header_mode = DEFAULT_MODE; /* Displayable fields. */ typedef enum { SOURCE_FIELD, /* file system */ FSTYPE_FIELD, /* FS type */ SIZE_FIELD, /* FS size */ USED_FIELD, /* FS size used */ AVAIL_FIELD, /* FS size available */ PCENT_FIELD, /* percent used */ ITOTAL_FIELD, /* inode total */ IUSED_FIELD, /* inodes used */ IAVAIL_FIELD, /* inodes available */ IPCENT_FIELD, /* inodes used in percent */ TARGET_FIELD, /* mount point */ FILE_FIELD, /* specified file name */ INVALID_FIELD /* validation marker */ } display_field_t; /* Flag if a field contains a block, an inode or another value. */ typedef enum { BLOCK_FLD, /* Block values field */ INODE_FLD, /* Inode values field */ OTHER_FLD /* Neutral field, e.g. target */ } field_type_t; /* Attributes of a display field. */ struct field_data_t { display_field_t field; char const *arg; field_type_t field_type; char const *caption;/* nullptr means use default header of this field. */ int width; /* Auto adjusted (up) widths used to align columns. */ bool align_right; /* Whether to right-align columns, not left-align. */ bool used; }; /* Header strings, minimum width and alignment for the above fields. */ static struct field_data_t field_data[] = { [SOURCE_FIELD] = { SOURCE_FIELD, "source", OTHER_FLD, N_("Filesystem"), 14, false, false }, [FSTYPE_FIELD] = { FSTYPE_FIELD, "fstype", OTHER_FLD, N_("Type"), 4, false, false }, [SIZE_FIELD] = { SIZE_FIELD, "size", BLOCK_FLD, N_("blocks"), 5, true, false }, [USED_FIELD] = { USED_FIELD, "used", BLOCK_FLD, N_("Used"), 5, true, false }, [AVAIL_FIELD] = { AVAIL_FIELD, "avail", BLOCK_FLD, N_("Available"), 5, true, false }, [PCENT_FIELD] = { PCENT_FIELD, "pcent", BLOCK_FLD, N_("Use%"), 4, true, false }, [ITOTAL_FIELD] = { ITOTAL_FIELD, "itotal", INODE_FLD, N_("Inodes"), 5, true, false }, [IUSED_FIELD] = { IUSED_FIELD, "iused", INODE_FLD, N_("IUsed"), 5, true, false }, [IAVAIL_FIELD] = { IAVAIL_FIELD, "iavail", INODE_FLD, N_("IFree"), 5, true, false }, [IPCENT_FIELD] = { IPCENT_FIELD, "ipcent", INODE_FLD, N_("IUse%"), 4, true, false }, [TARGET_FIELD] = { TARGET_FIELD, "target", OTHER_FLD, N_("Mounted on"), 0, false, false }, [FILE_FIELD] = { FILE_FIELD, "file", OTHER_FLD, N_("File"), 0, false, false } }; static char const *all_args_string = "source,fstype,itotal,iused,iavail,ipcent,size," "used,avail,pcent,file,target"; /* Storage for the definition of output columns. */ static struct field_data_t **columns; /* The current number of output columns. */ static size_t ncolumns; /* Field values. */ struct field_values_t { uintmax_t input_units; uintmax_t output_units; uintmax_t total; uintmax_t available; bool negate_available; uintmax_t available_to_root; uintmax_t used; bool negate_used; }; /* Storage for pointers for each string (cell of table). */ static char ***table; /* The current number of processed rows (including header). */ static size_t nrows; /* For long options that have no equivalent short option, use a non-character as a pseudo short option, starting with CHAR_MAX + 1. */ enum { NO_SYNC_OPTION = CHAR_MAX + 1, SYNC_OPTION, TOTAL_OPTION, OUTPUT_OPTION }; static struct option const long_options[] = { {"all", no_argument, nullptr, 'a'}, {"block-size", required_argument, nullptr, 'B'}, {"inodes", no_argument, nullptr, 'i'}, {"human-readable", no_argument, nullptr, 'h'}, {"si", no_argument, nullptr, 'H'}, {"local", no_argument, nullptr, 'l'}, {"output", optional_argument, nullptr, OUTPUT_OPTION}, {"portability", no_argument, nullptr, 'P'}, {"print-type", no_argument, nullptr, 'T'}, {"sync", no_argument, nullptr, SYNC_OPTION}, {"no-sync", no_argument, nullptr, NO_SYNC_OPTION}, {"total", no_argument, nullptr, TOTAL_OPTION}, {"type", required_argument, nullptr, 't'}, {"exclude-type", required_argument, nullptr, 'x'}, {GETOPT_HELP_OPTION_DECL}, {GETOPT_VERSION_OPTION_DECL}, {nullptr, 0, nullptr, 0} }; /* Stat FILE and put the results into *ST. Return 0 if successful, an error number otherwise. Try to open FILE before statting, to trigger automounts. */ static int automount_stat_err (char const *file, struct stat *st) { int fd = open (file, O_RDONLY | O_NOCTTY | O_NONBLOCK); if (fd < 0) { if (errno == ENOENT || errno == ENOTDIR) return errno; return stat (file, st) == 0 ? 0 : errno; } else { int err = fstat (fd, st) == 0 ? 0 : errno; close (fd); return err; } } enum { MBSWIDTH_FLAGS = MBSW_REJECT_INVALID | MBSW_REJECT_UNPRINTABLE }; /* Replace problematic chars with '?'. Since only control characters are currently considered, this should work in all encodings. */ static void replace_control_chars (char *cell) { char *p = cell; while (*p) { if (c_iscntrl (to_uchar (*p))) *p = '?'; p++; } } /* Replace problematic chars with '?'. */ static void replace_invalid_chars (char *cell) { char *srcend = cell + strlen (cell); char *dst = cell; mbstate_t mbstate; mbszero (&mbstate); size_t n; for (char *src = cell; src != srcend; src += n) { char32_t wc; size_t srcbytes = srcend - src; n = mbrtoc32 (&wc, src, srcbytes, &mbstate); bool ok = n <= srcbytes; if (ok) ok = !c32iscntrl (wc); else n = 1; if (ok) { memmove (dst, src, n); dst += n; } else { *dst++ = '?'; memset (&mbstate, 0, sizeof mbstate); } } *dst = '\0'; } static void replace_problematic_chars (char *cell) { static int tty_out = -1; if (tty_out < 0) tty_out = isatty (STDOUT_FILENO); (tty_out ? replace_invalid_chars : replace_control_chars) (cell) ; } /* Dynamically allocate a row of pointers in TABLE, which can then be accessed with standard 2D array notation. */ static void alloc_table_row (void) { nrows++; table = xnrealloc (table, nrows, sizeof (char **)); table[nrows - 1] = xnmalloc (ncolumns, sizeof (char *)); } /* Output each cell in the table, accounting for the alignment and max width of each column. */ static void print_table (void) { size_t row; for (row = 0; row < nrows; row++) { size_t col; for (col = 0; col < ncolumns; col++) { char *cell = table[row][col]; /* Note the SOURCE_FIELD used to be displayed on it's own line if (!posix_format && mbswidth (cell) > 20), but that functionality was probably more problematic than helpful, hence changed in commit v8.10-40-g99679ff. */ if (col != 0) putchar (' '); int width = mbswidth (cell, MBSWIDTH_FLAGS); int fill = width < 0 ? 0 : columns[col]->width - width; if (columns[col]->align_right) for (; 0 < fill; fill--) putchar (' '); fputs (cell, stdout); if (col + 1 < ncolumns) for (; 0 < fill; fill--) putchar (' '); } putchar ('\n'); } } /* Dynamically allocate a struct field_t in COLUMNS, which can then be accessed with standard array notation. */ static void alloc_field (int f, char const *c) { ncolumns++; columns = xnrealloc (columns, ncolumns, sizeof (struct field_data_t *)); columns[ncolumns - 1] = &field_data[f]; if (c != nullptr) columns[ncolumns - 1]->caption = c; affirm (!field_data[f].used); /* Mark field as used. */ field_data[f].used = true; } /* Given a string, ARG, containing a comma-separated list of arguments to the --output option, add the appropriate fields to columns. */ static void decode_output_arg (char const *arg) { char *arg_writable = xstrdup (arg); char *s = arg_writable; do { /* find next comma */ char *comma = strchr (s, ','); /* If we found a comma, put a NUL in its place and advance. */ if (comma) *comma++ = 0; /* process S. */ display_field_t field = INVALID_FIELD; for (idx_t i = 0; i < ARRAY_CARDINALITY (field_data); i++) { if (STREQ (field_data[i].arg, s)) { field = i; break; } } if (field == INVALID_FIELD) { error (0, 0, _("option --output: field %s unknown"), quote (s)); usage (EXIT_FAILURE); } if (field_data[field].used) { /* Prevent the fields from being used more than once. */ error (0, 0, _("option --output: field %s used more than once"), quote (field_data[field].arg)); usage (EXIT_FAILURE); } switch (field) { case SOURCE_FIELD: case FSTYPE_FIELD: case USED_FIELD: case PCENT_FIELD: case ITOTAL_FIELD: case IUSED_FIELD: case IAVAIL_FIELD: case IPCENT_FIELD: case TARGET_FIELD: case FILE_FIELD: alloc_field (field, nullptr); break; case SIZE_FIELD: alloc_field (field, N_("Size")); break; case AVAIL_FIELD: alloc_field (field, N_("Avail")); break; default: affirm (!"invalid field"); } s = comma; } while (s); free (arg_writable); } /* Get the appropriate columns for the mode. */ static void get_field_list (void) { switch (header_mode) { case DEFAULT_MODE: alloc_field (SOURCE_FIELD, nullptr); if (print_type) alloc_field (FSTYPE_FIELD, nullptr); alloc_field (SIZE_FIELD, nullptr); alloc_field (USED_FIELD, nullptr); alloc_field (AVAIL_FIELD, nullptr); alloc_field (PCENT_FIELD, nullptr); alloc_field (TARGET_FIELD, nullptr); break; case HUMAN_MODE: alloc_field (SOURCE_FIELD, nullptr); if (print_type) alloc_field (FSTYPE_FIELD, nullptr); alloc_field (SIZE_FIELD, N_("Size")); alloc_field (USED_FIELD, nullptr); alloc_field (AVAIL_FIELD, N_("Avail")); alloc_field (PCENT_FIELD, nullptr); alloc_field (TARGET_FIELD, nullptr); break; case INODES_MODE: alloc_field (SOURCE_FIELD, nullptr); if (print_type) alloc_field (FSTYPE_FIELD, nullptr); alloc_field (ITOTAL_FIELD, nullptr); alloc_field (IUSED_FIELD, nullptr); alloc_field (IAVAIL_FIELD, nullptr); alloc_field (IPCENT_FIELD, nullptr); alloc_field (TARGET_FIELD, nullptr); break; case POSIX_MODE: alloc_field (SOURCE_FIELD, nullptr); if (print_type) alloc_field (FSTYPE_FIELD, nullptr); alloc_field (SIZE_FIELD, nullptr); alloc_field (USED_FIELD, nullptr); alloc_field (AVAIL_FIELD, nullptr); alloc_field (PCENT_FIELD, N_("Capacity")); alloc_field (TARGET_FIELD, nullptr); break; case OUTPUT_MODE: if (!ncolumns) { /* Add all fields if --output was given without a field list. */ decode_output_arg (all_args_string); } break; default: unreachable (); } } /* Obtain the appropriate header entries. */ static void get_header (void) { size_t col; alloc_table_row (); for (col = 0; col < ncolumns; col++) { char *cell = nullptr; char const *header = _(columns[col]->caption); if (columns[col]->field == SIZE_FIELD && (header_mode == DEFAULT_MODE || (header_mode == OUTPUT_MODE && !(human_output_opts & human_autoscale)))) { char buf[LONGEST_HUMAN_READABLE + 1]; int opts = (human_suppress_point_zero | human_autoscale | human_SI | (human_output_opts & (human_group_digits | human_base_1024 | human_B))); /* Prefer the base that makes the human-readable value more exact, if there is a difference. */ uintmax_t q1000 = output_block_size; uintmax_t q1024 = output_block_size; bool divisible_by_1000; bool divisible_by_1024; do { divisible_by_1000 = q1000 % 1000 == 0; q1000 /= 1000; divisible_by_1024 = q1024 % 1024 == 0; q1024 /= 1024; } while (divisible_by_1000 & divisible_by_1024); if (divisible_by_1000 < divisible_by_1024) opts |= human_base_1024; if (divisible_by_1024 < divisible_by_1000) opts &= ~human_base_1024; if (! (opts & human_base_1024)) opts |= human_B; char *num = human_readable (output_block_size, buf, opts, 1, 1); /* Reset the header back to the default in OUTPUT_MODE. */ header = _("blocks"); /* TRANSLATORS: this is the "1K-blocks" header in "df" output. */ if (asprintf (&cell, _("%s-%s"), num, header) == -1) cell = nullptr; } else if (header_mode == POSIX_MODE && columns[col]->field == SIZE_FIELD) { char buf[INT_BUFSIZE_BOUND (uintmax_t)]; char *num = umaxtostr (output_block_size, buf); /* TRANSLATORS: this is the "1024-blocks" header in "df -P". */ if (asprintf (&cell, _("%s-%s"), num, header) == -1) cell = nullptr; } else cell = strdup (header); if (!cell) xalloc_die (); replace_problematic_chars (cell); table[nrows - 1][col] = cell; int cell_width = mbswidth (cell, MBSWIDTH_FLAGS); columns[col]->width = MAX (columns[col]->width, cell_width); } } /* Is FSTYPE a type of file system that should be listed? */ ATTRIBUTE_PURE static bool selected_fstype (char const *fstype) { const struct fs_type_list *fsp; if (fs_select_list == nullptr || fstype == nullptr) return true; for (fsp = fs_select_list; fsp; fsp = fsp->fs_next) if (STREQ (fstype, fsp->fs_name)) return true; return false; } /* Is FSTYPE a type of file system that should be omitted? */ ATTRIBUTE_PURE static bool excluded_fstype (char const *fstype) { const struct fs_type_list *fsp; if (fs_exclude_list == nullptr || fstype == nullptr) return false; for (fsp = fs_exclude_list; fsp; fsp = fsp->fs_next) if (STREQ (fstype, fsp->fs_name)) return true; return false; } static size_t devlist_hash (void const *x, size_t table_size) { struct devlist const *p = x; return (uintmax_t) p->dev_num % table_size; } static bool devlist_compare (void const *x, void const *y) { struct devlist const *a = x; struct devlist const *b = y; return a->dev_num == b->dev_num; } static struct devlist * devlist_for_dev (dev_t dev) { if (devlist_table == nullptr) return nullptr; struct devlist dev_entry; dev_entry.dev_num = dev; struct devlist *found = hash_lookup (devlist_table, &dev_entry); if (found == nullptr) return nullptr; /* Return the last devlist entry we have seen with this dev_num */ return found->seen_last; } /* Filter mount list by skipping duplicate entries. In the case of duplicates - based on the device number - the mount entry with a '/' in its me_devname (i.e., not pseudo name like tmpfs) wins. If both have a real devname (e.g. bind mounts), then that with the shorter me_mountdir wins. With DEVICES_ONLY == true (set with df -a), only update the global devlist_table, rather than filtering the global mount_list. */ static void filter_mount_list (bool devices_only) { struct mount_entry *me; /* Temporary list to keep entries ordered. */ struct devlist *device_list = nullptr; int mount_list_size = 0; for (me = mount_list; me; me = me->me_next) mount_list_size++; devlist_table = hash_initialize (mount_list_size, nullptr, devlist_hash, devlist_compare, nullptr); if (devlist_table == nullptr) xalloc_die (); /* Sort all 'wanted' entries into the list device_list. */ for (me = mount_list; me;) { struct stat buf; struct mount_entry *discard_me = nullptr; /* Avoid stating remote file systems as that may hang. On Linux we probably have me_dev populated from /proc/self/mountinfo, however we still stat() in case another device was mounted later. */ if ((me->me_remote && show_local_fs) || (me->me_dummy && !show_all_fs && !show_listed_fs) || (!selected_fstype (me->me_type) || excluded_fstype (me->me_type)) || -1 == stat (me->me_mountdir, &buf)) { /* If remote, and showing just local, or FS type is excluded, add ME for filtering later. If stat failed; add ME to be able to complain about it later. */ buf.st_dev = me->me_dev; } else { /* If we've already seen this device... */ struct devlist *seen_dev = devlist_for_dev (buf.st_dev); if (seen_dev) { bool target_nearer_root = strlen (seen_dev->me->me_mountdir) > strlen (me->me_mountdir); /* With bind mounts, prefer items nearer the root of the source */ bool source_below_root = seen_dev->me->me_mntroot != nullptr && me->me_mntroot != nullptr && (strlen (seen_dev->me->me_mntroot) < strlen (me->me_mntroot)); if (! print_grand_total && me->me_remote && seen_dev->me->me_remote && ! STREQ (seen_dev->me->me_devname, me->me_devname)) { /* Don't discard remote entries with different locations, as these are more likely to be explicitly mounted. However avoid this when producing a total to give a more accurate value in that case. */ } else if ((strchr (me->me_devname, '/') /* let "real" devices with '/' in the name win. */ && ! strchr (seen_dev->me->me_devname, '/')) /* let points towards the root of the device win. */ || (target_nearer_root && ! source_below_root) /* let an entry overmounted on a new device win... */ || (! STREQ (seen_dev->me->me_devname, me->me_devname) /* ... but only when matching an existing mnt point, to avoid problematic replacement when given inaccurate mount lists, seen with some chroot environments for example. */ && STREQ (me->me_mountdir, seen_dev->me->me_mountdir))) { /* Discard mount entry for existing device. */ discard_me = seen_dev->me; seen_dev->me = me; } else { /* Discard mount entry currently being processed. */ discard_me = me; } } } if (discard_me) { me = me->me_next; if (! devices_only) free_mount_entry (discard_me); } else { /* Add the device number to the device_table. */ struct devlist *devlist = xmalloc (sizeof *devlist); devlist->me = me; devlist->dev_num = buf.st_dev; devlist->next = device_list; device_list = devlist; struct devlist *hash_entry = hash_insert (devlist_table, devlist); if (hash_entry == nullptr) xalloc_die (); /* Ensure lookups use this latest devlist. */ hash_entry->seen_last = devlist; me = me->me_next; } } /* Finally rebuild the mount_list from the devlist. */ if (! devices_only) { mount_list = nullptr; while (device_list) { /* Add the mount entry. */ me = device_list->me; me->me_next = mount_list; mount_list = me; struct devlist *next = device_list->next; free (device_list); device_list = next; } hash_free (devlist_table); devlist_table = nullptr; } } /* Search a mount entry list for device id DEV. Return the corresponding mount entry if found or nullptr if not. */ ATTRIBUTE_PURE static struct mount_entry const * me_for_dev (dev_t dev) { struct devlist *dl = devlist_for_dev (dev); if (dl) return dl->me; return nullptr; } /* Return true if N is a known integer value. On many file systems, UINTMAX_MAX represents an unknown value; on AIX, UINTMAX_MAX - 1 represents unknown. Use a rule that works on AIX file systems, and that almost-always works on other types. */ static bool known_value (uintmax_t n) { return n < UINTMAX_MAX - 1; } /* Like human_readable (N, BUF, human_output_opts, INPUT_UNITS, OUTPUT_UNITS), except: - If NEGATIVE, then N represents a negative number, expressed in two's complement. - Otherwise, return "-" if N is unknown. */ static char const * df_readable (bool negative, uintmax_t n, char *buf, uintmax_t input_units, uintmax_t output_units) { if (! known_value (n) && !negative) return "-"; else { char *p = human_readable (negative ? -n : n, buf + negative, human_output_opts, input_units, output_units); if (negative) *--p = '-'; return p; } } /* Add integral value while using uintmax_t for value part and separate negation flag. It adds value of SRC and SRC_NEG to DEST and DEST_NEG. The result will be in DEST and DEST_NEG. See df_readable to understand how the negation flag is used. */ static void add_uint_with_neg_flag (uintmax_t *dest, bool *dest_neg, uintmax_t src, bool src_neg) { if (*dest_neg == src_neg) { *dest += src; return; } if (*dest_neg) *dest = -*dest; if (src_neg) src = -src; if (src < *dest) *dest -= src; else { *dest = src - *dest; *dest_neg = src_neg; } if (*dest_neg) *dest = -*dest; } /* Return true if S ends in a string that may be a 36-byte UUID, i.e., of the form HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH, where each H is an upper or lower case hexadecimal digit. */ ATTRIBUTE_PURE static bool has_uuid_suffix (char const *s) { size_t len = strlen (s); return (36 < len && strspn (s + len - 36, "-0123456789abcdefABCDEF") == 36); } /* Obtain the block values BV and inode values IV from the file system usage FSU. */ static void get_field_values (struct field_values_t *bv, struct field_values_t *iv, const struct fs_usage *fsu) { /* Inode values. */ iv->input_units = iv->output_units = 1; iv->total = fsu->fsu_files; iv->available = iv->available_to_root = fsu->fsu_ffree; iv->negate_available = false; iv->used = UINTMAX_MAX; iv->negate_used = false; if (known_value (iv->total) && known_value (iv->available_to_root)) { iv->used = iv->total - iv->available_to_root; iv->negate_used = (iv->total < iv->available_to_root); } /* Block values. */ bv->input_units = fsu->fsu_blocksize; bv->output_units = output_block_size; bv->total = fsu->fsu_blocks; bv->available = fsu->fsu_bavail; bv->available_to_root = fsu->fsu_bfree; bv->negate_available = (fsu->fsu_bavail_top_bit_set && known_value (fsu->fsu_bavail)); bv->used = UINTMAX_MAX; bv->negate_used = false; if (known_value (bv->total) && known_value (bv->available_to_root)) { bv->used = bv->total - bv->available_to_root; bv->negate_used = (bv->total < bv->available_to_root); } } /* Add block and inode values to grand total. */ static void add_to_grand_total (struct field_values_t *bv, struct field_values_t *iv) { if (known_value (iv->total)) grand_fsu.fsu_files += iv->total; if (known_value (iv->available)) grand_fsu.fsu_ffree += iv->available; if (known_value (bv->total)) grand_fsu.fsu_blocks += bv->input_units * bv->total; if (known_value (bv->available_to_root)) grand_fsu.fsu_bfree += bv->input_units * bv->available_to_root; if (known_value (bv->available)) add_uint_with_neg_flag (&grand_fsu.fsu_bavail, &grand_fsu.fsu_bavail_top_bit_set, bv->input_units * bv->available, bv->negate_available); } /* Obtain a space listing for the device with absolute file name DEVICE. If MOUNT_POINT is non-null, it is the name of the root of the file system on DEVICE. If STAT_FILE is non-null, it is the name of a file within the file system that the user originally asked for; this provides better diagnostics, and sometimes it provides better results on networked file systems that give different free-space results depending on where in the file system you probe. If FSTYPE is non-null, it is the type of the file system on DEVICE. If MOUNT_POINT is non-null, then DEVICE may be null -- certain systems may not be able to produce statistics in this case. ME_DUMMY and ME_REMOTE are the mount entry flags. Caller must set PROCESS_ALL to true when iterating over all entries, as when df is invoked with no non-option argument. See below for details. */ static void get_dev (char const *device, char const *mount_point, char const *file, char const *stat_file, char const *fstype, bool me_dummy, bool me_remote, const struct fs_usage *force_fsu, bool process_all) { if (me_remote && show_local_fs) return; if (me_dummy && !show_all_fs && !show_listed_fs) return; if (!selected_fstype (fstype) || excluded_fstype (fstype)) return; /* Ignore relative MOUNT_POINTs, which are present for example in /proc/mounts on Linux with network namespaces. */ if (!force_fsu && mount_point && ! IS_ABSOLUTE_FILE_NAME (mount_point)) return; /* If MOUNT_POINT is null, then the file system is not mounted, and this program reports on the file system that the special file is on. It would be better to report on the unmounted file system, but statfs doesn't do that on most systems. */ if (!stat_file) stat_file = mount_point ? mount_point : device; struct fs_usage fsu; if (force_fsu) fsu = *force_fsu; else if (get_fs_usage (stat_file, device, &fsu)) { /* If we can't access a system provided entry due to it not being present (now), or due to permissions, just output placeholder values rather than failing. */ if (process_all && (errno == EACCES || errno == ENOENT)) { if (! show_all_fs) return; fstype = "-"; fsu.fsu_bavail_top_bit_set = false; fsu.fsu_blocksize = fsu.fsu_blocks = fsu.fsu_bfree = fsu.fsu_bavail = fsu.fsu_files = fsu.fsu_ffree = UINTMAX_MAX; } else { error (0, errno, "%s", quotef (stat_file)); exit_status = EXIT_FAILURE; return; } } else if (process_all && show_all_fs) { /* Ensure we don't output incorrect stats for over-mounted directories. Discard stats when the device name doesn't match. Though don't discard when used and current mount entries are both remote due to the possibility of aliased host names or exports. */ struct stat sb; if (stat (stat_file, &sb) == 0) { struct mount_entry const * dev_me = me_for_dev (sb.st_dev); if (dev_me && ! STREQ (dev_me->me_devname, device) && (! dev_me->me_remote || ! me_remote)) { fstype = "-"; fsu.fsu_bavail_top_bit_set = false; fsu.fsu_blocksize = fsu.fsu_blocks = fsu.fsu_bfree = fsu.fsu_bavail = fsu.fsu_files = fsu.fsu_ffree = UINTMAX_MAX; } } } if (fsu.fsu_blocks == 0 && !show_all_fs && !show_listed_fs) return; if (! force_fsu) file_systems_processed = true; alloc_table_row (); if (! device) device = "-"; /* unknown */ if (! file) file = "-"; /* unspecified */ char *dev_name = xstrdup (device); char *resolved_dev; /* On some systems, dev_name is a long-named symlink like /dev/disk/by-uuid/828fc648-9f30-43d8-a0b1-f7196a2edb66 pointing to a much shorter and more useful name like /dev/sda1. It may also look like /dev/mapper/luks-828fc648-9f30-43d8-a0b1-f7196a2edb66 and point to /dev/dm-0. When process_all is true and dev_name is a symlink whose name ends with a UUID use the resolved name instead. */ if (process_all && has_uuid_suffix (dev_name) && (resolved_dev = canonicalize_filename_mode (dev_name, CAN_EXISTING))) { free (dev_name); dev_name = resolved_dev; } if (! fstype) fstype = "-"; /* unknown */ struct field_values_t block_values; struct field_values_t inode_values; get_field_values (&block_values, &inode_values, &fsu); /* Add to grand total unless processing grand total line. */ if (print_grand_total && ! force_fsu) add_to_grand_total (&block_values, &inode_values); size_t col; for (col = 0; col < ncolumns; col++) { char buf[LONGEST_HUMAN_READABLE + 2]; char *cell; struct field_values_t *v; switch (columns[col]->field_type) { case BLOCK_FLD: v = &block_values; break; case INODE_FLD: v = &inode_values; break; case OTHER_FLD: v = nullptr; break; default: affirm (!"bad field_type"); } switch (columns[col]->field) { case SOURCE_FIELD: cell = xstrdup (dev_name); break; case FSTYPE_FIELD: cell = xstrdup (fstype); break; case SIZE_FIELD: case ITOTAL_FIELD: cell = xstrdup (df_readable (false, v->total, buf, v->input_units, v->output_units)); break; case USED_FIELD: case IUSED_FIELD: cell = xstrdup (df_readable (v->negate_used, v->used, buf, v->input_units, v->output_units)); break; case AVAIL_FIELD: case IAVAIL_FIELD: cell = xstrdup (df_readable (v->negate_available, v->available, buf, v->input_units, v->output_units)); break; case PCENT_FIELD: case IPCENT_FIELD: { double pct = -1; if (! known_value (v->used) || ! known_value (v->available)) ; else if (!v->negate_used && v->used <= TYPE_MAXIMUM (uintmax_t) / 100 && v->used + v->available != 0 && (v->used + v->available < v->used) == v->negate_available) { uintmax_t u100 = v->used * 100; uintmax_t nonroot_total = v->used + v->available; pct = u100 / nonroot_total + (u100 % nonroot_total != 0); } else { /* The calculation cannot be done easily with integer arithmetic. Fall back on floating point. This can suffer from minor rounding errors, but doing it exactly requires multiple precision arithmetic, and it's not worth the aggravation. */ double u = v->negate_used ? - (double) - v->used : v->used; double a = v->negate_available ? - (double) - v->available : v->available; double nonroot_total = u + a; if (nonroot_total) { long int lipct = pct = u * 100 / nonroot_total; double ipct = lipct; /* Like 'pct = ceil (dpct);', but avoid ceil so that the math library needn't be linked. */ if (ipct - 1 < pct && pct <= ipct + 1) pct = ipct + (ipct < pct); } } if (0 <= pct) { if (asprintf (&cell, "%.0f%%", pct) == -1) cell = nullptr; } else cell = strdup ("-"); if (!cell) xalloc_die (); break; } case FILE_FIELD: cell = xstrdup (file); break; case TARGET_FIELD: #ifdef HIDE_AUTOMOUNT_PREFIX /* Don't print the first directory name in MOUNT_POINT if it's an artifact of an automounter. This is a bit too aggressive to be the default. */ if (STRNCMP_LIT (mount_point, "/auto/") == 0) mount_point += 5; else if (STRNCMP_LIT (mount_point, "/tmp_mnt/") == 0) mount_point += 8; #endif cell = xstrdup (mount_point); break; default: affirm (!"unhandled field"); } affirm (cell); replace_problematic_chars (cell); int cell_width = mbswidth (cell, MBSWIDTH_FLAGS); columns[col]->width = MAX (columns[col]->width, cell_width); table[nrows - 1][col] = cell; } free (dev_name); } /* Scan the mount list returning the _last_ device found for MOUNT. nullptr is returned if MOUNT not found. The result is malloced. */ static char * last_device_for_mount (char const *mount) { struct mount_entry const *me; struct mount_entry const *le = nullptr; for (me = mount_list; me; me = me->me_next) { if (STREQ (me->me_mountdir, mount)) le = me; } if (le) { char *devname = le->me_devname; char *canon_dev = canonicalize_file_name (devname); if (canon_dev && IS_ABSOLUTE_FILE_NAME (canon_dev)) return canon_dev; free (canon_dev); return xstrdup (le->me_devname); } else return nullptr; } /* If DEVICE corresponds to a mount point, show its usage and return true. Otherwise, return false. */ static bool get_device (char const *device) { struct mount_entry const *me; struct mount_entry const *best_match = nullptr; bool best_match_accessible = false; bool eclipsed_device = false; char const *file = device; char *resolved = canonicalize_file_name (device); if (resolved && IS_ABSOLUTE_FILE_NAME (resolved)) device = resolved; size_t best_match_len = SIZE_MAX; for (me = mount_list; me; me = me->me_next) { /* TODO: Should cache canon_dev in the mount_entry struct. */ char *devname = me->me_devname; char *canon_dev = canonicalize_file_name (me->me_devname); if (canon_dev && IS_ABSOLUTE_FILE_NAME (canon_dev)) devname = canon_dev; if (STREQ (device, devname)) { char *last_device = last_device_for_mount (me->me_mountdir); eclipsed_device = last_device && ! STREQ (last_device, devname); size_t len = strlen (me->me_mountdir); if (! eclipsed_device && (! best_match_accessible || len < best_match_len)) { struct stat device_stats; bool this_match_accessible = false; if (stat (me->me_mountdir, &device_stats) == 0) best_match_accessible = this_match_accessible = true; if (this_match_accessible || (! best_match_accessible && len < best_match_len)) { best_match = me; if (len == 1) /* Traditional root. */ { free (last_device); free (canon_dev); break; } else best_match_len = len; } } free (last_device); } free (canon_dev); } free (resolved); if (best_match) { get_dev (best_match->me_devname, best_match->me_mountdir, file, nullptr, best_match->me_type, best_match->me_dummy, best_match->me_remote, nullptr, false); return true; } else if (eclipsed_device) { error (0, 0, _("cannot access %s: over-mounted by another device"), quoteaf (file)); exit_status = EXIT_FAILURE; return true; } return false; } /* Figure out which device file or directory POINT is mounted on and show its device usage. STATP must be the result of 'stat (POINT, STATP)'. */ static void get_point (char const *point, const struct stat *statp) { struct stat device_stats; struct mount_entry *me; struct mount_entry const *best_match = nullptr; /* Calculate the real absolute file name for POINT, and use that to find the mount point. This avoids statting unavailable mount points, which can hang df. */ char *resolved = canonicalize_file_name (point); if (resolved && resolved[0] == '/') { size_t resolved_len = strlen (resolved); size_t best_match_len = 0; for (me = mount_list; me; me = me->me_next) { if (!STREQ (me->me_type, "lofs") && (!best_match || best_match->me_dummy || !me->me_dummy)) { size_t len = strlen (me->me_mountdir); if (best_match_len <= len && len <= resolved_len && (len == 1 /* root file system */ || ((len == resolved_len || resolved[len] == '/') && STREQ_LEN (me->me_mountdir, resolved, len)))) { best_match = me; best_match_len = len; } } } } free (resolved); if (best_match && (stat (best_match->me_mountdir, &device_stats) != 0 || device_stats.st_dev != statp->st_dev)) best_match = nullptr; if (! best_match) for (me = mount_list; me; me = me->me_next) { if (me->me_dev == (dev_t) -1) { if (stat (me->me_mountdir, &device_stats) == 0) me->me_dev = device_stats.st_dev; else { /* Report only I/O errors. Other errors might be caused by shadowed mount points, which means POINT can't possibly be on this file system. */ if (errno == EIO) { error (0, errno, "%s", quotef (me->me_mountdir)); exit_status = EXIT_FAILURE; } /* So we won't try and fail repeatedly. */ me->me_dev = (dev_t) -2; } } if (statp->st_dev == me->me_dev && !STREQ (me->me_type, "lofs") && (!best_match || best_match->me_dummy || !me->me_dummy)) { /* Skip bogus mtab entries. */ if (stat (me->me_mountdir, &device_stats) != 0 || device_stats.st_dev != me->me_dev) me->me_dev = (dev_t) -2; else best_match = me; } } if (best_match) get_dev (best_match->me_devname, best_match->me_mountdir, point, point, best_match->me_type, best_match->me_dummy, best_match->me_remote, nullptr, false); else { /* We couldn't find the mount entry corresponding to POINT. Go ahead and print as much info as we can; methods that require the device to be present will fail at a later point. */ /* Find the actual mount point. */ char *mp = find_mount_point (point, statp); if (mp) { get_dev (nullptr, mp, point, nullptr, nullptr, false, false, nullptr, false); free (mp); } } } /* Determine what kind of node NAME is and show the device usage for it. STATP is the results of 'stat' on NAME. */ static void get_entry (char const *name, struct stat const *statp) { if ((S_ISBLK (statp->st_mode) || S_ISCHR (statp->st_mode)) && get_device (name)) return; get_point (name, statp); } /* Show all mounted file systems, except perhaps those that are of an unselected type or are empty. */ static void get_all_entries (void) { struct mount_entry *me; filter_mount_list (show_all_fs); for (me = mount_list; me; me = me->me_next) get_dev (me->me_devname, me->me_mountdir, nullptr, nullptr, me->me_type, me->me_dummy, me->me_remote, nullptr, true); } /* Add FSTYPE to the list of file system types to display. */ static void add_fs_type (char const *fstype) { struct fs_type_list *fsp; fsp = xmalloc (sizeof *fsp); fsp->fs_name = (char *) fstype; fsp->fs_next = fs_select_list; fs_select_list = fsp; } /* Add FSTYPE to the list of file system types to be omitted. */ static void add_excluded_fs_type (char const *fstype) { struct fs_type_list *fsp; fsp = xmalloc (sizeof *fsp); fsp->fs_name = (char *) fstype; fsp->fs_next = fs_exclude_list; fs_exclude_list = fsp; } void usage (int status) { if (status != EXIT_SUCCESS) emit_try_help (); else { printf (_("Usage: %s [OPTION]... [FILE]...\n"), program_name); fputs (_("\ Show information about the file system on which each FILE resides,\n\ or all file systems by default.\n\ "), stdout); emit_mandatory_arg_note (); /* TRANSLATORS: The thousands and decimal separators are best adjusted to an appropriate default for your locale. */ fputs (_("\ -a, --all include pseudo, duplicate, inaccessible file systems\n\ -B, --block-size=SIZE scale sizes by SIZE before printing them; e.g.,\n\ '-BM' prints sizes in units of 1,048,576 bytes;\n\ see SIZE format below\n\ -h, --human-readable print sizes in powers of 1024 (e.g., 1023M)\n\ -H, --si print sizes in powers of 1000 (e.g., 1.1G)\n\ "), stdout); fputs (_("\ -i, --inodes list inode information instead of block usage\n\ -k like --block-size=1K\n\ -l, --local limit listing to local file systems\n\ --no-sync do not invoke sync before getting usage info (default)\ \n\ "), stdout); fputs (_("\ --output[=FIELD_LIST] use the output format defined by FIELD_LIST,\n\ or print all fields if FIELD_LIST is omitted.\n\ -P, --portability use the POSIX output format\n\ --sync invoke sync before getting usage info\n\ "), stdout); fputs (_("\ --total elide all entries insignificant to available space,\n\ and produce a grand total\n\ "), stdout); fputs (_("\ -t, --type=TYPE limit listing to file systems of type TYPE\n\ -T, --print-type print file system type\n\ -x, --exclude-type=TYPE limit listing to file systems not of type TYPE\n\ -v (ignored)\n\ "), stdout); fputs (HELP_OPTION_DESCRIPTION, stdout); fputs (VERSION_OPTION_DESCRIPTION, stdout); emit_blocksize_note ("DF"); emit_size_note (); fputs (_("\n\ FIELD_LIST is a comma-separated list of columns to be included. Valid\n\ field names are: 'source', 'fstype', 'itotal', 'iused', 'iavail', 'ipcent',\n\ 'size', 'used', 'avail', 'pcent', 'file' and 'target' (see info page).\n\ "), stdout); emit_ancillary_info (PROGRAM_NAME); } exit (status); } int main (int argc, char **argv) { struct stat *stats = nullptr; initialize_main (&argc, &argv); set_program_name (argv[0]); setlocale (LC_ALL, ""); bindtextdomain (PACKAGE, LOCALEDIR); textdomain (PACKAGE); atexit (close_stdout); fs_select_list = nullptr; fs_exclude_list = nullptr; show_all_fs = false; show_listed_fs = false; human_output_opts = -1; print_type = false; file_systems_processed = false; exit_status = EXIT_SUCCESS; print_grand_total = false; grand_fsu.fsu_blocksize = 1; /* If true, use the POSIX output format. */ bool posix_format = false; char const *msg_mut_excl = _("options %s and %s are mutually exclusive"); while (true) { int oi = -1; int c = getopt_long (argc, argv, "aB:iF:hHklmPTt:vx:", long_options, &oi); if (c == -1) break; switch (c) { case 'a': show_all_fs = true; break; case 'B': { enum strtol_error e = human_options (optarg, &human_output_opts, &output_block_size); if (e != LONGINT_OK) xstrtol_fatal (e, oi, c, long_options, optarg); } break; case 'i': if (header_mode == OUTPUT_MODE) { error (0, 0, msg_mut_excl, "-i", "--output"); usage (EXIT_FAILURE); } header_mode = INODES_MODE; break; case 'h': human_output_opts = human_autoscale | human_SI | human_base_1024; output_block_size = 1; break; case 'H': human_output_opts = human_autoscale | human_SI; output_block_size = 1; break; case 'k': human_output_opts = 0; output_block_size = 1024; break; case 'l': show_local_fs = true; break; case 'm': /* obsolescent, exists for BSD compatibility */ human_output_opts = 0; output_block_size = 1024 * 1024; break; case 'T': if (header_mode == OUTPUT_MODE) { error (0, 0, msg_mut_excl, "-T", "--output"); usage (EXIT_FAILURE); } print_type = true; break; case 'P': if (header_mode == OUTPUT_MODE) { error (0, 0, msg_mut_excl, "-P", "--output"); usage (EXIT_FAILURE); } posix_format = true; break; case SYNC_OPTION: require_sync = true; break; case NO_SYNC_OPTION: require_sync = false; break; case 'F': /* Accept -F as a synonym for -t for compatibility with Solaris. */ case 't': add_fs_type (optarg); break; case 'v': /* For SysV compatibility. */ /* ignore */ break; case 'x': add_excluded_fs_type (optarg); break; case OUTPUT_OPTION: if (header_mode == INODES_MODE) { error (0, 0, msg_mut_excl, "-i", "--output"); usage (EXIT_FAILURE); } if (posix_format && header_mode == DEFAULT_MODE) { error (0, 0, msg_mut_excl, "-P", "--output"); usage (EXIT_FAILURE); } if (print_type) { error (0, 0, msg_mut_excl, "-T", "--output"); usage (EXIT_FAILURE); } header_mode = OUTPUT_MODE; if (optarg) decode_output_arg (optarg); break; case TOTAL_OPTION: print_grand_total = true; break; case_GETOPT_HELP_CHAR; case_GETOPT_VERSION_CHAR (PROGRAM_NAME, AUTHORS); default: usage (EXIT_FAILURE); } } if (human_output_opts == -1) { if (posix_format) { human_output_opts = 0; output_block_size = (getenv ("POSIXLY_CORRECT") ? 512 : 1024); } else human_options (getenv ("DF_BLOCK_SIZE"), &human_output_opts, &output_block_size); } if (header_mode == INODES_MODE || header_mode == OUTPUT_MODE) ; else if (human_output_opts & human_autoscale) header_mode = HUMAN_MODE; else if (posix_format) header_mode = POSIX_MODE; /* Fail if the same file system type was both selected and excluded. */ { bool match = false; struct fs_type_list *fs_incl; for (fs_incl = fs_select_list; fs_incl; fs_incl = fs_incl->fs_next) { struct fs_type_list *fs_excl; for (fs_excl = fs_exclude_list; fs_excl; fs_excl = fs_excl->fs_next) { if (STREQ (fs_incl->fs_name, fs_excl->fs_name)) { error (0, 0, _("file system type %s both selected and excluded"), quote (fs_incl->fs_name)); match = true; break; } } } if (match) return EXIT_FAILURE; } if (optind < argc) { /* stat each of the given entries to make sure any corresponding partition is automounted. This must be done before reading the file system table. */ stats = xnmalloc (argc - optind, sizeof *stats); for (int i = optind; i < argc; ++i) { int err = automount_stat_err (argv[i], &stats[i - optind]); if (err != 0) { error (0, err, "%s", quotef (argv[i])); exit_status = EXIT_FAILURE; argv[i] = nullptr; } } } mount_list = read_file_system_list ((fs_select_list != nullptr || fs_exclude_list != nullptr || print_type || field_data[FSTYPE_FIELD].used || show_local_fs)); if (mount_list == nullptr) { /* Couldn't read the table of mounted file systems. Fail if df was invoked with no file name arguments, or when either of -a, -l, -t or -x is used with file name arguments. Otherwise, merely give a warning and proceed. */ int status = 0; if ( ! (optind < argc) || (show_all_fs || show_local_fs || fs_select_list != nullptr || fs_exclude_list != nullptr)) { status = EXIT_FAILURE; } char const *warning = (status == 0 ? _("Warning: ") : ""); error (status, errno, "%s%s", warning, _("cannot read table of mounted file systems")); } if (require_sync) sync (); get_field_list (); get_header (); if (stats) { /* Display explicitly requested empty file systems. */ show_listed_fs = true; for (int i = optind; i < argc; ++i) if (argv[i]) get_entry (argv[i], &stats[i - optind]); } else get_all_entries (); if (file_systems_processed) { if (print_grand_total) get_dev ("total", (field_data[SOURCE_FIELD].used ? "-" : "total"), nullptr, nullptr, nullptr, false, false, &grand_fsu, false); print_table (); } else { /* Print the "no FS processed" diagnostic only if there was no preceding diagnostic, e.g., if all have been excluded. */ if (exit_status == EXIT_SUCCESS) error (EXIT_FAILURE, 0, _("no file systems processed")); } main_exit (exit_status); }