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-Apr-22 05:23am   dir/
    1 l rwx rwx rwx runner docker 10.0   B 2024-Apr-22 05:23am 󰌹  block_dev@ 󱞣 /dev/disk0
    1 l rwx rwx rwx runner docker  9.0   B 2024-Apr-22 05:23am 󰌹  char_dev@ 󰁔 /dev/null
    1 p rw- r-- r-- runner docker  0.0   B 2024-Apr-22 05:23am    fifo|
    1 f rw- r-- r-- runner docker  1.0 MiB 2024-Apr-22 05:23am    file
    1 s rwx r-x r-x runner docker  0.0   B 2024-Apr-22 05:23am    socket=
    1 l rwx rwx rwx runner docker  5.0   B 2024-Apr-22 05:23am 󰌹  sym@ 󰁔 ./dir

 

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

​2 d rwx r-x r-x runner docker          2024-Apr-22 05:23am   dir/
1 l rwx rwx rwx runner docker 10.0   B 2024-Apr-22 05:23am 󰌹  block_dev@ 󱞣 /dev/disk0
1 l rwx rwx rwx runner docker  9.0   B 2024-Apr-22 05:23am 󰌹  char_dev@ 󰁔 /dev/null
1 p rw- r-- r-- runner docker  0.0   B 2024-Apr-22 05:23am    fifo|
1 f rw- r-- r-- runner docker  1.0 MiB 2024-Apr-22 05:23am    file
1 s rwx r-x r-x runner docker  0.0   B 2024-Apr-22 05:23am    socket=
1 l rwx rwx rwx runner docker  5.0   B 2024-Apr-22 05:23am 󰌹  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.