Getting Control On Feature Level

Getting Control on Feature Level

Default you use the make command and it will control which feature package and feature sets that are included based on your config.m4.  For example, you specified you wanted to use the NATi handling configuration SERi - Getting Started file, and the rest is automatic.

In order to gain control on the feature level and decide specifically which features to include, you need to change your config.m4.  In order to include a feature, you need to define the macro that controls it inclusion. Each feature package has a two-letter prefix. This is GS_ for Getting Started. When new features or feature packages are added to the buildsystem, the configure script will be updated to make sure that the config.m4 file that is generated documents all the available features. The configure file is thus the best documentation of all the features available. 

When you want to include a feature, you define in config.m4 those features you want to include. For example:

define(`GS_AUTHENTICATION',`yes')dnl
define(`GS_HANDLINGNAT',`yes')dnl

Parameters to make

You will normally use three main targets:

• default - will build the local/default/ config file
• servername - will build your local/servername/ config file
• install - will install all seri*.cfg to /usr/local/etc/ser

In addition, you can specify parameters (before the target):

• prefix - used to install config files to a specific directory, i.e. make prefix=/myserdir install
• local_prefix - used to specify where you have your local/ directory tree, i.e. make local_prefix=/tmp/serconfigs (common will then be /tmp/serconfigs/common)
• use_config - can be used instead of target , i.e. make use_config=servername. This is most often used to control the target and config separately (for example, 'make use_config=default xml' to generate xml docbook for inclusion in the SER - Getting Started guide)
• for debugging: m4_param - used to add options to m4 execution, ex. m4_param="-s" to get line prefixes for simpler identification of errors.