Author: sayer
Date: 2009-01-20 15:23:53 +0100 (Tue, 20 Jan 2009)
New Revision: 1229
Modified:
trunk/core/etc/sems.conf.sample
Log:
reorganised and ordered sample config
Modified: trunk/core/etc/sems.conf.sample
===================================================================
--- trunk/core/etc/sems.conf.sample 2009-01-19 18:54:57 UTC (rev 1228)
+++ trunk/core/etc/sems.conf.sample 2009-01-20 14:23:53 UTC (rev 1229)
@@ -13,56 +13,122 @@
# example: option=value # i like this option
#
-# parameter: plugin_config_path=<path>
-#
-# - in this path configuration files of the applications
-# (e.g. announcement.conf) are searched
-plugin_config_path=/usr/local/etc/sems/etc/
+############################################################
+# Network configuration
-# optional parameter: fork={yes|no}
+# optional parameter: media_ip=<ip_address>|<device>
#
-# - specifies if sems should run in daemon mode (background)
-# (fork=no is the same as -E)
-fork=yes
+# - this informs SEMS about the IP address or interface that
+# SEMS uses to send and receive media. If not set, defaults
+# to first non-loopback interface.
+#
+# Examples:
+# media_ip=10.0.0.34
+# media_ip=eth0
-# optional parameter: stderr={yes|no}
+# optional parameter: sip_ip=<ip_address>
#
-# - debug mode: do not fork and log to stderr
-# (stderr=yes is the same as -E)
-stderr=no
+# - this informs SEMS about the SIP IP where its SIP stack is
+# bound to or should be bound to. If 'sipctrl' SIP stack is used,
+# the SIP stack will bind to this address. This also sets
+# the value used for contact header in outgoing calls and
+# registrations. If not set, defaults to first non-loopback
+# interface.
+#
+# Example:
+# sip_ip=10.0.0.34
+#
-# optional parameter: loglevel={0|1|2|3}
+# optional parameter: public_ip=<ip_address>
+#
+# - when running SEMS behind certain simple NAT configurations,
+# you can use this parameter to inform SEMS of its public IP
+# address. If this parameter is set, SEMS will write this value
+# into SDP bodies.
+# If this parameter is not set, the local IP address is used.
+# N.B., there is no support for port translation; the local
+# RTP port is advertised in SDP in either case.
+#
+# Example:
+# public_sip=75.101.219.48
+#
+
+# optional parameter: sip_port=<port_number>
#
-# - sets log level (error=0, warning=1, info=2, debug=3)
-# (same as -D)
-loglevel=2
+# - this informs SEMS about the port where its SIP stack is
+# bound to or should be bound to. SEMS needs this information
+# to correctly set the contact header in outgoing calls
+# and registrations. Should be set to equal the 'port'
+# configuration option in ser_sems.cfg.
+# This does not need to be set if sipctrl SIP stack, outgoing
+# calls and registrations from SEMS are not used.
+#
+# default: 5060
+#
+sip_port=5080
-# optional parameter: syslog_facility={DAEMON|USER|LOCAL[0-7]}
+# optional parameter: outbound_proxy=uri
#
-# - sets the log facility that is used for syslog. Using this,
-# the log can for example be filtered into a special file
-# by the syslog daemon.
+# - this sets a next hop for calls and registrations outgoing
+# from SEMS. This does not apply to requests in a dialog that
+# is initiated by someone else and incoming to SEMS, as in
+# this case the next_hop is taken by SEMS from the incoming
+# request that established the dialog.
+# If this is not set (default setting), then for dialogs
+# initiated by SEMS the r-uri is resolved and the request
+# is sent there directly.
+# This is resolved by the SIP stack with DNS if a name is given.
+# Warning: If the value set here can not be resolved, no
+# requests will be sent out at all!
+#
+# default: empty
#
-# Default: DAEMON
-#
# Example:
-# syslog_facility=LOCAL0
+# outbound_proxy=sip:proxy.mydomain.net
-# optional parameter: log_sessions=[yes|no]
+# optional parameter: rtp_low_port=<port>
+#
+# - sets lowest for RTP used port
+rtp_low_port=10000
+
+# optional parameter: rtp_high_port=<port>
+#
+# - sets highest for RTP used port
+rtp_high_port=60000
+
+############################################################
+# application configuration
+
+# optional parameter: plugin_path=<path>
#
-# Default: no
+# - sets the path to the plug-ins' binaries
+# - may be absolute or relative to CWD
+plugin_path=/usr/local/lib/sems/plug-in/
+
+# optional parameter: load_plugins=<modules list>
#
-# If log_sessions=yes is set, INFO level log messages are generated
-# for each session when it is started and stopped.
+# semicolon-separated list of modules to load.
+# If empty, all modules in plugin_path are loaded.
+# One of [sipctrl,unixsockctrl,binrpcctrl] must be loaded.
#
-# log_sessions=yes
+# example for announcement with only g711 and ilbc codecs
+# load_plugins=wav;ilbc;announcement;sipctrl
+# optional parameter: exclude_plugins=<modules list>
+#
+# semicolon-separated list of modules to exclude from loading
+# ('blacklist'). If empty, all modules in plugin_path are loaded.
+# This has only effect it load_plugins is not set.
+#
+# o binrpcctrl and unixsockctrl: excluded as sipctrl is default ctrl
+# o precoded_announce: no precoded sample files present
+exclude_plugins=binrpcctrl;unixsockctrl;precoded_announce
+
# optional parameter: application
#
-# This config value controls which application is to be
-# executed if there is no explicit application requested
-# from the SIP stack (i.e. unixsockctrl and second parameter
-# of t_write_unix).
+# This controls which application is to be executed if there
+# is no explicit application requested from the SIP stack
+# (i.e. unixsockctrl and second parameter of t_write_unix).
#
# This can be one of
# $(ruri.user) - user part of ruri is taken as application,
@@ -83,31 +149,12 @@
# application = $(ruri.param)
application = $(apphdr)
-# optional parameter: plugin_path=<path>
-#
-# - sets the path to the plug-ins
-# - may be absolute or relative to CWD
-plugin_path=/usr/local/lib/sems/plug-in/
-
-# optional parameter: load_plugins=<modules list>
-#
-# semicolon-separated list of modules to load.
-# If empty, all modules in plugin_path are loaded.
-# One of [sipctrl,unixsockctrl,binrpcctrl] must be loaded.
+# parameter: plugin_config_path=<path>
#
-# example for announcement with only g711 and ilbc codecs
-# load_plugins=wav;ilbc;announcement;sipctrl
+# - in this path configuration files of the applications
+# (e.g. announcement.conf) are searched
+plugin_config_path=/usr/local/etc/sems/etc/
-# optional parameter: exclude_plugins=<modules list>
-#
-# semicolon-separated list of modules to exclude from loading
-# ('blacklist'). If empty, all modules in plugin_path are loaded.
-# This has only effect it load_plugins is not set.
-#
-# o binrpcctrl and unixsockctrl: excluded as sipctrl is default ctrl
-# o precoded_announce: no precoded sample files present
-exclude_plugins=binrpcctrl;unixsockctrl;precoded_announce
-
# optional parameter: exclude_payloads=<payload list>
#
# semicolon-separated list of payloads to exclude from loading
@@ -120,23 +167,58 @@
# only use G711 (exclude everything else):
# exclude_payloads=iLBC;speex;G726-40;G726-32;G721;G726-24;G726-16;GSM;L16
-# optional parameter: rtp_low_port=<port>
+############################################################
+# logging and running
+
+# optional parameter: fork={yes|no}
+#
+# - specifies if sems should run in daemon mode (background)
+# (fork=no is the same as -E)
+fork=yes
+
+# optional parameter: stderr={yes|no}
#
-# - sets lowest for RTP used port
-rtp_low_port=10000
+# - debug mode: do not fork and log to stderr
+# (stderr=yes is the same as -E)
+stderr=no
-# optional parameter: rtp_high_port=<port>
+# optional parameter: loglevel={0|1|2|3}
#
-# - sets highest for RTP used port
-rtp_high_port=60000
+# - sets log level (error=0, warning=1, info=2, debug=3)
+# (same as -D)
+loglevel=2
+# optional parameter: syslog_facility={DAEMON|USER|LOCAL[0-7]}
+#
+# - sets the log facility that is used for syslog. Using this,
+# the log can for example be filtered into a special file
+# by the syslog daemon.
+#
+# Default: DAEMON
+#
+# Example:
+# syslog_facility=LOCAL0
+
+# optional parameter: log_sessions=[yes|no]
+#
+# Default: no
+#
+# If log_sessions=yes is set, INFO level log messages are generated
+# for each session when it is started and stopped.
+#
+# log_sessions=yes
+
+############################################################
+# tuning
+
# optional parameter: media_processor_threads=<num_value>
#
# - controls how many threads should be created that
# process media - on single-processor systems set this
# parameter to 1 (default), on MP systems to a higher
# value
-media_processor_threads=1
+#
+# media_processor_threads=1
# optional parameter: session_limit=<limit>;<err code>;<err reason>
@@ -150,75 +232,6 @@
# Example:
# session_limit="1000;503;Server overload"
-# optional parameter: media_ip=<ip_address>|<device>
-#
-# - this informs SEMS about the IP address or interface that SEMS uses
-# to send and receive media. If not set, defaults to first non-loopback
-# interface.
-# Examples:
-# media_ip=10.0.0.34
-# media_ip=eth0
-
-# optional parameter: sip_ip=<ip_address>
-#
-# - this informs SEMS about the SIP IP where its SIP stack is
-# bound to or should be bound to. If 'sipctrl' SIP stack is used,
-# the SIP stack will bind to this address. This also sets
-# the value used for contact header in outgoing calls and
-# registrations. If not set, defaults to first non-loopback
-# interface.
-#
-# Example:
-# sip_ip=10.0.0.34
-#
-
-# optional parameter: public_ip=<ip_address>
-#
-# - when running SEMS behind certain simple NAT configurations,
-# you can use this parameter to inform SEMS of its public IP
-# address. If this parameter is set, SEMS will write this value
-# into SDP bodies.
-# If this parameter is not set, the local IP address is used.
-# N.B., there is no support for port translation; the local
-# RTP port is used in either case.
-#
-# Example:
-# public_sip=75.101.219.48
-#
-
-# optional parameter: sip_port=<port_number>
-#
-# - this informs SEMS about the port where its SIP stack is
-# bound to or should be bound to. SEMS needs this information
-# to correctly set the contact header in outgoing calls
-# and registrations. Should be set to equal the 'port'
-# configuration option in ser_sems.cfg.
-# This does not need to be set if sipctrl SIP stack, outgoing
-# calls and registrations from SEMS are not used.
-#
-# default: 5060
-#
-sip_port=5080
-
-# optional parameter: outbound_proxy=uri
-#
-# - this sets a next hop for calls and registrations outgoing
-# from SEMS. This does not apply to requests in a dialog that
-# is initiated by someone else and incoming to SEMS, as in
-# this case the next_hop is taken by SEMS from the incoming
-# request that established the dialog.
-# If this is not set (default setting), then for dialogs
-# initiated by SEMS the r-uri is resolved and the request
-# is sent there directly.
-# This is resolved by the SIP stack with DNS if a name is given.
-# Warning: If the value set here can not be resolved, no
-# requests will be sent out at all!
-#
-# default: empty
-#
-# Example:
-# outbound_proxy=sip:proxy.mydomain.net
-
# optional parameter: dead_rtp_time=<unsigned int>
#
# - if != 0, after this time (in seconds) of no RTP
@@ -290,5 +303,5 @@
#
# default: internal
#
-#dtmf_detector=spandsp
+# dtmf_detector=spandsp
_______________________________________________
Semsdev mailing list
[email protected]
http://lists.iptel.org/mailman/listinfo/semsdev
