Header

pls shows headers above columns to help understand the output better. If not set, these headers intelligently appear when they are needed.

Arguments

--header/-H can be used to turn headers on or off. It is turned on by default if the details view is enabled.

Caution

This flag has no effect unless the detail view is enabled with --det/-d.

Examples

pls --det=std # or --header=true or -H=true

​Link# T Permissions User   Group      Size Modified            Name
    2 d rwx r-x r-x runner docker          2024-Nov-06 09:01pm   dir/
    1 l rwx rwx rwx runner docker 10.0   B 2024-Nov-06 09:01pm 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner docker  9.0   B 2024-Nov-06 09:01pm 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner docker  0.0   B 2024-Nov-06 09:01pm 󰟥  fifo|
    1 f rw- r-- r-- runner docker  1.0 MiB 2024-Nov-06 09:01pm    file
    1 s rwx r-x r-x runner docker  0.0   B 2024-Nov-06 09:01pm 󰟨  socket=
    1 l rwx rwx rwx runner docker  5.0   B 2024-Nov-06 09:01pm 󰌹  sym@ 󰁔 ./dir

pls --det=std --header=false # or -H=false

​2 d rwx r-x r-x runner docker          2024-Nov-06 09:01pm   dir/
1 l rwx rwx rwx runner docker 10.0   B 2024-Nov-06 09:01pm 󰌹  block_dev@ 󱞣 /dev/disk0
1 l rwx rwx rwx runner docker  9.0   B 2024-Nov-06 09:01pm 󰌹  char_dev@ 󰁔 /dev/null
1 p rw- r-- r-- runner docker  0.0   B 2024-Nov-06 09:01pm 󰟥  fifo|
1 f rw- r-- r-- runner docker  1.0 MiB 2024-Nov-06 09:01pm    file
1 s rwx r-x r-x runner docker  0.0   B 2024-Nov-06 09:01pm 󰟨  socket=
1 l rwx rwx rwx runner docker  5.0   B 2024-Nov-06 09:01pm 󰌹  sym@ 󰁔 ./dir

Configuration

Using the configuration system, you can modify the column headers and change their appearance using styling rules.

See the detail view configuration for an example.