NAME¶
sipw - sipwitch service daemon
SYNOPSIS¶
sipw [
options]
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.
- --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.
- --memcheck
- Execute the sipw daemon under valgrind to validate basic memory
management.
- --memleak
- Execute the sipw daemon under valgrind for full memory leak
detection.
- --no-localusers
- Disable use of local (system) user accounts entirely.
- --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 © 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.