Symlinks

pls can trace symlinks to their targets, and in the process identify broken or circular symlinks. pls will also expand chains of symlinks.

Arguments

--sym/-l can be used to turn symlink tracing on or off. It is turned on by default but disabled in grid view due to space constraints.

Caution

Note that symlink tracing (which can take large amounts of horizontal space) is incompatible with the grid view. In case of conflict, the grid view will be used and symlink tracing will be turned off.

Otherwise, you may disable the grid view using --grid=false/-g=false.

Examples

pls # or --sym=true or -l=true

  dir/
󰌹  a@ 󰑙 a
󰌹  b@ 󰑙 c
󰌹  c@ 󰑙 b
󰌹  d@ 󱞣 nonexistent
󰌹  e@ 󰁔 dir
󰌹  f@ 󰁔 dir
󰌹  g@ 󰁔 f 󰁔 dir

pls --sym=false # or -l=false

  dir/
󰌹  a@
󰌹  b@
󰌹  c@
󰌹  d@
󰌹  e@
󰌹  f@
󰌹  g@

Configuration

Using the configuration system, you can customise the symlink styles and arrows. Note that for valid symlinks, the style is only applied to the arrow and not the target.

Examples

.pls.yml

entry_const:
  symlink:
    ok:
      sep: -->
      style: green
    broken:
      sep: ~~>
      style: red bold
    cyclic:
      sep: \<-> # '<' must be escaped
      style: yellow italic
    error:
      sep: -x-
      style: red italic

  dir/
󰌹  a@ <-> a
󰌹  b@ <-> c
󰌹  c@ <-> b
󰌹  d@ ~~> nonexistent
󰌹  e@ --> dir
󰌹  f@ --> dir
󰌹  g@ --> f --> dir
 .pls.yml