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.