| 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 |
projects / deliverable / titan.core.git / blame