1CALLWEAVER(8) CALLWEAVER(8)
2
6 callweaver - All-purpose telephony server.
7
9 callweaver [ -tThfdvVqpRgcin ] [ -C file ] [ -U user ] [ -G group ] [
10 -x command ] [ -M value ]
11 callweaver -r [ -v ] [ -x command ]
14
17 callweaver is a full-featured telephony server which provides Private
18 Branch eXchange (PBX), Interactive Voice Response (IVR), Automated Call
19 Distribution (ACD), Voice over IP (VoIP) gatewaying, Conferencing, and
20 a plethora of other telephony applications to a broad range of tele‐
21 phony devices including packet voice (SIP, IAX, MGCP, Skinny, H.323)
22 devices (both endpoints and proxies), as well as traditional TDM hard‐
23 ware including T1, E1, ISDN PRI, GR-303, RBS, Loopstart, Groundstart,
24 ISDN BRI, T38, and many more.
25 CallWeaver reads most of its configuration files from configuration
27 files located in /opt/callweaver/etc. Virtually all aspects of the
28 operation of callweaver's configuration files can be found in the sam‐
29 ple configuration files. The format for those files is generally
30 beyond the scope of this man page.
31 When running with -c, -r or -R options, CallWeaver supplies a powerful
33 command line, including command completion, which may be used to moni‐
34 tors its status, perform a variety of administrative actions and even
35 explore the applications that are currently loaded into the system.
36
38 -C file
39 Use file as master configuration file instead of the default,
40 ex: /opt/callweaver/etc/callweaver.conf
41 -c Provide a control console on the calling terminal. Specifying
43 this option implies -f and will cause callweaver to no longer
44 fork or detach from the controlling terminal.
45 -d Enable extra debugging statements.
47 -f Do not fork or detach from controlling terminal.
49 -g Remove resource limit on core size, thus forcing CallWeaver to
51 dump core in the unlikely event of a segmentation fault or abort
52 signal. NOTE: in some cases this may be incompatible with the
53 -U or -G flags.
54 -G group
56 Run as group group instead of the calling group. NOTE: this
57 requires substantial work to be sure that CallWeaver's environ‐
58 ment has permission to write the files required for its opera‐
59 tion, including logs, its comm socket, the callweaver database,
60 etc.
61 -h Provide brief summary of command line arguments and terminate.
63 -i Prompt user to intialize any encrypted private keys during
65 startup.
66 -L loadaverage
68 Limits the maximum load average before rejecting new calls.
69 This can be useful to prevent a system from being brought down
70 by terminating too many simultaneous calls.
71 -M value
73 Limits the maximum number of calls to the specified value. This
74 can be useful to prevent a system from being brought down by
75 terminating too many simultaneous calls.
76 -n Disable ANSI colors even on terminals capable of displaying
78 them.
79 -p If supported by the operating system (and executing as root),
81 attempt to run with realtime priority for increased performance
82 and responsiveness within the CallWeaver process, at the expense
83 of other programs running on the same machine.
84 -q Reduce default console output when running in conjunction with
86 console mode (-c).
87 -r Instead of running a new CallWeaver process, attempt to connect
89 to a running CallWeaver process and provide a console interface
90 for controlling it.
91 -R Much like -r. Instead of running a new CallWeaver process,
93 attempt to connect to a running CallWeaver process and provide a
94 console interface for controlling it. Additionally, if connec‐
95 tion to the CallWeaver process is lost, attempt to reconnect for
96 as long as 30 seconds.
97 -t When recording files, write them first into a temporary holding
99 directory, then move them into the final location when done.
100 -T Add timestamp to all non-command related output going to the
102 console when running with verbose and/or logging to the console.
103 -U user
105 Run as user user instead of the calling user. NOTE: this
106 requires substantial work to be sure that CallWeaver's environ‐
107 ment has permission to write the files required for its opera‐
108 tion, including logs, its comm socket, the callweaver database,
109 etc.
110 -v Increase the level of verboseness on the console. The more
112 times -v is specified, the more verbose the output is. Specify‐
113 ing this option implies -f and will cause callweaver to no
114 longer fork or detach from the controlling terminal. This
115 option may also be used in conjunction with -r and -R
116 -V Display version information and exit immediately.
118 -x command
120 Connect to a running CallWeaver process and execute a command on
121 a command line, passing any output through to standard out and
122 then terminating when the command execution completes. Implies
123 -r when -R is not explicitly supplied.
124
126 callweaver - Begin CallWeaver as a daemon
127 callweaver -vvvgc - Run on controlling terminal
129 callweaver -rx "show channels" - Display channels on running server
131
133 Bug reports and feature requests may be filed at http://trac.call‐
134 weaver.org
135
137 *CLI> help - Help on CallWeaver CLI
138 *CLI> show applications - Show loaded applications
140 http://www.callweaver.org - The CallWeaver Home Page
142 http://wiki.callweaver.org - The CallWeaver.org Wiki
144
146 CallWeaver Community www.callweaver.org
147 Countless number of contributers, see CREDITS with distribution for
149 more information
150callweaver 1.2-RC2 12 October 2006 CALLWEAVER(8)