1sipw(8) GNU Telephony sipw(8)
2
6 sipw - sipwitch service daemon
7
9 sipw [--background] [--concurrency=value] [--config=file]
10 [--debug=level] [--foreground] [--gdb] [--group=id] [--history=limit]
11 [--memcheck] [--memleak] [--plugins=names] [--priority=value]
12 [--restarable] [--trace] [--version]
13
15 This is a service daemon for the SIP protocol. This daemon enables sip
16 devices and softphone applications to register as well as to route mes‐
17 sages for the SIP protocol between arbitrary endpoints, both locally
18 and remote over the Internet using DNS to resolve destination uri's.
19 As a telephone system, sipw offers call redirection, speed dials, call
20 forwarding, sms style instant messaging, and the ability to ring multi‐
21 ple user agents tied together under a common user id.
22 The sipw daemon is also being used as a mediator for desktop telephony.
24 For this purpose, sip users become the same as normal login accounts
25 which happen to be in a specific group of sipusers, and sipw will
26 assume a role for VoIP services similar to what gstreamer does for
27 media.
28
30 Normally the sipw daemon is started from an init script or upstart
31 rather than manually, and hence only those options setable in the
32 /etc/default/sipwitch config file can be set. However, the sipw daemon
33 can be manually started, both in the foreground for testing, and in the
34 background. If this is done, a number of options may be passed to it
35 directly as documented.
36 --background
38 Execute the sipw daemon detached in the background (default).
39 --concurrency=level
41 Set the pthread concurrency level for the sipw process.
42 --config=FILE
44 Use specified FILE in place of default config, which is either
45 /etc/sipwitch.conf or ~/.sipwitchrc.
46 --debug=LEVEL
48 Specify debug logging LEVEL (0-9). When run in foreground debug
49 messages are shown on the console. When in background they are
50 saved in the sipwitch log file.
51 --foreground
53 Execute the sipw daemon in the foreground, with output shown on
54 stdout or stderr.
55 --gdb Execute the sipw daemon under control of gdb for full debugging.
57 --group=ID
59 Specify the group ID that the sipw daemon will execute as for
60 receiving control messages or access to daemon managed shared
61 memory.
62 --history=LIMIT
64 Number of errlog events that will be kept in the history buffer.
65 The last LIMIT records at the time will be output whenever
66 requested.
67 --memcheck
69 Execute the sipw daemon under valgrind to validate basic memory
70 management.
71 --memleak
73 Execute the sipw daemon under valgrind for full memory leak
74 detection.
75 --plugins=NAMES
77 Load only these specified plugins from /var/lib/sipwitch.
78 --priority=LEVEL
80 Execute the sipw daemon under the realtime (fifo) schedule, and
81 specify a realtime process priority LEVEL (1-9).
82 --restarable
84 The sipw daemon will automatically restart if it exits or
85 crashes other than from a manually specified reason. This is
86 often used on BSD systems when sipw is started from an rc file.
87 --trace
89 Logs sip messages the sipw daemon sends and receives.
90 --version
92 Print the currently installed version of sipwitch to standard
93 output.
94
96 sipw was written by David Sugar <dyfet@gnutelephony.org>.
97
99 Report bugs to sipwitch-devel@gnu.org.
100
102 Copyright © 2009 David Sugar, Tycho Softworks.
103 This is free software; see the source for copying conditions. There is
104 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
105 PURPOSE.
106GNU SIP Witch December 2009 sipw(8)