pdr Interactive Mode Index pdx Configuration

pdx Invocation

pdx has arguments and options.

Options start with a minus character. A second minus indicates long options with readable names. All available options can be listed by pdx -? or pdx --help.

Options

-?
show the help screen

-V
show the pdx version

-v
show what's going on, without this option pdx reports errors only

-c filename
use filename as configuration file, this option superseedes the standard configuration file ~/.pdrxrc

-n timestamp
define the value returned by the function now

-i
start pdx in interactive mode

-f
run in fast mode
--debug
show debug information in case of a malfunction

Arguments

pdx accepts names of single outputs as arguments. If given here only these outputs will be processed. If you don't specify outputs on the command line pdx processes the complete outputs line from .pdrxrc. Using command line arguments can be useful for testing. Normally you will invoke pdx without command line arguments.

Regardless of where the outputs are specified for processing they have to be configured completely in .pdrxrc.

Examples

The option -n or --now allows the specification of the value returned by the function now. Everywhere now is called explicitly or implicitly the new timestamp will be used instead of the default one. This is very handy to create reports and diagrams for a concrete time in history. A pre-condition for this is that the report templates and/or diagram definitions don't use fixed timestamps themselves. Time specifications in the argument are optional. The specification is filled up with zeros - so the following invocations do the same:

$ pdx -n 2009-10-01
$ pdx -n 2009-10-01-00:00
$ pdx -n 2009-10-01-00:00:00

The Option -f or --fast improves the speed of the program (probably a lot). This option causes internal results to be cached and used again. This costs memory but accelerates the program noticeable. You should use -f whenever possible and even put this into the configuration file ~/.pdrxrc. This should not have any impact on the results.


pdr Interactive Mode Index pdx Configuration