Dirname

Last updated
dirname
Developer(s) Various open-source and commercial developers
Operating system Unix, Unix-like, IBM i
Platform Cross-platform
Type Command
License coreutils: GPLv3+

dirname is a shell command for extracting the directory path portion of a path; without the last name. The command is specified in the Single UNIX Specification and is primarily used in shell scripts.

Contents

The version in GNU Core Utilities was written by David MacKenzie and Jim Meyering. [1] The command is available for Windows via UnxUtils, [2] and is in IBM i. [3]

Usage

The Single UNIX Specification is: dirname path.

Examples

The command reports the directory path portion of a path ignoring any trailing slashes.

$ dirname/home/martin/docs/base.wiki /home/martin/docs$ dirname/home/martin/docs/ /home/martin$ dirnamebase.wiki .

Performance

Since the command accepts only one operand, its usage within the inner loop of a shell script can be detrimental to performance. Consider:

whilereadfile;dodirname"$file"done<some-input 

The above causes a separate process invocation for each line of input. For this reason, shell substitution is typically used instead

echo"${file%/*}";

Or, if relative pathnames need to be handled as well:

if[-n"${file##*/*}"];thenecho"."elseecho"${file%/*}";fi

Note that these handle trailing slashes differently than dirname.

See also

References

  1. "Dirname(1) - Linux man page".
  2. "Native Win32 ports of some GNU utilities". unxutils.sourceforge.net.
  3. IBM. "IBM System i Version 7.2 Programming Qshell" (PDF). IBM . Archived (PDF) from the original on 2020-09-18. Retrieved 2020-09-05.