manpagez: man pages & more
man di(1)
Home | html | info | man
di(1)                                                                    di(1)




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 spec-
              ified.  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 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 dif-
              ferent 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.  Multi-
              ple  -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.

       -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.  Use-
              ful 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.

       --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  filesys-
              tems (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  fol-
       lowing 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  long-
              est 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 maxi-
              mum 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  nor-
              mal  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).

       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 cre-
              ated 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:
              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 loca-
       tion 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)



                                  17 Jan 2013                            di(1)

di 4.50 - Generated Sat Apr 10 09:21:17 CDT 2021
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.