core/ttcn3_profmerge.1

   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