Poster of Linux kernelThe best gift for a Linux geek


Section: VoIP SIP Server (8) Updated: 08.06.2006
Local index Up


openser - flexible and roboust SIP (RFC3261, RFC3263) server for Voice over IP (VoIP)



openser [ -hcCrRvdDEVT ] [ -f config-file ] [ -l address ] [ -n processes-no ] [ -N tcp processes-no ] [ -b max_rcv_buf_size ] [ -m shared_mem_size ] [ -w working-dir ] [ -W method ] [ -t chroot-dir ] [ -u uid ] [ -g gid ] [ -P pid-file ] [ -i fifo-path ] [ -x socket-path ]



OpenSER is a SIP-based VoIP server running on most Unix-like operating systems. It supports UDP, TCP and TLS transport layers. Among its features:
SIP Proxy Server, SIP Registrar Server, SIP Redirect Server, SIP Location Server, SIP Application Server
Call Processing Language (RFC3880)
ENUM support
server side NAT traversal
LCR - least cost routing
load balancing
AAA with database (MySQL, Postgres, Unixodbc) or RADIUS backend
audio, video, instant messaging and pressence


Displays a short usage description, including all available options.
Checks the config file and displays the aliases and listen interface list.
Similar to -c but in addition checks the flags of exported functions from included route blocks.
Uses dns to check if it is necessary to add a "received=" field to a via.
Same as -r but uses reverse dns.
Turns on via host checking when forwarding replies.
Turns on debugging, multiple -d increase the debug level.
Runs openser in the foreground (it doesn't fork into daemon mode).
Sends all the log messages to stderr.
Disables TCP support.
Displays the version number.
-f config-file
Reads the configuration from config-file (default /etc/openser/openser.cfg ).
-l address
Listens on the specified address/interface. Multiple -l mean listening on multiple addresses. The address format is [proto:]address[:port], where proto = udp|tcp and address = host|ip_address|interface_name. Example: -l localhost, -l udp:, -l eth0:5062. The default behaviour is to listen on all the ipv4 interfaces.
-n processes-no
Specifies the number of children processes forked per interface (default 8).
-N tcp processes-no
Specifies the number of children processes forked to handle tcp incoming connections (by default is equal to -n ).
-b max_rcv_buf_size
Maximum receive buffer size which will not be exceeded by the auto-probing procedure even if the OS allows.
-m shared_mem_size
Size of the shared memory which will be allocated (in Megabytes).
-w working-dir
Specifies the working directory. In the very improbable event that openser will crash, the core file will be generated here.
-W method
Specify poll method.
-t chroot-dir
Forces openser to chroot after reading the config file.
-u uid
Changes the user id under which openser runs.
-g gid
Changes the group id under which openser runs.
-P pid-file
Creates a file containing the pid of the main openser process.
-i fifo-path
Creates a fifo, usefull for monitoring openser status.
-x socket-path
Creates a unix socket, usefull for monitoring openser status ( same as -i fifo-path but using instead unix sockets).





see /usr/share/doc/openserAUTHORS




Full documentation on openser is available at

Project tracker and SVN

Mailing lists: - openser user community - openser development, new features and unstable version




This document was created by man2html, using the manual pages.
Time: 22:29:46 GMT, April 16, 2011