z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

Related Information
cmp, diff
dirname — Return the directory components of a pathname
Format
Description
Examples
Localization
Exit Values
Portablity
dirname pathname
dirname deletes the trailing part of a filename. The result is the pathname of the
directory that contains the file. This is useful in shell scripts. dirname does not try
to validate the pathname. For validation, use pathchk.
dirname follows these rules:
1. If pathname is //, return it.
2. Otherwise, if it is all slashes, return one slash.
3. Otherwise, remove all trailing slashes.
4. If there are no slashes remaining in pathname, return period (.).
5. Otherwise, remove trailing nonslash characters.
6. If the remaining string is //, return it.
7. Otherwise, remove any trailing slashes.
8. If the resulting string is empty, return period (.).
9. Otherwise, return the resulting string.
The command:
dirname src/lib/printf.c
produces:
src/lib
dirname uses the following localization environment variables:
v LANG
v LC_ALL
v LC_CTYPE
v LC_MESSAGES
v NLSPATH
See Appendix F for more information.
0 Successful completion
1 Failed
2 Unknown command-line option
Related Information
basename, pathchk
POSIX.2, X/Open Portability Guide, UNIX systems.
dircmp
Chapter 2. Shell command descriptions 241