mirror of
https://github.com/flokoe/bash-hackers-wiki.git
synced 2024-11-01 14:53:06 +01:00
60 lines
1.6 KiB
Markdown
60 lines
1.6 KiB
Markdown
|
# The cd builtin command
|
||
|
|
|
||
|
|
## Synopsis
|
||
|
|
|
||
|
|
cd [-L|-P] [DIRECTORY]
|
||
|
|
|
||
|
|
cd -
|
||
|
|
|
||
|
|
## Description
|
||
|
|
|
||
|
|
The `cd` builtin command is used to change the current working directory
|
||
|
|
|
||
|
|
- to the given directory (`cd DIRECTORY`)
|
||
|
|
- to the previous working directory (`cd -`) as saved in the
|
||
|
|
[OLDPWD](/syntax/shellvars#OLDPWD) shell variable
|
||
|
|
- to the user\'s home directory as specified in the
|
||
|
|
[HOME](/syntax/shellvars#HOME) environment variable (when used
|
||
|
|
without a `DIRECTORY` argument)
|
||
|
|
|
||
|
|
The `cd` builtin command searches the directories listed in
|
||
|
|
[CDPATH](/syntax/shellvars#CDPATH) for a matching directory.
|
||
|
|
|
||
|
|
The default behaviour is to follow symbolic links unless the `-P` option
|
||
|
|
is given or the shell is configured to do so (see the `-P` option of
|
||
|
|
[the set builtin command](/commands/builtin/set)).
|
||
|
|
|
||
|
|
### Options
|
||
|
|
|
||
|
|
Option Description
|
||
|
|
-------- ----------------------------------------------------
|
||
|
|
`-L` Follow symbolic links (default)
|
||
|
|
`-P` Do not follow symbolic links
|
||
|
|
`-@` Browse a file\'s extended attributed, if supported
|
||
|
|
|
||
|
|
### Exit status
|
||
|
|
|
||
|
|
- true if the directory was changed successfully
|
||
|
|
- false if a change to the home directory was requested, but
|
||
|
|
[HOME](/syntax/shellvars#HOME) is unset
|
||
|
|
- false if anything else goes wrong
|
||
|
|
|
||
|
|
## Examples
|
||
|
|
|
||
|
|
### Change the working directory to the user\'s home directory
|
||
|
|
|
||
|
|
cd
|
||
|
|
|
||
|
|
### Change the working directory to the previous directory
|
||
|
|
|
||
|
|
cd -
|
||
|
|
|
||
|
|
## Portability considerations
|
||
|
|
|
||
|
|
## See also
|
||
|
|
|
||
|
|
- variable [CDPATH](/syntax/shellvars#CDPATH)
|
||
|
|
- variable [HOME](/syntax/shellvars#HOME)
|
||
|
|
- variable [OLDPWD](/syntax/shellvars#OLDPWD)
|
||
|
|
- the `-P` option of [the set builtin command](/commands/builtin/set)
|