PWD(1) General Commands Manual PWD(1)

pwdreturn working directory name

pwd [-L | -P]

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:

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

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

Environment variables used by pwd:

Logical current working directory.

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

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

builtin(1), cd(1), csh(1), realpath(1), sh(1), getcwd(3)

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

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

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.

October 24, 2020 Mac OS X 12