man page: updated with the new -I command line option
[sip-router] / sip-router.8
1 .\" $Id$
2 .TH sip-router 8 15.07.2002 sip-router "SIP Router" 
3 .\" Process with
4 .\" groff -man -Tascii sip-router.8
5 .\"
6 .SH NAME
7 sip-router \- very fast and configurable sip proxy
8 .SH SYNOPSIS
9 .B sip-router
10 [
11 .B \-hcrRvdDEVTI
12 ] [
13 .BI \-f " config\-file"
14 ] [
15 .BI \-l " address"
16 ] [
17 .BI \-n " processes\-no"
18 ] [
19 .BI \-N " tcp processes\-no"
20 ] [
21 .BI \-b " max_rcv_buf_size"
22 ] [
23 .BI \-m " shared_mem_size"
24 ] [
25 .BI \-M " private_mem_size"
26 ] [
27 .BI \-w " working\-dir"
28 ] [
29 .BI \-t " chroot\-dir"
30 ] [
31 .BI \-u " uid"
32 ] [
33 .BI \-g " gid"
34 ] [
35 .BI \-P " pid\-file"
36 ] [
37 .BI \-G " pgid\-file"
38 ] [
39 .BI \-L " modules\-dir"
40 ] [
41 .BI \-a " auto\-aliases\-mode"
42 ] [
43 .BI \-A " pre\-processor\-define"
44 ]
45
46 .SH DESCRIPTION
47 .B sip-router 
48 or
49 .BR SIP
50 .BR Router 
51 is a very fast and configurable SIP proxy. 
52
53 .SH OPTIONS
54 .TP 12
55 .B \-h
56 Displays a short usage description, including all available options.
57 .TP
58 .BI \-c
59 Checks the config file and displays the aliases and listen interface list.
60 .TP
61 .BI \-r
62 Uses dns to check if it is necessary to add a "received=" field to a via.
63 .TP
64 .BI \-R
65 Same as 
66 .B \-r
67 but uses reverse dns.
68 .TP
69 .BI \-v
70 Turns on via host checking when forwarding replies.
71 .TP
72 .BI \-d
73 Turns on debugging, multiple
74 .B -d
75 increase the debug level.
76 .TP
77 .BI \-D
78 Runs sip-router in the foreground (it doesn't fork into daemon mode).
79 .TP
80 .BI \-E
81 Sends all the log messages to stderr.
82 .TP
83 .BI \-T
84 Disables TCP support.
85 .TP
86 .BI \-V
87 Displays the version number.
88 .TP
89 .BI \-I
90 Displays details of internal constants and attributes.
91 .TP
92 .BI \-f " config\-file"
93 Reads the configuration from 
94 .B " config\-file" 
95 (default
96 .I  /etc/sip-router/sip-router.cfg
97 ).
98 .TP
99 .BI \-l " address"
100 Listens on the specified address/interface. Multiple 
101 .B \-l
102 mean listening on multiple addresses. The address format is 
103 [proto:]address[:port], where proto = udp|tcp and
104 address = host|ip_address|interface_name. Example: -l localhost, 
105 -l udp:127.0.0.1:5080, -l eth0:5062.
106 The default behaviour is to listen on all the ipv4 interfaces.
107 .TP
108 .BI \-n " processes\-no"
109 Specifies the number of children processes forked per interface (default 8).
110 .TP
111 .BI \-N " tcp processes\-no"
112 Specifies the number of children processes forked to handle tcp incoming connections (by default is equal to
113 .BI \-n
114 ).
115 .TP
116 .BI \-b " max_rcv_buf_size"
117 Maximum receive buffer size which will not be exceeded by the auto-probing procedure even if the OS allows.
118 .TP
119 .BI \-m " shared_mem_size"
120 Size of the shared memory which will be allocated (in Megabytes).
121 .TP
122 .BI \-M " private_mem_size"
123 Size of the private memory which will be allocated per process (in Megabytes).
124 .TP
125 .BI \-w " working\-dir" 
126 Specifies the working directory. In the very improbable event that 
127 .B sip-router 
128 will crash, the core file will be generated here.
129 .TP
130 .BI \-t " chroot\-dir"
131 Forces 
132 .B sip-router 
133 to chroot after reading the config file.
134 .TP
135 .BI \-u " uid"
136 Changes the user id under which 
137 .B sip-router
138 runs.
139 .TP
140 .BI \-g " gid"
141 Changes the group id under which 
142 .B sip-router
143 runs.
144 .TP
145 .BI \-P " pid\-file"
146 Creates a file containing the pid of the main
147 .B sip-router
148 process.
149 .TP
150 .BI \-G " pgid\-file"
151 Creates a file containing the pgid of the main
152 .B sip-router
153 process.
154 .TP
155 .BI \-L " modules\-dir"
156 Specifies the directory where to look for
157 .B sip-router
158 modules (default: /usr/lib/sip-router/modules)
159 .TP
160 .BI \-a " auto\-aliases\-mode"
161 Enable auto-aliases with 'yes' or 'on', disable with 'no' or 'off
162 .TP
163 .BI \-A " pre\-processor\-define"
164 Add config pre-processor define (e.g., -A WITH_AUTH, -A N=1, -A X='"Y"')
165
166 .SH FILES
167 .PD 0
168 .B /usr/sbin/sip-router
169 .br
170 .B /etc/sip-router/sip-router.cfg
171 .br
172 .B /usr/lib/sip-router/modules/*
173 .PD
174 .SH AUTHORS
175
176 see 
177 .B /usr/share/doc/sip-router/AUTHORS
178
179 .SH SEE ALSO
180 .BR sip-router.cfg(5)
181 .PP
182 Full documentation on sip-router, including configuration guidelines, FAQs and
183 licensing conditions, is available at
184 .I http://sip-router.org.
185 .PP 
186 For reporting  bugs see
187 .I
188 http://sip-router.org/tracker/.
189 .PP
190 Mailing lists:
191 .nf 
192 sr-users@lists.sip-router.org - sip-router user community
193 .nf 
194 sr-dev@lists.sip-router.org - sip-router development, new features and unstable version