Back to Commands

basename

file managementlinux
The basename command is one of the most frequently used commands in Linux/Unix-like operating systems. basename The basename command strips directory and suffix from filenames. It is used to extract just the filename from a path or to remove a suffix from a filename.
See ExamplesView Syntax

Quick Reference

Command Name:

basename

Category:

file management

Platform:

linux

Basic Usage:

basename [options] [arguments]

Common Use Cases

  • 1

    File path processing

    Extract the filename from a full path

  • 2

    Script automation

    Process file paths in automated scripts

  • 3

    File management

    Work with filenames without directory components

  • 4

    Path manipulation

    Extract and manipulate file path components

Syntax

basename NAME [SUFFIX]
basename OPTION... NAME...

Options

Option Description
-a, --multiple Support multiple arguments and treat each as a NAME (GNU version)
-s, --suffix=SUFFIX Remove a trailing SUFFIX; implies -a (GNU version)
-z, --zero End each output line with NUL, not newline (GNU version)
--help Display help information and exit
--version Output version information and exit

Examples

How to Use These Examples

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

Basic Examples:

Extract filename from a path
basename /usr/local/bin/example.txt
Remove extension from a filename
basename example.txt .txt
Extract filename from a path with trailing slash
basename /usr/local/bin/
Process multiple files (GNU version only)
basename -a /path/file1.txt /path/file2.txt

Advanced Examples:

Use in a shell script to process filenames
for file in /var/log/*.log; do
name=$(basename "$file") echo "Processing $name" done
Remove any suffix (not just extension)
basename myfile.backup .backup
Multiple suffix handling
basename myfile.tar.gz .tar.gz
Use with dirname to get both path components
path="/home/user/documents/report.pdf"
dir=$(dirname "$path") file=$(basename "$path") echo "Directory: $dir, File: $file"

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

Purpose and Functionality:

The basename command serves a simple but essential purpose in shell scripting and path handling:

  • It extracts the final component from a pathname, removing any leading directory components.
  • If specified, it also removes a trailing suffix from the filename.
  • It's commonly used in scripts to process filenames without their directory paths.
  • basename is complementary to the dirname command, which extracts the directory portion of a path.

Implementation Notes:

  • basename considers a trailing slash (/) to refer to a directory, and returns the last directory name.
  • The SUFFIX is removed only if it matches exactly at the end of the NAME.
  • If NAME consists solely of slashes, basename will return a single slash.
  • basename ignores any non-existent or inaccessible pathnames - it operates purely on the string.
  • basename always treats its input as a string, not as an actual file path that needs to exist.

Variations Between Implementations:

  • GNU basename (common on Linux systems) includes additional options like -a for multiple arguments.
  • BSD and POSIX versions may have fewer options and slightly different behavior with edge cases.
  • Some shells like bash include a built-in basename functionality that can be faster than the external command.
  • In bash, you can use parameter expansion: ${filename##*/} to get the basename of $filename.
  • Similarly, in bash ${filename%.*} removes the extension from a filename.

Common Use Cases:

  • Shell scripts that process files and need to work with just the filenames.
  • Creating output files with names based on input files but with different extensions.
  • Log file naming based on script names (e.g., $(basename "$0").log).
  • Displaying user-friendly filenames without their full paths.

Common Use Cases

File path processing

Extract the filename from a full path

Script automation

Process file paths in automated scripts

File management

Work with filenames without directory components

Path manipulation

Extract and manipulate file path components

Cross-platform compatibility

Handle file paths consistently across systems

Related Commands

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

dirname
realpath
readlink
ls
find
pwd
cd
mv
Explore All Commands

Use Cases

1

File path processing

Extract the filename from a full path

2

Script automation

Process file paths in automated scripts

3

File management

Work with filenames without directory components

4

Path manipulation

Extract and manipulate file path components

5

Cross-platform compatibility

Handle file paths consistently across systems

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 basename command works in different scenarios.

See ExamplesTry Lab Exercises
$ basename
View All Commands