vsr

vsr: Usage Message
  DESCRIPTION:
      Retrace a list of files and directories.
      With the option '-set' you can retrace sets of nodes.
  
  USAGE:
      % vsr -help
      % vsr -set  <setName>
      % vsr [options] <id_or_file_or_directory> ...
  
      OPTIONS: All options can be abbreviated to one letter,
               except -safe, -fast, -aggressive, and -select.
  
  NORMAL FLAGS:
       -help          This message.
       -v             Increase verbosity.
       -all           Retrace the entire design (abbreviation -a).
       -force         Force retracing of failed nodes too.
                      Abbreviation: -f
       -hier          If target is a set with subsets, retrace all subsets.
       -kick          Kick a file: update all files that depend on it.
       -priority sp[.xp]
                      Specify the scheduling priority (sp) and optionally
                      also the execution priority (xp).
                      Both sp and xp can be one of:
                      LOW, NORMAL, HIGH, TOP or an integer in [1-15].
                      (Explanation: TOP=15  HIGH=8 NORMAL=4 LOW=1)
       -resources <r> Additional resources to be used for the jobs to be
                      retraced.  Abbreviation: -r
       -select <rule> Retrace nodes that match the given selection rule.
       -set <setName> Retrace all nodes in given set.
       -recompute     If used with -set, forces recomputation of named set.
       -timeout <timeSpec>
                      Wait for events for specified time, then exit if
                      no event arrives.
       -nowait        Exit immediately after issuing retracing request.
                      This is the same as "-timeout 0"
  
  
  ADVANCED FLAGS:
       -safe              All dependencies are computed again (default).
       -fast              Retrace without computing the dependencies again.
       -aggressive        Like safe, but retrace in parallel across barriers.
       -crossbarriers     Schedule jobs across barriers
                          Abbreviation: -cb
       -skipcheck         Do not check the upcone of the target.
       -checkall          Check all files in the upcone of the target.
       -nocheck           Do not check files in directories to retrace.
                          Implies -skipcheck.
       -unblock           Check blocking files before doing retrace.
       -retry <n>         Repeat retracing <n> times. The default is 1.
       -converge          Retry until the flow is complete or until the
                          failed/invalid job count is unchanged after 3 retrace
                          loops. If a retry number is specified, converge will
                          limit the number of retrace loops to that number.
       -statusreps <n>    Override the default of 3 for the maximum number of
                          repeated failed/invalid job counts for the converge
                          option.
  
  EXAMPLES:
      % vsr -help
      % vsr
      % vsr -priority high.high fileABC
      % vsr . -crossbarriers
      % vsr . -cb
      % vsr ../a ../b ../c/file
      % vsr -nowait -all
      % vsr -timeout 3h
      % vsr -retry 4 -timeout 100
      % vsr -set 'Stuff to do'
      % vsr -recompute -set 'Stuff to do'
      % vsr -select 'isjob tool==gzip'
  

You can request a run for a given target file with:

% vsr fileName_or_VovId

You can run all jobs in a directory with:

% vsr directoryName

You can target a run to be a group of nodes that make up an entire set with:

% vsr -set setName

As a special case, you can run everything in the whole design. Use the system defined private set System:nodes with:

% vsr -all

Set the Priority with the option -p:

% vsr -p high directoryName

If you change a file and would like to retrace starting with that changed file, running jobs that are affected by the change, use:

% vsr -kick name_or_VovId_of_changed_file