NAME

SYNOPSIS

DESCRIPTION

OPTIONS

[ -c | --conf ] <file>

Specify the YAML configuration file to use (default to ~/.dsc-datatool.conf), any command line option will override the options in the configuration file. See dsc-datatool.conf(5) for more information.

[ -s | --server ] <name> (required)

Specify the server for where the data comes from.

[ -n | --node ] <name> (required)

Specify the node for where the data comes from.

[ -x | --xml ] <file or directory> (suggested)

Read DSC data from the given file or directory, can be specified multiple times. If a directory is given then all files ending with .xml will be read.

[ -d | --dat ] <directory> (suggested)

Read DSC data from the given directory, can be specified multiple times. Note that the DAT format is depended on the filename to know what type of data it is.

[ -ds | --dataset ] <list of datasets>

Specify that only the list of datasets will be processed, the list is comma separated and the option can be given multiple times.

[ -o | --output ] <sep<type>[<sep>option=value...]>

Output data to type and use separator as an options separator, example:

  --output ;Carbon;host=localhost;port=2003
    

Can be specified multiple times to output to more then one.

To see a full list of options, check the man-page of the output module:

  man App:DSC::DataTool::Output::NAME
    

[ -t | --transform ] <sep<type><sep><datasets>[<sep>option=value...]>

Use the transformer type to change the list of datasets in datasets, example:

  --transform ;ReRanger;rcode_vs_replylen;type=sum;range=/128
    

datasets is a comma separated list of datasets to run the tranformer on, because of this do not use comma (,) as a separator. * in datasets will make the tranformer run on all datasets.

Can be specific multiple times to chain transformation, the chain will be executed in the order on command line with one exception. All transformations specified for dataset * will be executed before named dataset transformations.

To see a full list of options, check the man-page of the transformer module:

  man App:DSC::DataTool::Transformer::NAME
    

For a list of datasets see the DSC configuration that created the data files and the documentation for the Presenter.

[ -g | --generator ] <list of generators>

Use the specified generators to generate additional datasets, the list is comma separated and the option can be given multiple times.

[ -l | --list ]

List the available inputs, generators, transformers and outputs.

--skipped-key "text"

Set the special DSC skipped key, default to "-:SKIPPED:-".

--skipped-sum-key "text"

Set the special DSC skipped sum key, default to "-:SKIPPED_SUM:-".

-h | --help

Print a brief help message and exits.

-m | --man

Prints the manual page and exits.

-v | --verbose

Increase the verbose level, can be given multiple times.

-V | --version

Display version and exit.

FILES

/etc/dsc/dsc-datatool.conf

System wide configuration for dsc-datatool.

~/.dsc-datatool.conf

User configuration for dsc-datatool.

SEE ALSO

LICENSE AND COPYRIGHT

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.