Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor10916521091652 fs_cd Anchor10916531091653Change the working directory. Anchor10927291092729

Usages

Anchor10916561091656fs_cd [dir] Anchor10929371092937

Arguments

Anchor10916581091658dir Anchor10995361099536

Absolute directory path.

...

OR

...

...

Path relative to current working directory.

...

Output

Anchor10916621091662None. Anchor10934291093429

Required Configuration

...

Available only if FS_SHELL_CFG_CD_EN is DEF_ENABLED. Anchor10936371093637

Notes/Warnings

Anchor10916661091666The new working directory is formed in three steps:

...

  1. 1091667If the argument dir begins with the path separator character (slash, ‘\’) or a volume name, it will be interpreted as an absolute directory path and will become the preliminary working directory. Otherwise the preliminary working directory path is formed by the concatenation of the current working directory, a path separator character and dir. Anchor10916681091668
  2. The preliminary working directory path is then refined, from the first to last path component:

...

    1. ...

        1. If the component is a ‘dot’ component, it is removed

      ...

        1. If the component is a ‘dot dot’ component, and the preliminary working directory path is not NULL, the previous path component is removed. In any case, the ‘dot dot’ component is removed.

      ...

        1. Trailing path separator characters are removed, and multiple path separator characters are replaced by a single path separator character.

      ...

      1. Anchor10916721091672
      2. The volume is examined to determine whether the preliminary working directory exists. If it does, it becomes the new working directory. Otherwise, an error is output, and the working directory is unchanged.