opensips(8)

1OpenSIPS(8)                     VoIP SIP Server                    OpenSIPS(8)
2
3
4

NAME

6       opensips - flexible and roboust SIP (RFC3261, RFC3263) server for Voice
7       over IP (VoIP)
8
9

SYNOPSIS

11       opensips [ -hcCrRvdDEVT ] [ -f config-file ] [ -l address ] [  -n  pro‐
12       cesses-no  ]  [  -N  tcp  processes-no  ]  [ -b max_rcv_buf_size ] [ -m
13       shared_mem_size ] [ -w working-dir ] [ -W method ] [ -t chroot-dir ]  [
14       -u uid ] [ -g gid ] [ -P pid-file ] [ -i fifo-path ] [ -x socket-path ]
15
16

DESCRIPTION

18       OpenSIPS   is a SIP-based VoIP server running on most Unix-like operat‐
19       ing systems. It supports UDP, TCP and TLS transport layers.  Among  its
20       features:
21
22       *      SIP Proxy Server, SIP Registrar Server, SIP Redirect Server, SIP
23              Location Server, SIP Application Server
24
25       *      Call Processing Language (RFC3880)
26
27       *      ENUM support
28
29       *      server side NAT traversal
30
31       *      load balancing
32
33       *      AAA with database (MySQL, Postgres, Unixodbc) or RADIUS backend
34
35       *      audio, video, instant messaging and pressence
36

OPTIONS

38       -h          Displays a short usage description, including all available
39                   options.
40
41       -c          Checks  the config file and displays the aliases and listen
42                   interface list.
43
44       -C          Similar to -c but in addition checks the flags of  exported
45                   functions from included route blocks.
46
47       -r          Uses  dns  to check if it is necessary to add a "received="
48                   field to a via.
49
50       -R          Same as -r but uses reverse dns.
51
52       -v          Turns on via host checking when forwarding replies.
53
54       -d          Turns on debugging, multiple -d increase the debug level.
55
56       -D          Runs opensips in the foreground (it doesn't fork into  dae‐
57                   mon mode).
58
59       -E          Sends all the log messages to stderr.
60
61       -T          Disables TCP support.
62
63       -V          Displays the version number.
64
65       -f config-file
66                   Reads   the   configuration   from    config-file  (default
67                   /usr/etc/opensips/opensips.cfg ).
68
69       -l address  Listens on the  specified  address/interface.  Multiple  -l
70                   mean listening on multiple addresses. The address format is
71                   [proto:]address[:port], where proto = udp|tcp and address =
72                   host|ip_address|interface_name.  Example:  -l localhost, -l
73                   udp:127.0.0.1:5080, -l eth0:5062.  The default behaviour is
74                   to listen on all the ipv4 interfaces.
75
76       -n processes-no
77                   Specifies  the  number  of  children  processes  forked per
78                   interface (default 8).
79
80       -N tcp processes-no
81                   Specifies the number of children processes forked to handle
82                   tcp incoming connections (by default is equal to -n ).
83
84       -b max_rcv_buf_size
85                   Maximum  receive  buffer size which will not be exceeded by
86                   the auto-probing procedure even if the OS allows.
87
88       -m shared_mem_size
89                   Size of the shared  memory  which  will  be  allocated  (in
90                   Megabytes).
91
92       -w working-dir
93                   Specifies  the  working  directory.  In the very improbable
94                   event that opensips will crash, the core file will be  gen‐
95                   erated here.
96
97       -W method   Specify poll method.
98
99       -t chroot-dir
100                   Forces opensips to chroot after reading the config file.
101
102       -u uid      Changes the user id under which opensips runs.
103
104       -g gid      Changes the group id under which opensips runs.
105
106       -P pid-file Creates  a  file  containing  the  pid of the main opensips
107                   process.
108
109       -i fifo-path
110                   Creates a fifo, usefull for monitoring opensips status.
111
112       -x socket-path
113                   Creates a unix socket, usefull for monitoring opensips sta‐
114                   tus ( same as -i fifo-path but using instead unix sockets).
115
116
117

FILES

119       /usr/sbin/opensips
120       /usr/etc/opensips/opensips.cfg
121       /usr/lib64/opensips/modules*
122

AUTHORS

124       see /usr/share/doc/opensips/AUTHORS
125
126

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

FILES

AUTHORS

SEE ALSO