List Files in Directory - Showing Project Status

The CLI Program vls - Vov List Files in Project

The command line program vls lists the files in the current directory with respect to their role in the current project. All files in the directory are listed. Files from the project are shown with information about their state and role within the project. Other files are labeled to indicate they are not used within the project.

With no options, vls shows the status of the file, its role in the project's dependency graph and its name. The label "UNKNOWN" is used to indicate files that have no role in the project.

List Files in Current Directory

% vls
VALID      i  aa
VALID      o  bb
            UNKNOWN bbb
VALID      u  cmd_vls_help.txt
VALID      u  cmd_vovassist.txt
VALID      u  cmd_vovcapsule.txt

List Files using LONG Format

Options -long and -LONG give more information for files in the project.

The option -long or -l reports on project files in a long format, showing their level, their VovId, their project role, their status and their name.

The option -LONG or -L reports on project files in an even longer format, showing their level, their VovId, the number of their inputs and outputs, their status and their name.

% vls -L
1 03182557 (   0,   1) VALID      Flow.tcl
3 03778456 (   0,  24) VALID      buffer.cc
          UNKNOWN buffer.cc.~1.6.~
1 03778453 (   0,  82) VALID      buffer.hh
          UNKNOWN buffer.hh.~1.2.~
3 00003662 (   0,  62) VALID      bufperf.hh

List Specific Files and Files in a Specific Directory

The command line program vls can also be called to list information about specific files and directories of the project, referencing them by name.

You can combine any number of files and directories and you can use file name wild-card characters of '?' and '*'.

% vls aa bb ../dir1 *.txt
VALID      i  aa
VALID      o  bb
VALID      i  ../dir1/Flow.tcl
VALID      u  ../dir1/buffer.cc
     UNKNOWN  ../dir1/buffer.cc~1.6.~
VALID      u  ../dir1/buffer.hh
     UNKNOWN  ../dir1/bufferf.hh!1.2.~
VALID      u  ../dir1/bufferf.hh
VALID      u  cmd_vls_help.txt
VALID      u  cmd_vovassist.txt
VALID      u  cmd_vovcapsule.txt