packages icon



 di(1)                                                                 di(1)
                                 17 Jan 2013



 Name
      di - disk information

 Synopsis
      di [-AacghHjklLmnPqRtZ] [-B block-size] [-d display-size] [-f format]
      [-I include-fstyp-list] [-s sort-type] [-w block-width] [-W
      inode-width] [-x exclude-fstyp-list] [-X debug-level] [-z zone-name]
      [file [...]]

      mi

 Description
      di Displays usage information on mounted filesystems.  Block values
      are reported in a human readable format.  If the user or group has a
      disk quota, the values reported are adjusted according the quotas that
      apply to the user.

      If file is specified, the usage information for the partition on which
      file is located is printed.

      Unless the -a flag is specified, the following mounted filesystems
      will not normally be displayed: filesystems with total space <= 0;
      loopback filesystems that are duplicates of other normally mounted
      filesystems (filesystem type of 'lofs' , 'none', or 'nullfs');
      loopback filesystems that are part of a zone (Solaris); filesystems
      for which the system's ignore flag is set; filesystems that have a
      device name of 'tmpfs', 'cgroup' or 'swap'; filesystems that have a
      device name starting with

      Filesystems that the user does not have permissions to access will not
      be displayed at all.

      mi Displays the mounted filesystem information.

      Several options may be specified to control the output of di and mi:

      -A   Print all fields (used for debugging).  Mount points and device
           names are printed at full width.

      -a   (compatibility: --all)
           Prints all mounted devices (normally, those with 0 total space
           are not printed - e.g. /dev/proc, /dev/fd).

      -B   block-size (compatibility: --block-size, -b)
           Change the base block size from 1024 (default) to the size
           specified.  block-size may be one of: k - 1024 bytes, si - 1000
           bytes, or a specific size.

      -c   (alias: --csv-output)
           Comma separated values are output.  The titles are output as the
           format string specifiers.  Totals are turned off. See also the -n



                                    - 1 -        Formatted:  October 7, 2024






 di(1)                                                                 di(1)
                                 17 Jan 2013



           flag.

      -C   (alias: --csv-tabs)
           Values are output with tab separators.  See also the -c option.

      -d   display-size (alias: --display-size)
           Display the usage in units specified by display-size.  Note that
           if the base block size is SI units of 1000 bytes, the display
           size is calculated using those units.  display-size may be one
           of: 512 - POSIX, k - kilobytes, m - megabytes, g - gigabytes,
           t - terabytes, p - petabytes, e - exabytes, z - zettabytes,
           y - yottabytes, h - Scaled alternative 1, H - Scaled alternative
           2, or a specific value to use as the block size.

           Block display sizes greater than 1024 bytes are displayed with a
           precision of one decimal place after the radix.

           The Scaled alternatives scale the sizes displayed and appends a
           suffix (e.g. 48.0k, 3.4M).

           With scaled alternative 1, sizes within a line may scale to
           different units.

           Scaled alternative 2 scales all the sizes in each individual line
           to the same unit size (the largest needed).

      -f   format Use the specified format string format.  See the Format
           Strings section.

      -g   (alias for: -dg)
           Display sizes in gigabytes.

      -h   (alias for: -dh)
           Display partition sizes in scaled alternative 1 format.

      --help
           Display some basic usage information.

      -H   (alias for: -dH; compatibility: --human-readable)
           Display partition sizes in scaled alternative 2 format.

      -I   include-fstype-list (compatibility: -F, --type)
           Include only the file system types listed in include-fstyp-list.
           The list is a comma separated list of file system types.
           Multiple -I options may be specified.  If the 'fuse' filesystem
           type is specified, all fuse* filesystems will be included.
           e.g. -I nfs,tmpfs or -I nfs -I tmpfs.

      --inodes
           Ignored.  Use the -f option.




                                    - 2 -        Formatted:  October 7, 2024






 di(1)                                                                 di(1)
                                 17 Jan 2013



      -j   (alias: --json-output)
           The data is output as an array of json objects.  Totals are
           turned off.  Use of format specifiers that specify the same field
           will result in duplicated field names.  (e.g. p, 1, 2)

      -k   (alias for: -dk)
           Display sizes in Kbytes.

      -l   (compatibility: --local)
           Display only local file systems.

      -L   Turn off check for duplicate filesystems (loopback (lofs/none)
           mounts).

      -m   (alias for: -dm)
           Display sizes in megabytes.

      -n   Do not print a header line above the list of file systems.
           Useful when parsing the output of di.

      --no-sync
           Ignored.

      -P   (compatibility: --portability)
           Output format is POSIX standard.  512 byte block size is the
           default.  The -k option may be used.

      --print-type
           Ignored.  Use the -f option.

      -q   Disable quota checks.

      -R   (alias: --dont-resolve-symlinks)
           Do not resolve symlinks (for mount points that have a trailing
           UUID).

      -s   sort-type
           Use sort-type to sort the output.  The output of di is normally
           sorted by mount point.  The following sort flags may be used to
           change the sort order: m - by mount point (default); n - leave
           unsorted (as it appears in the mount table); s - by device name;
           T - by total space; f - by free space; a - by available space; t
           - by filesystem type; r - reverse the sort order; This will apply
           to all sort flags following this sort flag.

           These sort options may be combined in any order.  e.g.:
           di -stsrm # by type, device name, reversed mount;
           di -strsrm # by type, reversed device-name, mount.

      --si An alias for -dH -Bsi.




                                    - 3 -        Formatted:  October 7, 2024






 di(1)                                                                 di(1)
                                 17 Jan 2013



      --sync
           Ignored.

      -t   (compatibility: --total)
           Print a totals line below the list of file systems.  Pooled
           filesystems (zfs, advfs) have only the main pool added to the
           total.  Pooled filesystems that do not have pool information
           available (btrfs, apfs) will not total up correctly.  It is up to
           the user to exclude (using the -x option) read-only filesystems
           (cdfs, iso9660), swap-based (memfs, mfs, tmpfs) filesystems and
           user (fuse*) filesystems.  Excluding the 'fuse' filesystem will
           exclude all fuse* filesystems.

      -w   block-width
           Set the print width for block values.  The default is eight.

      -v   Ignored.

      --version
           Display di's version and default format string.

      -W   inode-width
           Set the print width for inode values.  Default is seven.

      -x   exclude-fstype-list (compatibility: --exclude-type)
           Exclude the file system types listed in exclude-fstyp-list.  The
           list is a comma separated list of file system types.  Multiple -x
           options may be specified.  If the 'fuse' filesystem type is
           excluded, all fuse* filesystems will be excluded.  e.g. -x
           nfs,tmpfs or -x nfs -x tmpfs.

      -X   level
           Set the program's debugging level to debug-level.

      -z   zone-name
           Display the filesystems for the specified zone.  The zone must be
           visible to the user.

      -Z   (alias for: -z all)
           Display the filesystems for all visible zones.

 Format Strings
      The output of di may be specified via a format string.  This string
      may be given either via the -f command line option or as part of the
      DI_ARGS environment variable.  The format string may specify the
      following columns:

      m    Print the name of the mount point.

      M    Print the name of the mount point, at full length.  The mount
           point is formatted to the maximum width necessary for the longest



                                    - 4 -        Formatted:  October 7, 2024






 di(1)                                                                 di(1)
                                 17 Jan 2013



           mount point name.

      s    Print the file system name (device name or remote mount point).

      S    Print the file system name (device name or remote mount point),
           at full length.  The file system name is formatted to the maximum
           width necessary for the longest file system name.

      t    Print the file system type.

      T    Print the file system type at full length.  The file system type
           is formatted to the maximum width necessary for the longest file
           system type.

      Total Available

      b    Print the total number of megabytes on the file system.

      B    Print the total number of megabytes on the file system available
           for use by normal users.

      In Use

      u    Print the number of megabytes in use on the file system (actual
           number of megabytes used = total - free).

      c    Print the number of megabytes not available for use by normal
           users (total - available).  Note that this calculation does work
           correctly the 'apfs' filesystem.

      Free

      f    Print the number of free (unused) megabytes on the file system.

      v    Print the number of megabytes available for use by normal users.

      Percentage Used

      p    Print the percentage of megabytes not available for use by normal
           users (number of megabytes not available for use / total disk
           space).

      1    Print the percentage of total megabytes in use (actual number of
           megabytes used / total disk space).

      2    Print the percentage of megabytes in use, BSD-style.  Represents
           the percentage of user-available space in use.  Note that values
           over 100% are possible (actual number of megabytes used / disk
           space available to non-root users).





                                    - 5 -        Formatted:  October 7, 2024






 di(1)                                                                 di(1)
                                 17 Jan 2013



      Percentage Free

      a    Print the percentage of megabytes available for use by normal
           users (number of megabytes available for use / total disk space).

      3    Print the percentage of total megabytes free (actual number of
           megabytes free / total disk space).

      Inodes

      i    Print the total number of file slots (inodes) that can be created
           on the file system.

      U    Print the number of file slots in use.

      F    Print the number of file slots available.

      P    Print the percentage of file slots in use.

      Mount Information

      I    Print the time the filesystem was mounted.  This column is not
           supported on all systems.

      O    Print the filesystem mount options.

      The default format string for di is smbuvpT.

      The default format string for mi is MSTIO.

      The format string may also contain any other character not listed
      above.  The character will be printed as is.  e.g. di -f 'mbuvp|iUFP'
      will print the character '|' between the disk usage and the file slot
      usage.  The command sequence:
           di -f 'mbuvp
           miUFP'
      will print two lines of data for each filesystem.

 Examples
      Various df equivalent format strings for System V release 4 are:
           /usr/bin/df -v     di -P -f msbuf1
           /usr/bin/df -k     di -dk -f sbcvpm
           /usr/ucb/df        di -dk -f sbuv2m
      GNU df:
           df                 di -dk -f SbuvpM -w 10
           df -T              di -dk -f STbuvpM -w 10
      AIX df:
           df                 di -d 512 -f Sbf1UPM -w 10
           df -I              di -d 512 -f Sbuf1M
           df -I -M           di -d 512 -f SMbuf1 -w 10
      HP-UX bdf:



                                    - 6 -        Formatted:  October 7, 2024






 di(1)                                                                 di(1)
                                 17 Jan 2013



           bdf                di -d k -f Sbuv2M
           bdf -i             di -d k -f Sbuv2UFPM

      If you like your numbers to add up/calculate the percentage correctly,
      try one of the following format strings:

           di -f SMbuf1T
           di -f SMbcvpT
           di -f SMBuv2T

 Environment Variables
      The DI_ARGS environment variable may be used to specify command line
      arguments.  e.g. If you always want gigabytes displayed, set DI_ARGS
      equal to "-dg".  Any command line arguments specified will override
      the DI_ARGS environment variable.

      The DI_LOCALE_DIR environment variable may be used to specify the
      location of the di program's locale message files.

      The GNU df POSIXLY_CORRECT, and DF_BLOCK_SIZE and the BSD BLOCKSIZE
      environment variables are honored.

 Note
      For filesystems that do not report available space (e.g. System V
      release 3), the number of available space is set to the free space.

 WARNING
      Do not replace your system's df command with this program.  You will
      in all likelihood break your installation procedures.

 See Also
      df(1), fstab(5), getmnt(2), getmntinfo(2), mnttab(4), mount(1M)
      statfs(2), statvfs(2)

 Bugs
      Send bug reports to: brad.lanam.di @ gmail.com

      Known Issues:

      di will probably not process a zettabyte or yottabyte sized filesystem
      properly due to overflow of a long long.

 Website
      https://diskinfo-di.sourceforge.io/

 Author
      This program is Copyright 1994-2021 by Brad Lanam.

      Brad Lanam, Pleasant Hill, CA (brad.lanam.di @ gmail.com)





                                    - 7 -        Formatted:  October 7, 2024