Back to Commands

ustat

file systemLinux/Unix
The ustat command is one of the most frequently used commands in Linux/Unix-like operating systems. ustat Display file system statistics
See ExamplesView Syntax

Quick Reference

Command Name:

ustat

Category:

file system

Platform:

Linux/Unix

Basic Usage:

ustat [options] [arguments]

Common Use Cases

    Syntax

    ustat [-fv] device

    Options

    Option Description
    -f Include the file system type in the display
    -v Display verbose information
    device The device to display statistics for

    Examples

    How to Use These Examples

    The examples below show common ways to use the ustat command. Try them in your terminal to see the results. You can copy any example by clicking on the code block.

    Basic Examples:

    Display file system statistics for a device
    sudo ustat /dev/sda1
    Display file system statistics including the filesystem type
    sudo ustat -f /dev/sda1
    Display verbose file system statistics
    sudo ustat -v /dev/sda1

    Advanced Examples:

    Compare with more modern tools like df
    echo "ustat output:"
    sudo ustat /dev/sda1
    echo "df output:" df -h /dev/sda1
    Get file system statistics for all mounted devices using a loop
    for device in $(mount | grep '^/dev' | cut -d' ' -f1); do
    echo "Statistics for $device:" sudo ustat $device done
    Save file system statistics to a log file
    sudo ustat -v /dev/sda1 > filesystem_stats.log
    Check free space and alert if below threshold
    free_blocks=$(sudo ustat /dev/sda1 | grep 'free blocks' | awk '{print $1}')
    if [ "$free_blocks" -lt 1000 ]; then echo "Warning: Low disk space on /dev/sda1" fi
    Use with other system monitoring commands
    echo "=== System storage information ==="
    echo "ustat:" 
    sudo ustat -v /dev/sda1
    echo "df:" df -h /dev/sda1 echo "mount:" mount | grep /dev/sda1
    Periodically monitor file system usage
    while true; do
    echo "$(date): File system statistics" sudo ustat -v /dev/sda1 sleep 3600 # Check every hour done

    Try It Yourself

    Practice makes perfect! The best way to learn is by trying these examples on your own system with real files.

    Understanding Syntax

    Pay attention to the syntax coloring: commands, options, and file paths are highlighted differently.

    Notes

    The `ustat` command is an older Unix/Linux utility used to display statistics about a mounted file system. It retrieves and displays information such as the total number of blocks, free blocks, total number of inodes, and free inodes for a given device. **Historical Context and Deprecation:** The `ustat` command was originally part of early Unix systems but has been deprecated in most modern Linux distributions in favor of more feature-rich tools like `df` and `stat`. In fact, many current Linux distributions may not include `ustat` by default, and the system call it relies on (`ustat()`) has been marked as obsolete in the Linux kernel. **Key Features and Output:** When executed, `ustat` typically displays: 1. **Total blocks**: The total storage capacity of the file system. 2. **Free blocks**: Available storage space. 3. **Total inodes**: The total number of inodes (data structures that store information about files and directories). 4. **Free inodes**: Available inodes for new files and directories. With the `-f` option, it also shows the file system type. **Limitations and Reasons for Deprecation:** 1. **Limited functionality**: `ustat` provides only basic information compared to modern alternatives. 2. **Inconsistent block size reporting**: Different systems might interpret the block sizes differently. 3. **Poor human-readability**: Output is typically in raw blocks without conversion to human-readable units. 4. **Lack of standardization**: Behavior and availability vary across Unix-like systems. **Modern Alternatives:** 1. **`df`**: The most common replacement, providing human-readable output with the `-h` option and more detailed information about file system usage. 2. **`stat`**: Offers detailed information about files and file systems, with many formatting options. 3. **`findfs`**: Used for finding a file system by label or UUID. 4. **`lsblk`**: Lists information about all available block devices. 5. **`fdisk -l`**: Shows partition information for all disks. **Usage Considerations:** If you encounter `ustat` in older scripts or documentation, it's generally recommended to update these references to use more modern alternatives like `df` or `stat`. These commands are more widely supported, provide more comprehensive information, and offer better formatting options. For historical or educational purposes, `ustat` demonstrates how Unix systems have evolved over time in terms of system administration tools and APIs. The deprecation of `ustat` reflects the broader trend in Unix/Linux systems toward more user-friendly, feature-rich, and standardized utilities for system administration tasks.

    Related Commands

    These commands are frequently used alongside ustat or serve similar purposes:

    df
    stat
    fsck
    mount
    lsblk
    Explore All Commands

    Use Cases

    Learn By Doing

    The best way to learn Linux commands is by practicing. Try out these examples in your terminal to build muscle memory and understand how the ustat command works in different scenarios.

    See ExamplesTry Lab Exercises
    $ ustat
    View All Commands