FreeBSD Manual Pages
SVXREFLECTOR.CONF(5) File Formats SVXREFLECTOR.CONF(5) NAME svxreflector.conf - Configuration file for the SvxReflector conference server audio reflector DESCRIPTION The svxreflector server is used to interconnect multiple SvxLink nodes into one network. This man-page describe the configuration file format for it. SvxReflector look for configuration files in a number of places. First it tries to find a user specific configuration file. It will look for a user specific configuration file in: $HOME/.svxlink/svxreflector.conf. If no user specific configuration file can be found, svxreflector will look for the system wide configuration file /etc/svxlink/svxreflec- tor.conf. The --config command line option may also be used to specify an arbitrary configuration file. FILE FORMAT The configuration file is in the famous INI-file format. A generic ex- ample of how such a file might look like is shown below. [SECTION1] VALUE1=1 VALUE2="TWO " VAULE3="Multi " "line" [SECTION2] VALUE1=2 This is a simple format that contain name=value pairs that belong to a section. In written text, a specific configuration variable can be re- ferred to as SECTION1/VALUE2 meaning "configuration variable VALUE2 in section SECTION1". The same variable name can exist in two different sections. For example VALUE1 in section SECTION1 have the value 1 and VALUE1 in section SEC- TION2 have the value 2. Values containing spaces at the beginning or end of the line must be surrounded by citation characters (see SEC- TION1/VALUE2). Likewise with a multi line value (see SECTION1/VALUE3). CONFIGURATION VARIABLES Here is the description of all configuration variables that svxreflec- tor understands. The configuration variables are described section for section. GLOBAL The GLOBAL section contains application global configuration data. CFG_DIR Specify the path to a directory that contain additional configu- ration files. If a relative path is specified, the path will be relative to the directory where the main configuration file is at. All files in the specified directory will be read as addi- tional configuration. Filenames starting with a dot are ignored. TIMESTAMP_FORMAT This variable specifies the format of the timestamp that is written in front of each row in the log file. The format string is in the same format as specified in the strftime(3) manual page. The default is "%c" which is described as: "the preferred date and time representation for the current locale". The envi- ronment variables LC_TIME, LC_ALL and LANG will affect how this time format will look. For example, setting LC_TIME="sv_SE.UTF8" will give you Swedish timestamp representation. Other examples of format specifiers are: • %d - The day of the month as a decimal number (range 01 to 31) • %b - The abbreviated month name according to the current lo- cale • %Y - The year as a decimal number including the century • %H - The hour as a decimal number using a 24-hour clock (range 00 to 23) • %M - The minute as a decimal number (range 00 to 59) • %S - The second as a decimal number (range 00 to 61) So, TIMESTAMP_FORMAT="%d %b %Y %H:%M:%S" would give a timestamp looking something like: "29 Nov 2005 22:31:59". LISTEN_PORT The TCP and UDP port number to use for network communications. The default is 5300. Make sure to open this port for incoming traffic to the server on both TCP and UDP. Clients do not have to open any ports in their firewalls. SQL_TIMEOUT Use this configuration variable to set a time in seconds after which a clients audio is blocked if he has been talking for too long. The default is 0 (disabled). SQL_TIMEOUT_BLOCKTIME If a client has been talking for longer than the time specified in the SQL_TIMEOUT configuration variable he will not be able to talk again until the time in this configuration variable have elapsed. If not specified, the default is one second. CODECS A comma separated list of allowed codecs. For the moment only one codec can be specified. Choose from the following codecs: OPUS, SPEEX, GSM, S16 (uncompressed signed 16 bit), RAW (uncom- pressed 32 bit floats). USERS and PASSWORDS sections All users must be specified in the USERS section. Usernames are totally arbitrary but typically the callsign is used. The purpose is to map each username to a password. However, the password is not given di- rectly but instead a reference to the PASSWORDS section is given. It's done like this so that multiple nodes can share a single password. An example of how the USERS and PASSWORDS sections may look is given below. [USERS] SM0ABC-1=MyNodes SM0ABC-2=MyNodes SM1XYZ=SM1XYZ [PASSWORDS] MyNodes="A very strong password!" SM1XYZ="Another very good password?" This will set up SM0ABC-1 and SM0ABC-2 to use the same password speci- fied by MyNodes in the PASSWORDS section. User SM1XYZ have his own password. FILES /etc/svxlink/svxreflector.conf The system wide configuration file. ~/.svxlink/svxreflector.conf Per user configuration file. /etc/svxlink/svxreflector.d/* Additional configuration files. This directory is setup by the CFG_DIR configuration variable. AUTHOR Tobias Blomberg (SM0SVX) <sm0svx at users dot sourceforge dot net> SEE ALSO svxreflector(1), svxlink(1), svxlink.conf(5), Linux OCTOBER 2017 SVXREFLECTOR.CONF(5)
NAME | DESCRIPTION | FILE FORMAT | CONFIGURATION VARIABLES | FILES | AUTHOR | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=svxreflector.conf&sektion=5&manpath=FreeBSD+Ports+15.0>