3abe9331 |
1 | .TH ttcn3_profmerge 1 "August 2015" "Ericsson Telecom AB" "TTCN-3 Tools" |
2 | .SH NAME |
3 | ttcn3_profmerge \- TTCN-3 profiler and code coverage merge tool |
4 | .SH SYNOPSIS |
5 | .B ttcn3_profmerge |
6 | .RB "[ " \-pc |
7 | .RB "] [ " \-o |
8 | .I "file" |
9 | .RB "] [ " \-s |
10 | .IR "file" " ]" |
11 | .RB "[ " \-f |
12 | .IR "filter" " ]" |
13 | .IR db_file1 " [" |
14 | .IR db_file2 " ... ]" |
15 | .br |
16 | or |
17 | .br |
18 | .B ttcn3_profmerge |
19 | .B \-v |
20 | .SH DESCRIPTION |
21 | This manual page is a quick reference for the TTCN-3 profmerge utility of |
22 | the TTCN-3 Test Executor. The |
23 | .B ttcn3_profmerge |
24 | utility, which can be found in |
25 | .I $TTCN3_DIR/bin, |
26 | merges all input files (profiler databases) given in the command argument into a |
27 | single output file. It can also generate profiler statistics from the merged |
28 | database. |
29 | .br |
30 | Since there are two possible outputs, neither of them are written to the standard output. |
31 | .br |
32 | It is useful for test suites that are run on multiple Host Controllers (in parallel mode). |
33 | .SH OPTIONS |
34 | Available command line switches are: |
35 | .TP 10 |
36 | .B \-p |
37 | Discards profiler data from the merged database. All execution times will be set to zero in |
38 | the output database file, and statistics related to execution times will not be generated (both |
39 | profiler and code coverage data cannot be discarded, since there would be no data left). |
40 | .TP |
41 | .B \-c |
42 | Discards code coverage data from the merged database. All execution counts will be set to zero in |
43 | the output database file, and statistics related to execution counts will not be generated (both |
44 | profiler and code coverage data cannot be discarded, since there would be no data left). |
45 | .TP |
46 | .BI \-o " file" |
47 | Prints the output (merged) database to the specified |
48 | .IR file \. |
49 | At least one output file (this or the statistics file) must be set. |
50 | .TP |
51 | .BI \-s " file" |
52 | Prints statistics for the merged database into the specified |
53 | .IR file \. |
54 | At least one output file (this or the output database file) must be set. |
55 | .TP |
56 | .BI \-f " filter" |
57 | Specifies which statistics entries are generated. The |
58 | .I filter |
59 | is a hexadecimal number, the last 25 bits each correspond to the 25 entries |
60 | in the statistics file (the least significant bit corresponds to the first entry, |
61 | and so on). The filter is ignored if the statistics file is not set. |
62 | .TP |
63 | .B \-v |
64 | Prints |
65 | .I version |
66 | and license key information and exits. |
67 | .SH ENVIRONMENT VARIABLES |
68 | .TP |
69 | .SM |
70 | TTCN3_DIR |
71 | The installation directory where the uncompressed binary package of the |
72 | TTCN-3 Test Executor can be found. |
73 | .TP |
74 | .SM |
75 | TTCN3_LICENSE_FILE |
76 | Points to the |
77 | .I file |
78 | .RB ( NB: |
79 | .I not |
80 | the directory) that contains the personalized license key for the |
81 | current user or host. |
82 | .SH BUGS |
83 | None known at this time |
84 | .LP |
85 | .SH SEE ALSO |
86 | The |
87 | .B Programmer's Technical Reference for the TTCN-3 |
88 | .B Test Executor. |
89 | .SH AUTHOR |
90 | This manpage is written by Botond Baranyi, Ericsson Telecom AB |
91 | .br |
92 | Copyright (c) 2000-2015 Ericsson Telecom AB |
93 | .br |
94 | All rights reserved. This program and the accompanying materials |
95 | are made available under the terms of the Eclipse Public License v1.0 |
96 | which accompanies this distribution, and is available at |
97 | .br |
98 | http://www.eclipse.org/legal/epl-v10.html |