NAME
sipw - sipwitch service daemon
SYNOPSIS
sipw [--background] [--concurrency=value] [--config=file]
[--debug=level] [--foreground] [--gdb] [--group=id] [--history=limit]
[--memcheck] [--memleak] [--plugins=names] [--priority=value]
[--restarable] [--trace] [--version]
DESCRIPTION
This is a service daemon for the SIP protocol. This daemon enables sip
devices and softphone applications to register as well as to route
messages for the SIP protocol between arbitrary endpoints, both locally
and remote over the Internet using DNS to resolve destination uri's.
As a telephone system, sipw offers call redirection, speed dials, call
forwarding, sms style instant messaging, and the ability to ring
multiple user agents tied together under a common user id.
The sipw daemon is also being used as a mediator for desktop telephony.
For this purpose, sip users become the same as normal login accounts
which happen to be in a specific group of sipusers, and sipw will
assume a role for VoIP services similar to what gstreamer does for
media.
OPTIONS
Normally the sipw daemon is started from an init script or upstart
rather than manually, and hence only those options setable in the
/etc/default/sipwitch config file can be set. However, the sipw daemon
can be manually started, both in the foreground for testing, and in the
background. If this is done, a number of options may be passed to it
directly as documented.
--background
Execute the sipw daemon detached in the background (default).
--concurrency=level
Set the pthread concurrency level for the sipw process.
--config=FILE
Use specified FILE in place of default config, which is either
/etc/sipwitch.conf or ~/.sipwitchrc.
--debug=LEVEL
Specify debug logging LEVEL (0-9). When run in foreground debug
messages are shown on the console. When in background they are
saved in the sipwitch log file.
--foreground
Execute the sipw daemon in the foreground, with output shown on
stdout or stderr.
--gdb Execute the sipw daemon under control of gdb for full debugging.
--group=ID
Specify the group ID that the sipw daemon will execute as for
receiving control messages or access to daemon managed shared
memory.
--history=LIMIT
Number of errlog events that will be kept in the history buffer.
The last LIMIT records at the time will be output whenever
requested.
--memcheck
Execute the sipw daemon under valgrind to validate basic memory
management.
--memleak
Execute the sipw daemon under valgrind for full memory leak
detection.
--plugins=NAMES
Load only these specified plugins from /var/lib/sipwitch.
--priority=LEVEL
Execute the sipw daemon under the realtime (fifo) schedule, and
specify a realtime process priority LEVEL (1-9).
--restarable
The sipw daemon will automatically restart if it exits or
crashes other than from a manually specified reason. This is
often used on BSD systems when sipw is started from an rc file.
--trace
Logs sip messages the sipw daemon sends and receives.
--version
Print the currently installed version of sipwitch to standard
output.
AUTHOR
sipw was written by David Sugar <dyfet@gnutelephony.org>.
REPORTING BUGS
Report bugs to sipwitch-devel@gnu.org.
COPYRIGHT
Copyright (C) 2009 David Sugar, Tycho Softworks.
This is free software; see the source for copying conditions. There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.