Skip to content

Commit

Permalink
Cleanup of documentation.
Browse files Browse the repository at this point in the history
  • Loading branch information
Reiner Jung committed May 16, 2021
1 parent a9e3256 commit d01cd57
Show file tree
Hide file tree
Showing 4 changed files with 39 additions and 10 deletions.
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# OceanDSL Jvava Tools
# OceanDSL Java Tools

Project containing all Java-based tools developed in OceanDSL.

Expand All @@ -14,7 +14,7 @@ Each tool has its own set of parameters and can be found in
Current tools:
- rewrite-log-entries
- create-architecture-model

- pp-static-log



Expand Down
24 changes: 18 additions & 6 deletions doc/tools/create-architecture-model.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,24 @@ The tool is intended to be used in conjunctions with kieker-lang-pack-c Kieker l
`BeforeOperationEvent`s and `AfterOperationEvent`s do only contain pointer information for
operation calls which must be resolved using `addr2line`.

This tool has 5 parameters:
-i input kieker log directory>
-o path where the output kieker log is placed
-a the location of the addr2line executable to resolve the names
-m the executable (model) to be analyzed by addr2line
-p prefix path to be removed from path information
Parameters:
-i, --input (required) Input Kieker log directory or CSV file location
-o, --output (required) Output directory to store graphics and statistics
-M, --component-map Component, file and function map file
-a, --addrline Location of the addrline tool
-e, --executable Location of the executable
-m, --mode Different input read modes, default is kieker; other option is csv
-ia, --input-architecture-model Directory for an input architecture model
-oa, --output-architecture-model Directory for an output architecture model
-l, --source-label (required) Set source label for the read data
-c, --case-insensitive Handle function names case insensitive
This is helpful with Fortran code as function names are handled
case insensitive.
-H, --hostname Hostname to be used in CSV reconstruction, this can be
used with static analysis data to simulate a deployment host
-E, --experiment-name (required) Name of the experiment
-g, --graphs Specify which output graphs must be generated (dot-op, dot-component, graphml)


Build
-----
Expand Down
17 changes: 17 additions & 0 deletions doc/tools/pp-static-log.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
Preprocessor for Static Logs
============================

Logs based on FParser produce a CSV file with three column refering
to caller file name, caller function name, callee function name.
The callee file name is missing. However, this can be inferred by other
means from the source code and stored in lookup tables. The
**pp-static-log** will read an 3 column CSV file use one or more
lookup tables and generate a 4 column output CSV file.

Parameters
-i, --input (required) Input 3 column static log file
-m, --map (required) Function to map files. One of more files separated by
a space.
-o, --output (required) Output file for 4 column log


Original file line number Diff line number Diff line change
Expand Up @@ -32,15 +32,15 @@
public class Settings {

@Parameter(names = { "-i",
"--input" }, required = true, converter = PathConverter.class, description = "Input 3 column static log directory")
"--input" }, required = true, converter = PathConverter.class, description = "Input 3 column static log file")
private Path inputPath;

@Parameter(names = { "-m",
"--map" }, required = true, variableArity = true, converter = PathConverter.class, description = "Function to file map")
private List<Path> mapPaths;

@Parameter(names = { "-o",
"--output" }, required = true, converter = FileConverter.class, description = "Output directory for 4 column log")
"--output" }, required = true, converter = FileConverter.class, description = "Output file for 4 column log")
private File outputFile;

public Path getInputPath() {
Expand Down

0 comments on commit d01cd57

Please sign in to comment.