repgen/ttcn3_logfilter.1

   1 .TH ttcn3_logfilter 1 "October 2014" "Ericsson Telecom AB" "TTCN-3 Tools"
   2 .SH NAME
   3 ttcn3_logfilter \- TTCN-3 log file filtering utility
   4 .SH SYNOPSIS
   5 .B ttcn3_logfilter
   6 .RB "[\| " \-o
   7 .IR outfile " \|]"
   8 .RI "{ " eventtype
   9 (+|-) } [\|
  10 .IR input.log " \|]"
  11 ...
  12 .br
  13 or
  14 .br
  15 .B ttcn3_logfilter
  16 .B \-v | \-h | \-l
  17 .SH DESCRIPTION
  18 This manual page is a quick reference for the TTCN-3 logfilter utility of
  19 the TTCN-3 Test Executor. The
  20 .B ttcn3_logfilter
  21 utility, which can be found in
  22 .I $TTCN3_DIR/bin,
  23 filters the input log file given in the command line argument based on the
  24 event types in the file, and filter parameters given in the program argument.
  25 The output is then written to an output file if specified, or to the standard
  26 output. The program is useful only if the variable
  27 .B LogEventTypes
  28 is set to
  29 .B Yes
  30 in section
  31 .B [LOGGING]
  32 of the configuration file.
  33 .SH OPTIONS
  34 Available command line switches are:
  35 .TP 10
  36 .B \-h
  37 Prints
  38 .I help
  39 on how to use the utility.
  40 .TP
  41 .B \-l
  42 Prints the
  43 .I list
  44 of supported event types.
  45 .TP
  46 .BI \-o " outfile"
  47 Puts its output into
  48 .IR outfile "."
  49 If the file outfile exists its contents will be overwritten. This switch is
  50 optional, when omitted the output will be printed to standard output.
  51 .TP
  52 .B \-v
  53 Prints
  54 .I version
  55 and license key information and exits.
  56 .SH ENVIRONMENT VARIABLES
  57 .TP
  58 .SM
  59 TTCN3_DIR
  60 The installation directory where the uncompressed binary package of
  61 TTCN-3 Test Executor can be found.
  62 .TP
  63 .SM
  64 TTCN3_LICENSE_FILE
  65 It shall point to the
  66 .I file
  67 .RB ( NB:
  68 .I not
  69 to its directory) that contains the personalized license key for the
  70 current user or host.
  71 .SH BUGS
  72 None known at this time
  73 .LP
  74 .SH SEE ALSO
  75 ttcn3_logformat(1), ttcn3_logmerge(1)
  76 .LP
  77 The
  78 .B User Documentation for the TTCN-3
  79 .B Test Executor.
  80 .SH AUTHOR
  81 This manpage is written by Csaba Koppany, Ericsson Telecom AB
  82 .br
  83 Copyright (c) 2000-2015 Ericsson Telecom AB
  84 .br
  85 All rights reserved. This program and the accompanying materials
  86 are made available under the terms of the Eclipse Public License v1.0
  87 which accompanies this distribution, and is available at
  88 .br
  89 http://www.eclipse.org/legal/epl-v10.html