What is df h

Last updated: April 1, 2026

Quick Answer: df -h is a Linux command that displays disk space usage for all mounted filesystems in human-readable format, converting sizes from bytes to GB, MB, or TB instead of raw block counts for easier interpretation.

Key Facts

Understanding df -h

The df -h command is one of the most frequently used disk management commands on Linux and Unix systems. The df utility stands for "disk free" and provides a summary of disk space usage across all mounted filesystems. The -h flag modifies the output to use human-readable format, converting raw byte values into more intuitive units like kilobytes (KB), megabytes (MB), gigabytes (GB), and terabytes (TB).

Output Explanation

When you run df -h, the output displays several columns: Filesystem (the device or mount point), Size (total capacity), Used (space currently occupied), Avail (available space for regular users), Use% (percentage of capacity used), and Mounted on (where the filesystem is attached to the directory structure). Each row represents a different mounted filesystem, allowing administrators to see the disk usage situation across all storage devices on the system at a glance.

Common Use Cases

System administrators use df -h regularly to monitor disk space, identify filesystems that are approaching capacity, and plan storage upgrades. Users might run it when experiencing disk space warnings or when troubleshooting application failures that might be related to insufficient disk space. The command is also frequently incorporated into system monitoring scripts, cron jobs, and alerting systems that automatically notify administrators when disk usage exceeds certain thresholds.

Related Command Options

Several variations of df -h exist for different purposes. The command df -h -l shows only local filesystems, excluding remote mounts. df -h -T adds a column showing the filesystem type (ext4, NTFS, XFS, etc.). For checking inode usage instead of disk space, df -h -i is useful. These options can be combined, such as df -h -l -T, to display customized information tailored to specific monitoring needs.

Performance Considerations

df -h is a lightweight command that executes quickly, even on systems with many mounted filesystems. It queries the kernel's filesystem information and returns results almost instantaneously. This makes it safe to run frequently in monitoring scripts without concern for system load. However, when accessing remote filesystems over slow network connections, df -h might take longer to respond for those particular mounts.

Related Questions

What is the df command in Linux?

The df command displays filesystem disk space usage. Without the -h flag, it shows sizes in 512-byte or 1024-byte blocks by default, making output difficult to interpret.

How do I check disk space usage by directory?

Use the du (disk usage) command instead, which shows space consumed by specific directories. du -h provides human-readable directory-level information complementing df output.

What does 'Use%' mean in df output?

The Use% column shows the percentage of the filesystem's total capacity currently occupied. Values above 80-90% typically warrant attention to prevent performance issues.

Sources

  1. Linux Manual Pages - df(1) Command Reference GPL
  2. GNU Coreutils - df Documentation GFDL