For the sake and sanity of the user of this software, we need to cover the basic elements of the configuration before getting to the meat and potatoes.

• Configuration Directives
• Comments
• Instruction Separator

There are five (5) types of configuration directives used with Kamailio.

1. C-Style Control Directives
2. Apache Name/Value Pairs
3. Normal Name/Value Pairs
4. Modify Parameter Procedure
5. Route Functions

The first thing you should understand is the comment syntax used in the configuration file.

Comments in the configuration file are a mixture of C-Style (not C++) and scripting language syntaxes.
It closely resembles the PHP style, except you can not use double-slash ( ⁄ ⁄ ), only hash (#) may be used for line comments.

It can be confusing seeing the C-Style Control Directives (explained later) that begin with a hash-bang (#!) mixed with line comments begin with a hash (#).

/* block comment
   block comment */
// this is NOT a line comment
# this is a line comment
#!c_style_directive <-- VALID CONFIGURATION DIRECTIVE / NOT A COMMENT

Just getting this out of the way before covering the Configuration Directives.

The semicolon (;) is not required and may be used as an instruction separator for all configuration directives except Route Functions¹⁾.

The general use is to allow for comments or additional configuration directives on the same line.

configuration_directive_a
configuration_directive_b;
configuration_directive_c; configuration_directive_d
configuration_directive_e; # comment about the configuration directive

Available directives:

• #!define NAME - define a keyword
• #!define NAME VALUE - define a keyword with value
• #!ifdef NAME - check if a keyword is defined
• #!ifndef - check if a keyword is not defined
• #!else - swtich to false branch of ifdef/ifndef region
• #!endif - end ifdef/ifndef region
• #!trydef - add a define if not already defined
• #!redefine - force redefinition even if already defined
• #!subst
• #!substdef

#!define MODULE_NAME

#!ifdef MODULE_NAME
 .. set directives ..
#!else
 .. set alternate directives .. 
#!endif

name "value"

The value MUST be enclosed in quotes.

loadmodule "module_name.so"
loadmodule "another_module.so"
include_file "file_to_include.cfg"
import_file "/path/to/file_to_import.cfg"

name=value

(delimited by an equals sign)

core_parameters

memdbg=5
memlog=5
log_facility=LOG_LOCAL0
fork=yes
children=4
#disable_tcp=yes
auto_aliases=no
alias="sip.mydomain.com"

modparam("first_module", "module_parameter_text", "new_value");  # Set Text Value
modparam("second_module", "module_parameter_number", 10000);      # Set Numeric Value
modparam("second_module", "module_parameter_on", 1);              # Enable Parameter
modparam("third_module", "module_parameter_on", 0);             # Disable Parameter