pwd(1)

pwd1

Return working directory name

Usage

pwd [{-L | -P}]

Overview

The pwd utility writes the absolute pathname of the current working directory to the standard output.

Some shells may provide a builtin pwd command which is similar or identical to this utility. Consult the builtin(1) manual page.

The options are as follows:

-L

Display the logical current working directory.

-P

Display the physical current working directory (all symbolic links resolved).

If no options are specified, the -L option is assumed.

Environment

Environment variables used by pwd:

PWD

Logical current working directory.

Exit status

The pwd utility exits 0 on success, and >0 if an error occurs.

Examples

Show current working directory with symbolic links resolved:

$ /bin/pwd -P
/usr/home/fernape

Show the logical current directory. Then use file(1) to inspect the /home directory:

$ /bin/pwd
/home/fernape
$ file /home
/home: symbolic link to usr/home

Releases

163 releases since Mac OS X 10.0; the text changed 3 times.

  1. 10.0–10.1.5
  2. 10.2–10.4.11
  3. 10.5–11.5
  4. 12.0.1–26.5

Standards

The pwd utility conforms to IEEE Std 1003.1-2001 (“POSIX.1”).

History

The pwd command appeared in Version 5 AT&T UNIX.

Bugs

In csh(1) the command dirs is always faster because it is built into that shell. However, it can give a different answer in the rare case that the current directory or a containing directory was moved after the shell descended into it.

The -L option does not work unless the PWD environment variable is exported by the shell.

From shell_cmds 329 in macOS 26.5. Parsed by carta from the page's mdoc source.