Provided by: eclipse-titan_8.2.0-1_amd64 bug

NAME

       ttcn3_makefilegen - Makefile Generator

SYNOPSIS

       ttcn3_makefilegen  [ -acdEfghiklMnpRsSw ] [ -e  ETS_name ] [ -o  dir|file ] [ -O  file ] [
       -z  file ] ...  TTCN3_module[.ttcn] ... ASN1_module[.asn] ... Testport_name[.cc] ...
       or
       ttcn3_makefilegen -v

DESCRIPTION

       This manual page is a quick reference for  the  Makefile  Generator  of  the  TTCN-3  Test
       Executor.  It  only  summarizes  the meaning of all command line options. For more details
       please consult the Programmer's Technical Reference for TITAN TTCN-3 Test Executor.

OPTIONS

       The following options are supported (in alphabetical order):

       -a        Refer to files using absolute path names in the generated Makefile.  By  default
                 the  Makefile  uses  relative  path  names  to  access files located outside the
                 current working directory of  the  compiler.  Files  from  the  current  working
                 directory are always referenced using only the file name without any directory.

       -c        Generate  a  Makefile that is capable of using pre-compiled C++ and object files
                 from central directories in order to save disk space and compilation time.

       -d        Dump the internal data structures used for Makefile generation. This  option  is
                 mainly useful for debugging.

       -e ETS_name
                 Sets  the  name of the target binary program (i.e. the executable test suite) to
                 ETS_name in the generated Makefile. If this option is omitted, the name  of  the
                 first TTCN-3 module will be used as default.

       -E        Instructs the variant attribute parser to display warnings instead of errors for
                 unrecognized/erroneous attributes.

       -f        Forces the Makefile Generator to overwrite the output files even if  they  exist
                 or are unchanged.

       -g        Generates a Makefile that can be used with GNU make only. The resulting Makefile
                 will be smaller  and  less  redundant.  It  exploits  the  pattern  substitution
                 features of GNU make, which may cause syntax errors with other versions of make.

       -h        Allows unsafe universal charstring to charstring conversion.

       -i        Enables real-time testing features.

       -I path   Adds  the path to the list of search paths.  path must be an absolute path. Used
                 with the -t option when  the  referenced  projects  can  not  be  found  at  the
                 projectRelativeURI  location.  In  that  case  the  tool  will  try  to find the
                 referenced TPD file using the search paths.  The first TPD file found is  taken.
                 If the tpdName attribute is present in
                  ReferencedProject  then  the value of tpdName will be used as a TPD name during
                 search. However if the tpdName attribute is missing then the value of  the  name
                 attribute is taken with the .tpd suffix and used during the search.

       -k        Enables object-oriented features.

       -o dir|file
                 Write  the  Makefile  to  the  given  directory  or  file.   The current working
                 directory is the default otherwise.   If  the  given  argument  is  an  existing
                 directory,  the generated Makefile will be placed into that directory. Otherwise
                 the given argument is assumed to be the name of the generated Makefile.

       -O file   Add file to the list of other files in the generated Makefile without  analyzing
                 the  file's contents and suffix.  This option can be used to temporarily exclude
                 some TTCN-3, ASN.1 or C++ files from the build process,  but  add  them  to  the
                 archive created by the command make archive.

       -l        Enable dynamic linking. All files of the project will be compiled with -fPIC and
                 for each (static) object, a new shared  object  will  be  created.  Then,  these
                 shared  objects  will  be linked to the final executable instead of the (static)
                 objects. It can be used to speed up the linking phase, in the price of  somewhat
                 lower  performance and increased memory usage. It's recommended to use this flag
                 only in the development phase of the project. This option is  not  supported  on
                 Windows.

       -M        Allows  the  use  of  the value omit in template lists and complemented template
                 lists (legacy behavior).  If set, an omitted field will match a  template  list,
                 if the value omit appears in the list, and it will match a complemented template
                 list, if omit is not in the list (the ifpresent attribute can still be used  for
                 matching  omitted  fields).  This  also  affects the ispresent operation and the
                 present template restriction accordingly.

       -n        Activates the debugger and generates extra code for storing debug information.

       -p        Generate Makefile with TTCN-3 preprocessing.  All the TTCN-3 source  files  with
                 the ttcnpp extension will be preprocessed using the C preprocessor.

       -R        Use  function test runtime (TITAN_RUNTIME_2). Generates a Makefile that compiles
                 and links the source code using the function test runtime.

       -s        Generates a Makefile, which links the executable test suite with the single mode
                 version  of  the base library. If this switch is omitted the executable is built
                 for parallel mode by default.

       -S        Suppresses all makefilegen warning messages.

       -v        Prints version and license key information and exits.

       -w        Suppresses all warning messages gerenated by TITAN.

       -z file   Enables code coverage and profiling in the  TTCN-3  files  listed  in  the  file
                 argument.  The  TTCN-3 files in the list must be separated by new lines and must
                 also appear among the makefile generator's arguments (this switch is ignored  if
                 the -t option is present).

ENVIRONMENT VARIABLES

       TTCN3_DIR
              The  installation  directory  where  the uncompressed binary package of TTCN-3 Test
              Executor can be found.

       TTCN3_LICENSE_FILE
              It shall  point  to  the  file  (NB:  not  to  its  directory)  that  contains  the
              personalized license key for the current user or host.

BUGS

       For  trouble  reporting  use  the  tool MTTSMS.  For TR writers guide please visit the web
       page: http://ttcn.ericsson.se.

SEE ALSO

       Ericsson document 2/198 17-CRL 113 200 Uen:
              Programmer's Technical Reference for TITAN TTCN-3 Test Executor

AUTHOR

       This manpage is written by Janos Zoltan Szabo, Ericsson Telecom AB
       Copyright (c) 2000-2021 Ericsson Telecom AB
       All rights reserved. This program and the accompanying materials are made available  under
       the  terms  of the Eclipse Public License v2.0 which accompanies this distribution, and is
       available at
       https://www.eclipse.org/org/documents/epl-2.0/EPL-2.0.html