What is df h
Last updated: April 1, 2026
Key Facts
- The -h flag stands for "human-readable" and converts disk sizes from bytes to understandable units like KB, MB, GB, and TB automatically
- Running df -h displays columns for filesystem name, total size, used space, available space, percentage used, and the mount point where each filesystem is attached
- The command works across Linux, Unix, macOS, and most Unix-like operating systems with the standard df utility pre-installed
- Without the -h flag, df displays sizes in 1024-byte blocks by default, making numbers very large and difficult for humans to interpret quickly
- df -h is commonly used in scripts and automated monitoring systems to check disk space thresholds and trigger alerts when capacity limits are approached
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.