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.

The project role is indicated by a one letter code:
  • i - primary input
  • o - primary output
  • u - used in the flow but not primary input or output

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.

The arguments following the options are interpreted as:
  • files
  • directories

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

vls

Display information about the files. By default, all files in the current working directory are listed.


vls: Usage Message
  
  DESCRIPTION:
      Display information about the files.  By default,
      all files in the current working directory are listed.
  
  USAGE:
      vls [OPTIONS] [file or dir] ...
  
  OPTIONS: 
      -help         -- Print this message
      -long         -- Give info in long format
      -LONG         -- Give info in even longer format
      -Output       -- Specify output format
  
      Options can be truncated to 1 or 2 characters.
  
  FORMATS:
      default: @STATUS:10@ @ZIPPED@ @IUO@  @NAME@
      long   : @LEVEL:3@ @ID@ @IUO@ @STATUS:10@ @ZIPPED@ @NAME@
      LONG   : @LEVEL:3@ @ID@ (@INPUTS:4@,@OUTPUTS:4@)
               @STATUS:10@ @ZIPPED@ @NAME@
  
  EXAMPLES:
      % vls
      % vls -l
      % vls foo*
      % vls dir1 ../dir2
      % vls -O "@ID@ @STATUS@ @TAIL@"