Basename

basename

Initial release	January 1979 (1979-01)
Operating system	Unix, Unix-like, Plan 9, Inferno
Type	Command
License	coreutils: GPLv3+

basename is a standard computer program on Unix and Unix-like operating systems. When basename is given a pathname, it will delete any prefix up to the last slash ('/') character and return the result. basename is described in the Single UNIX Specification and is primarily used in shell scripts.

History

basename was introduced in X/Open Portability Guidelines issue 2 of 1987.

The version of basename bundled in GNU coreutils was written by David MacKenzie.

The command is available as a separate package for Microsoft Windows as part of the GnuWin32 project and the UnxUtils collection of native Win32 ports of common GNU Unix-like utilities.

Usage

The Single UNIX Specification specification for basename is.

basename string [suffix]

string

A pathname

suffix

If specified, basename will also delete the suffix.

Examples

basename will retrieve the last name from a pathname ignoring any trailing slashes

$ basename /home/jsmith/base.wiki 
base.wiki

$ basename /home/jsmith/
jsmith

$ basename /
/

basename can also be used to remove the end of the base name, but not the complete base name

$ basename /home/jsmith/base.wiki .wiki
base

$ basename /home/jsmith/base.wiki ki
base.wi

$ basename /home/jsmith/base.wiki base.wiki
base.wiki

See also

• List of Unix commands
• dirname
• Path

External links

• basename: return non-directory portion of a pathname – Shell and Utilities Reference, The Single UNIX Specification, Version 4 from The Open Group
• basename(1) – Plan 9 Programmer's Manual, Volume 1
• basename(1) – Linux User Commands Manual
• basename(1) – OpenBSD General Commands Manual