1sipw(8)                          GNU Telephony                         sipw(8)
2
3
4

NAME

6       sipw - sipwitch service daemon
7

SYNOPSIS

9       sipw [options]
10

DESCRIPTION

12       This is a service daemon for the SIP protocol.  This daemon enables sip
13       devices and softphone applications to register as well as to route mes‐
14       sages  for  the  SIP protocol between arbitrary endpoints, both locally
15       and remote over the Internet using DNS to  resolve  destination  uri's.
16       As  a telephone system, sipw offers call redirection, speed dials, call
17       forwarding, sms style instant messaging, and the ability to ring multi‐
18       ple user agents tied together under a common user id.
19
20       The sipw daemon is also being used as a mediator for desktop telephony.
21       For this purpose, sip users become the same as  normal  login  accounts
22       which  happen  to  be  in  a  specific group of sipusers, and sipw will
23       assume a role for VoIP services similar  to  what  gstreamer  does  for
24       media.
25

OPTIONS

27       Normally  the  sipw  daemon  is  started from an init script or upstart
28       rather than manually, and hence  only  those  options  setable  in  the
29       /etc/default/sipwitch config file can be set.  However, the sipw daemon
30       can be manually started, both in the foreground for testing, and in the
31       background.   If  this is done, a number of options may be passed to it
32       directly as documented.
33
34       --background
35              Execute the sipw daemon detached in the background (default).
36
37       --concurrency=level
38              Set the pthread concurrency level for the sipw process.
39
40       --debug=level
41              Specify debug logging level (0-9).  When run in foreground debug
42              messages  are shown on the console.  When in background they are
43              saved in the sipwitch log file.
44
45       --foreground
46              Execute the sipw daemon in the foreground, with output shown  on
47              stdout or stderr.
48
49       --gdb  Execute the sipw daemon under control of gdb for full debugging.
50
51       --group=id
52              Specify  the  group  id that the sipw daemon will execute as for
53              receiving control messages or access to  daemon  managed  shared
54              memory.
55
56       --memcheck
57              Execute  the sipw daemon under valgrind to validate basic memory
58              management.
59
60       --memleak
61              Execute the sipw daemon under  valgrind  for  full  memory  leak
62              detection.
63
64       --no-localusers
65              Disable use of local (system) user accounts entirely.
66
67       --plugins=names
68              Load only these specified plugins from /var/lib/sipwitch.
69
70       --priority=level
71              Execute  the sipw daemon under the realtime (fifo) schedule, and
72              specify a realtime process priority level (1-9).
73
74       --restarable
75              The sipw daemon  will  automatically  restart  if  it  exits  or
76              crashes  other  than  from a manually specified reason.  This is
77              often used on BSD systems when sipw is started from an rc file.
78
79       --trace
80              Logs sip messages the sipw daemon sends and receives.
81
82       --version
83              Print the currently installed version of  sipwitch  to  standard
84              output.
85

AUTHOR

87       sipw was written by David Sugar <dyfet@gnutelephony.org>.
88

REPORTING BUGS

90       Report bugs to sipwitch-devel@gnu.org or bugs@gnutelephony.org.
91

93       Copyright © 2009-2014 David Sugar, Tycho Softworks.
94       This is free software; see the source for copying conditions.  There is
95       NO warranty; not even for MERCHANTABILITY or FITNESS FOR  A  PARTICULAR
96       PURPOSE.
97
98
99
100
101GNU SIP Witch                    December 2009                         sipw(8)
Impressum