doc/man/kamailio.8
6a4a9949
 .\"
 .TH kamailio 8 06.12.2016 kamailio "Kamailio SIP Server"
6e7474e4
 .\" Process with
6a4a9949
 .\" groff -man -Tascii kamailio.8
6e7474e4
 .\"
 .SH NAME
fe22bef2
 kamailio \- a very fast and configurable SIP server
6e7474e4
 .SH SYNOPSIS
6a4a9949
 .B kamailio
6e7474e4
 [
3c45a468
 .B \-hcrRvdDEVTI
6e7474e4
 ] [
 .BI \-f " config\-file"
 ] [
 .BI \-l " address"
 ] [
 .BI \-n " processes\-no"
 ] [
5dcfb23d
 .BI \-N " tcp processes\-no"
 ] [
6e7474e4
 .BI \-b " max_rcv_buf_size"
 ] [
 .BI \-m " shared_mem_size"
 ] [
48e1227c
 .BI \-M " private_mem_size"
 ] [
6e7474e4
 .BI \-w " working\-dir"
 ] [
 .BI \-t " chroot\-dir"
 ] [
 .BI \-u " uid"
 ] [
 .BI \-g " gid"
 ] [
 .BI \-P " pid\-file"
049069b8
 ] [
48e1227c
 .BI \-G " pgid\-file"
 ] [
 .BI \-L " modules\-dir"
 ] [
 .BI \-a " auto\-aliases\-mode"
 ] [
 .BI \-A " pre\-processor\-define"
6e7474e4
 ]
 
 .SH DESCRIPTION
6a4a9949
 .B kamailio
 is a very fast and configurable SIP (RFC3261) server.
6e7474e4
 
 .SH OPTIONS
 .TP 12
 .B \-h
 Displays a short usage description, including all available options.
 .TP
 .BI \-c
dda578ba
 Checks the config file and displays the aliases and listen interface list.
6e7474e4
 .TP
 .BI \-r
 Uses dns to check if it is necessary to add a "received=" field to a via.
 .TP
 .BI \-R
6a4a9949
 Same as
6e7474e4
 .B \-r
 but uses reverse dns.
 .TP
70d6cae2
 .BI \-K
6e7474e4
 Turns on via host checking when forwarding replies.
 .TP
 .BI \-d
 Turns on debugging, multiple
db13cefc
 .B \-d
6e7474e4
 increase the debug level.
 .TP
 .BI \-D
ee9ea2f5
 Control how daemonize is done:
 .br
db13cefc
 .B \-D
ee9ea2f5
 - do not fork (almost) anyway (run in foreground, doesn't fork into daemon mode);
 .br
db13cefc
 .B \-DD
ee9ea2f5
 - do not daemonize creator (main process is not daemonized);
 .br
db13cefc
 .B \-DDD
ee9ea2f5
 - daemonize (default)
6e7474e4
 .TP
 .BI \-E
 Sends all the log messages to stderr.
 .TP
5dcfb23d
 .BI \-T
 Disables TCP support.
 .TP
6e7474e4
 .BI \-V
 Displays the version number.
 .TP
3c45a468
 .BI \-I
 Displays details of internal constants and attributes.
 .TP
6e7474e4
 .BI \-f " config\-file"
6a4a9949
 Reads the configuration from
 .B " config\-file"
6e7474e4
 (default
6a4a9949
 .I  /etc/kamailio/kamailio.cfg
6e7474e4
 ).
 .TP
 .BI \-l " address"
6a4a9949
 Listens on the specified address/interface. Multiple
6e7474e4
 .B \-l
6a4a9949
 mean listening on multiple addresses. The address format is
245b8b93
 [proto:]address[:port], where proto = udp|tcp and
6a4a9949
 address = host|ip_address|interface_name. Example: -l localhost,
245b8b93
 -l udp:127.0.0.1:5080, -l eth0:5062.
 The default behaviour is to listen on all the ipv4 interfaces.
6e7474e4
 .TP
 .BI \-n " processes\-no"
 Specifies the number of children processes forked per interface (default 8).
 .TP
5dcfb23d
 .BI \-N " tcp processes\-no"
 Specifies the number of children processes forked to handle tcp incoming connections (by default is equal to
 .BI \-n
 ).
 .TP
6e7474e4
 .BI \-b " max_rcv_buf_size"
 Maximum receive buffer size which will not be exceeded by the auto-probing procedure even if the OS allows.
 .TP
 .BI \-m " shared_mem_size"
 Size of the shared memory which will be allocated (in Megabytes).
 .TP
48e1227c
 .BI \-M " private_mem_size"
 Size of the private memory which will be allocated per process (in Megabytes).
 .TP
6a4a9949
 .BI \-w " working\-dir"
 Specifies the working directory. In the very improbable event that
 .B kamailio
6e7474e4
 will crash, the core file will be generated here.
 .TP
 .BI \-t " chroot\-dir"
6a4a9949
 Forces
 .B kamailio
6e7474e4
 to chroot after reading the config file.
 .TP
 .BI \-u " uid"
6a4a9949
 Changes the user id under which
 .B kamailio
6e7474e4
 runs.
 .TP
 .BI \-g " gid"
6a4a9949
 Changes the group id under which
 .B kamailio
6e7474e4
 runs.
 .TP
 .BI \-P " pid\-file"
049069b8
 Creates a file containing the pid of the main
6a4a9949
 .B kamailio
6e7474e4
 process.
049069b8
 .TP
48e1227c
 .BI \-G " pgid\-file"
 Creates a file containing the pgid of the main
6a4a9949
 .B kamailio
48e1227c
 process.
 .TP
049069b8
 .BI \-L " modules\-dir"
 Specifies the directory where to look for
6a4a9949
 .B kamailio
 modules (default: /usr/lib/kamailio/modules or /usr/lib64/kamailio/modules)
48e1227c
 .TP
 .BI \-a " auto\-aliases\-mode"
 Enable auto-aliases with 'yes' or 'on', disable with 'no' or 'off
 .TP
 .BI \-A " pre\-processor\-define"
 Add config pre-processor define (e.g., -A WITH_AUTH, -A N=1, -A X='"Y"')
6e7474e4
 
 .SH FILES
 .PD 0
6a4a9949
 .B /usr/sbin/kamailio
6e7474e4
 .br
6a4a9949
 .B /etc/kamailio/kamailio.cfg
6e7474e4
 .br
6a4a9949
 .B /usr/lib/kamailio/modules/*
6e7474e4
 .PD
 .SH AUTHORS
c3e5dd3e
 
6a4a9949
 see
 .B /usr/share/doc/kamailio/AUTHORS
6e7474e4
 
 .SH SEE ALSO
6a4a9949
 .BR kamailio.cfg(5)
6e7474e4
 .PP
6a4a9949
 Full documentation on kamailio, including configuration guidelines, FAQs and
e58f2128
 licensing conditions, is available at
fe22bef2
 .I https://www.kamailio.org/
6a4a9949
 .PP
d48f0d9b
 For reporting  bugs see
 .I
6a4a9949
 https://github.com/kamailio/kamailio/issues.
d48f0d9b
 .PP
 Mailing lists:
6a4a9949
 .nf
 sr-users@lists.sip-router.org - kamailio user community
 .nf
 sr-dev@lists.sip-router.org - kamailio development, new features and unstable version