Documentation update for stacksize / -S

doc/html/faqe.html

@@ -64,6 +64,14 @@ to automatically reload configuration on address change.
 A: Check you use system DSN. 
 Check SQL request is valid. 
 The best way to check is to make file or stdout logging, get SQL request from log file or console and execute this request manually.
+Under Unix, you may also want to adjust 'stacksize' parameter.
+
+<p><i>Q: Why proxy crash on request processing?</a></i></p>
+<i>A:</i> default stacksize may be insufficient, if some non-default plugins
+  are used (e.g. PAM and ODBC on Linux) or if compiled on some platforms with
+  invalid system defined values (few versionds of FreeBSD on amd64).
+  Problem can be resolved with 'stacksize' command or '-S' option starting 3proxy 0.8.4.
+
 
 <p><i>Q: Why doesn't APOP/CRAM-MD5 authentication work with POP3 proxy?</i></p>
 A: Any Challenge-response authentication require challenge to be transmitted from server. Pop3p doesn't know which server to use before authentication, it makes it impossible to obtain challenge. You can encrypt your POP3 communications with TLS (i.e. stunnel) or IPSec.

doc/html/faqr.html

@@ -9,6 +9,7 @@
     <li><a href="#INTEXT">Q: Почему не получается указать internal и external?</a></li>
     <li><a href="#ODBC">Q: Почему не работает ведение журналов в ODBC?</a></li>
     <li><a href="#CHAP">Q: Почему не поддерживаются APOP и CRAM-MD5 в POP3 прокси?</a></li>
+    <li><a href="#CRASH">Q: Почему прокси крэшится при обработке запроса?</a></li>
   </ul>
   <li><a href="#SOCKSREDIR">Перенаправление socks соединений в локальный прокси</a></li>
   <ul>
@@ -128,6 +129,13 @@
   невозможен. Защитить соединение можно с помощью TLS (например, stunnel) или
   IPSec.
   </p>
+  <li><a name="#CRASH"><i>Q: Почему прокси крэшится при обработке запроса?</a></i></li>
+  <p>
+  <i>A:</i> Возможно, недостаточен размер стека потока по-умолчанию, это может
+  быть при использовани каких-либо сторонних плагинов (PAM, ODBC) или на
+  некоторых платформах (некоторые версии FreeBSD на amd64). Можно решить
+  проблему с помощью опции 'stacksize' или '-S', поддерживаемых в 0.8.4 и выше.
+  </p>
 </ul>
 <hr>
 <li><b><a name="SOCKSREDIR">Перенаправление socks соединений в локальный прокси</a></b></li>

man/3proxy.cfg.3

@@ -915,6 +915,20 @@ as
 .br
  function_to_call must return 0 in case of success, value > 0 to indicate error.
 
+.br
+.B stacksize
+<value_to_add_to_default_stack_size>
+.br
+ Change default size for threads stack. May be required in some situation,
+ e.g. with non-default plugins, on on some platforms (some FreeBSD version
+ may require adjusting stack size due to invalid defined value in system
+ header files, this value is also oftent reqruied to be changed for ODBC and
+ PAM support on Linux. If you experience 3proxy
+ crash on request processing, try to set some positive value. You may start with
+ stacksize 65536 
+ and then find the minimal value for service to work. If you experience
+ memory shortage, you can try to experiment with negative values.
+
 .br
 .B filtermaxsize
 <max_size_of_data_to_filter>

man/ftppr.8

@@ -51,6 +51,9 @@ is specified logging is to file. Under Unix, if
 preceeds
 .IR logfile ,
 syslog is used for logging.
+.B -S
+Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy
+crashes.
 .SH CLIENTS
 You can use any FTP client, regardless of FTP proxy support. For client with
 FTP proxy support configure

man/icqpr.8

@@ -45,6 +45,9 @@ is specified logging is to file. Under Unix, if
 preceeds
 .IR logfile ,
 syslog is used for logging.
+.B -S
+Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy
+crashes.
 .SH ARGUMENTS
 .TP
 .I local_port

man/pop3p.8

@@ -51,6 +51,9 @@ is specified logging is to file. Under Unix, if
 preceeds
 .IR logfile ,
 syslog is used for logging.
+.B -S
+Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy
+crashes.
 .SH CLIENTS
 You can use any MUA (Mail User Agent) with POP3 support. Set client to use
 .I internal_ip

man/proxy.8

@@ -52,6 +52,9 @@ is specified logging is to file. Under Unix, if
 preceeds
 .IR logfile ,
 syslog is used for logging.
+.B -S
+Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy
+crashes.
 .SH CLIENTS
 You should use client with HTTP proxy support or configure router to redirect
 HTTP traffic to proxy (transparent proxy). Configure client to connect to

man/smtpp.8

@@ -51,6 +51,9 @@ is specified logging is to file. Under Unix, if
 preceeds
 .IR logfile ,
 syslog is used for logging.
+.B -S
+Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy
+crashes.
 .SH CLIENTS
 You can use any MUA (Mail User Agent) with SMTP authentication support.
 Set client to use

man/socks.8

@@ -48,6 +48,9 @@ is specified logging is to file. Under Unix, if
 preceeds
 .IR logfile ,
 syslog is used for logging.
+.B -S
+Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy
+crashes.
 .SH CLIENTS
 You should use client with SOCKS support or use some socksification support
 (for example

man/tcppm.8

@@ -40,6 +40,9 @@ is specified logging is to file. Under Unix, if
 preceeds
 .IR logfile ,
 syslog is used for logging.
+.B -S
+Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy
+crashes.
 .SH ARGUMENTS
 .TP
 .I local_port

man/udppm.8

@@ -46,6 +46,9 @@ Single packet. By default only one client can use udppm service, but
 if -s is specified only one packet will be forwarded between client and server.
 It allows to share service between multiple clients for single packet services
 (for example name lookups).
+.B -S
+Increase or decrease stack size. You may want to try something like -S8192 if you experience 3proxy
+crashes.
 .SH ARGUMENTS
 .TP
 .I local_port