Check File and Directory Existence

Summary: Use -e, -f, -d to check file status.

When working with files and directories in shell scripting, it's essential to verify if certain files or directories exist before carrying out operations like reading, writing, or deleting. Bash provides several test operators to help you check the existence and type of filesystem objects. The most commonly used are -e, -f, and -d. Let's explore these in detail.

The Basics: What Do -e, -f, and -d Mean?

  • -e: Checks if a file or directory exists (regardless of type).
  • -f: Checks if a regular file (not a directory or device) exists.
  • -d: Checks if a directory exists.

These test options are used within square brackets ([ ]) in conditional statements.

1. Checking for Existence: -e

The -e flag is the general test for existence. It returns true if the specified file or directory exists:

if [ -e "/path/to/something" ]; then
    echo "File or directory exists!"
else
    echo "It does NOT exist."
fi

Use-case: Use -e when you don't care whether it is a file or directory, only that something exists at the specified path.

2. Is It a Regular File? -f

The -f flag checks specifically for regular files (excluding directories, devices, pipes, etc.):

if [ -f "/path/to/file.txt" ]; then
    echo "Regular file exists!"
else
    echo "Regular file does NOT exist."
fi

Use-case: Use -f when you want to ensure you're working with a normal file (for reading, writing, or processing).

3. Is It a Directory? -d

The -d flag checks specifically for directories:

if [ -d "/path/to/directory" ]; then
    echo "Directory exists!"
else
    echo "Directory does NOT exist."
fi

Use-case: Use -d when you need to confirm a directory's presence (for storing files, navigating directories, etc.).

4. Putting It All Together: Combined Checks

You can also combine these checks to handle multiple scenarios. Here’s an example:

path="/some/path"

if [ -d "$path" ]; then
    echo "'$path' is a directory."
elif [ -f "$path" ]; then
    echo "'$path' is a regular file."
elif [ -e "$path" ]; then
    echo "'$path' exists, but is not a regular file or directory."
else
    echo "'$path' does not exist."
fi

This script will tell you precisely what kind of object (if any) exists at the given path.

5. Scripting Best Practices

  • Always quote your variables: To avoid errors with spaces or special characters in paths, always enclose your variables in quotes ("$path").
  • Choose the right test: Be clear about what you actually want to check—existence, file type, or directory.
  • Use double brackets ([[ ... ]]) for modern Bash: They're more robust and handle complex expressions better.

Example:

if [[ -f "$file" && -w "$file" ]]; then
    echo "File exists and is writable."
fi

Conclusion

Checking the status of files and directories using -e, -f, and -d is a fundamental skill for anyone writing shell scripts. Choosing the right test ensures your scripts are robust and error-free. Whether you need to process files, create backups, or manage directories, these simple conditional operators are essential tools in your scripting toolbox.

Quick Reference Table

Operator Checks if... Example
-e File or directory exists [ -e "/path/to/obj" ]
-f Regular file exists [ -f "/path/to/file" ]
-d Directory exists [ -d "/path/to/dir" ]

Use them wisely and your scripts will be safer and more reliable!

Back to All Articles