dark

basename – Print the basename of a directory or file

The basename command is a Linux utility that is used to print the basename of a directory or file. The basename refers to the last component of a path, which is typically the name of the file or directory. This command is useful for scripts and other automation tasks that require the extraction of the filename or directory name from a path.

Overview

The basic syntax for the basename command is as follows:

basename [path] [suffix]

The path argument specifies the path to the file or directory whose basename you want to print. The suffix argument is an optional parameter that specifies a string to be removed from the end of the basename.

Here are some examples of how to use the basename command:

$ basename /home/user/file.txt
file.txt

$ basename /home/user/dir/
dir

$ basename /home/user/file.txt .txt
file

In the first example, the basename command prints the basename of the file /home/user/file.txt, which is file.txt. In the second example, the basename command prints the basename of the directory /home/user/dir/, which is dir. In the third example, the basename command prints the basename of the file /home/user/file.txt, but removes the .txt suffix, resulting in the output file.

Options

The basename command has the following options:

Option Description
-a, --multiple Print multiple basenames, one per line
-s, --suffix=SUFFIX Remove a suffix from the end of the basename
-z, --zero Separate basenames with null characters instead of newlines

Troubleshooting tips

If the basename command is not producing the expected output, here are some troubleshooting tips:

  • Double-check the path argument to ensure that it is correct and refers to an existing file or directory.
  • If using the --suffix option, make sure that the suffix is spelled correctly and matches the end of the basename.
  • If using the --multiple option, make sure that the path argument refers to a directory containing multiple files or directories.

Notes

  • The basename command is case-sensitive, so make sure that the path argument and suffix argument (if used) match the case of the actual file or directory name.
  • If the --zero option is used to separate basenames with null characters, the output can be piped to other commands that support null-separated input, such as xargs -0.

Related commands