doc/webserver/faq/contact.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Contacting the developers, Bug Reporting and Feature Requests</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
   9 REL="HOME"
  10 TITLE="Privoxy Frequently Asked Questions"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="Troubleshooting"
  14 HREF="trouble.html"><LINK
  15 REL="NEXT"
  16 TITLE="Privoxy Copyright, License and History"
  17 HREF="copyright.html"><LINK
  18 REL="STYLESHEET"
  19 TYPE="text/css"
  20 HREF="../p_doc.css"><META
  21 HTTP-EQUIV="Content-Type"
  22 CONTENT="text/html;
  23 charset=ISO-8859-1"></HEAD
  24 ><BODY
  25 CLASS="SECT1"
  26 BGCOLOR="#EEEEEE"
  27 TEXT="#000000"
  28 LINK="#0000FF"
  29 VLINK="#840084"
  30 ALINK="#0000FF"
  31 ><DIV
  32 CLASS="NAVHEADER"
  33 ><TABLE
  34 SUMMARY="Header navigation table"
  35 WIDTH="100%"
  36 BORDER="0"
  37 CELLPADDING="0"
  38 CELLSPACING="0"
  39 ><TR
  40 ><TH
  41 COLSPAN="3"
  42 ALIGN="center"
  43 >Privoxy Frequently Asked Questions</TH
  44 ></TR
  45 ><TR
  46 ><TD
  47 WIDTH="10%"
  48 ALIGN="left"
  49 VALIGN="bottom"
  50 ><A
  51 HREF="trouble.html"
  52 ACCESSKEY="P"
  53 >Prev</A
  54 ></TD
  55 ><TD
  56 WIDTH="80%"
  57 ALIGN="center"
  58 VALIGN="bottom"
  59 ></TD
  60 ><TD
  61 WIDTH="10%"
  62 ALIGN="right"
  63 VALIGN="bottom"
  64 ><A
  65 HREF="copyright.html"
  66 ACCESSKEY="N"
  67 >Next</A
  68 ></TD
  69 ></TR
  70 ></TABLE
  71 ><HR
  72 ALIGN="LEFT"
  73 WIDTH="100%"></DIV
  74 ><DIV
  75 CLASS="SECT1"
  76 ><H1
  77 CLASS="SECT1"
  78 ><A
  79 NAME="CONTACT"
  80 >6. Contacting the developers, Bug Reporting and Feature Requests</A
  81 ></H1
  82 ><P
  83 > We value your feedback. In fact, we rely on it to improve
  84  <SPAN
  85 CLASS="APPLICATION"
  86 >Privoxy</SPAN
  87 > and its configuration.
  88  However, please note the following hints, so we can
  89  provide you with the best support.</P
  90 ><DIV
  91 CLASS="SECT2"
  92 ><H2
  93 CLASS="SECT2"
  94 ><A
  95 NAME="SUFFICIENT-INFORMATION"
  96 >6.1. Please provide sufficient information</A
  97 ></H2
  98 ><P
  99 > A lot of support requests don't contain enough information and can't
 100  be solved without a lot of back and forth which causes unnecessary
 101  delays. Reading this section should help to prevent that.</P
 102 ><P
 103 >  Before contacting us to report a problem, please try to verify that it is a
 104   <SPAN
 105 CLASS="APPLICATION"
 106 >Privoxy</SPAN
 107 > problem, and not a browser or site problem
 108   or documented behaviour that just happens to be different than what you expected.
 109   If unsure,
 110   try <A
 111 HREF="http://config.privoxy.org/toggle?set=disable"
 112 TARGET="_top"
 113 >toggling
 114   off</A
 115 > <SPAN
 116 CLASS="APPLICATION"
 117 >Privoxy</SPAN
 118 >, and see if the problem persists.</P
 119 ><P
 120 >  If you are using your own custom configuration, please try the default
 121   configuration to see if the problem is configuration related.
 122   If you're having problems with a feature that is disabled by default,
 123   please ask around on the mailing list if others can reproduce the problem.</P
 124 ><P
 125 >  If you aren't using the latest Privoxy version, the problem may have been found
 126   and fixed in the meantime. We would appreciate if you could take the time
 127   to <A
 128 HREF="https://www.privoxy.org/user-manual/installation.html"
 129 TARGET="_top"
 130 >upgrade
 131   to the latest version</A
 132 > and verify that the problem still exists.</P
 133 ><P
 134 >  Please be sure to provide the following information when reporting problems
 135   or requesting support:</P
 136 ><P
 137 ></P
 138 ><UL
 139 ><LI
 140 ><P
 141 >    The exact <SPAN
 142 CLASS="APPLICATION"
 143 >Privoxy</SPAN
 144 > version you are using.
 145    </P
 146 ></LI
 147 ><LI
 148 ><P
 149 >    The operating system and versions you run
 150     <SPAN
 151 CLASS="APPLICATION"
 152 >Privoxy</SPAN
 153 > on, e.g. <SPAN
 154 CLASS="APPLICATION"
 155 >Windows
 156     XP SP2</SPAN
 157 >.
 158    </P
 159 ></LI
 160 ><LI
 161 ><P
 162 >    The name, platform, and version of the <SPAN
 163 CLASS="APPLICATION"
 164 >browser</SPAN
 165 >
 166     you were using (e.g. <SPAN
 167 CLASS="APPLICATION"
 168 >Internet Explorer v5.5</SPAN
 169 > for Mac).
 170    </P
 171 ></LI
 172 ><LI
 173 ><P
 174 >    The URL where the problem occurred, or some way for us to duplicate the
 175     problem (e.g. <TT
 176 CLASS="LITERAL"
 177 >http://somesite.example.com/?somethingelse=123</TT
 178 >).
 179    </P
 180 ></LI
 181 ><LI
 182 ><P
 183 >    Whether your version of <SPAN
 184 CLASS="APPLICATION"
 185 >Privoxy</SPAN
 186 > is one supplied
 187     by the <SPAN
 188 CLASS="APPLICATION"
 189 >Privoxy</SPAN
 190 > developers via SourceForge,
 191     or if you got your copy somewhere else.
 192    </P
 193 ></LI
 194 ><LI
 195 ><P
 196 >    Whether you are using <SPAN
 197 CLASS="APPLICATION"
 198 >Privoxy</SPAN
 199 > together with
 200     another proxy such as <SPAN
 201 CLASS="APPLICATION"
 202 >Tor</SPAN
 203 >. If so, please
 204     temporary disable the other proxy to see if the symptoms change.
 205    </P
 206 ></LI
 207 ><LI
 208 ><P
 209 >    Whether you are using a personal firewall product. If so, does
 210     <SPAN
 211 CLASS="APPLICATION"
 212 >Privoxy</SPAN
 213 > work without it?
 214    </P
 215 ></LI
 216 ><LI
 217 ><P
 218 >    Any other pertinent information to help identify the problem such as config
 219     or log file excerpts (yes, you should have log file entries for each
 220     action taken). To get a meaningful logfile, please make sure that the
 221     <A
 222 HREF="../user-manual/config.html#LOGFILE"
 223 TARGET="_top"
 224 >logfile directive</A
 225 >
 226     is being used and the following <A
 227 HREF="../user-manual/config.html#DEBUG"
 228 TARGET="_top"
 229 >debug options</A
 230 > are enabled
 231     (all of them):
 232    </P
 233 ><P
 234 CLASS="LITERALLAYOUT"
 235 >debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;1&nbsp;#&nbsp;Log&nbsp;the&nbsp;destination&nbsp;for&nbsp;each&nbsp;request&nbsp;Privoxy&nbsp;let&nbsp;through.<br>
 236 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;&nbsp;&nbsp;See&nbsp;also&nbsp;debug&nbsp;1024.<br>
 237 debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;2&nbsp;#&nbsp;show&nbsp;each&nbsp;connection&nbsp;status<br>
 238 debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;4&nbsp;#&nbsp;show&nbsp;I/O&nbsp;status<br>
 239 debug&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;8&nbsp;#&nbsp;show&nbsp;header&nbsp;parsing<br>
 240 debug&nbsp;&nbsp;&nbsp;128&nbsp;#&nbsp;debug&nbsp;redirects<br>
 241 debug&nbsp;&nbsp;&nbsp;256&nbsp;#&nbsp;debug&nbsp;GIF&nbsp;de-animation<br>
 242 debug&nbsp;&nbsp;&nbsp;512&nbsp;#&nbsp;Common&nbsp;Log&nbsp;Format<br>
 243 debug&nbsp;&nbsp;1024&nbsp;#&nbsp;Log&nbsp;the&nbsp;destination&nbsp;for&nbsp;requests&nbsp;Privoxy&nbsp;didn't&nbsp;let&nbsp;through,<br>
 244 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;&nbsp;&nbsp;and&nbsp;the&nbsp;reason&nbsp;why.<br>
 245 debug&nbsp;&nbsp;4096&nbsp;#&nbsp;Startup&nbsp;banner&nbsp;and&nbsp;warnings.<br>
 246 debug&nbsp;&nbsp;8192&nbsp;#&nbsp;Non-fatal&nbsp;errors<br>
 247 debug&nbsp;65536&nbsp;#&nbsp;Log&nbsp;applying&nbsp;actions</P
 248 ><P
 249 >    If you are having trouble with a filter, please additionally enable
 250    </P
 251 ><P
 252 CLASS="LITERALLAYOUT"
 253 >debug&nbsp;&nbsp;&nbsp;&nbsp;64&nbsp;#&nbsp;debug&nbsp;regular&nbsp;expression&nbsp;filters</P
 254 ><P
 255 >    If you suspect that Privoxy interprets the request or the response
 256     incorrectly, please enable
 257    </P
 258 ><P
 259 CLASS="LITERALLAYOUT"
 260 >debug&nbsp;32768&nbsp;#&nbsp;log&nbsp;all&nbsp;data&nbsp;read&nbsp;from&nbsp;the&nbsp;network</P
 261 ><P
 262 >    It's easy for us to ignore log messages that aren't relevant but missing
 263     log messages may make it impossible to investigate a problem. If you aren't
 264     sure which of the debug directives are relevant, please just enable all of them
 265     and let us worry about it.
 266    </P
 267 ><P
 268 >    Note that Privoxy log files may contain sensitive information so please don't
 269     submit any logfiles you didn't read first. You can mask sensitive information
 270     as long as it's clear that you removed something.
 271    </P
 272 ></LI
 273 ></UL
 274 ><P
 275 > You don't have to tell us your actual name when filing a problem
 276  report, but if you don't, please use a nickname so we can differentiate
 277  between your messages and the ones entered by other "anonymous" users that
 278  may respond to your request if they have the same problem or already
 279  found a solution. Note that due to spam the trackers may not always
 280  allow to post without being logged into SourceForge. If that's the
 281  case, you are still free to create a login that isn't directly linked
 282  to your name, though.</P
 283 ><P
 284 > Please also check the status of your request a few days after submitting
 285  it, as we may request additional information. If you use a SF id,
 286  you should automatically get a mail when someone responds to your request.
 287  Please don't bother to add an email address when using the tracker.
 288  If you prefer to communicate through email, just use one of the mailing
 289  lists directly.</P
 290 ><P
 291 > If you are new to reporting problems, you might be interested in
 292   <A
 293 HREF="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html"
 294 TARGET="_top"
 295 >How to Report Bugs Effectively</A
 296 >.</P
 297 ><P
 298 >  The <A
 299 HREF="https://www.privoxy.org/user-manual/appendix.html#ACTIONSANAT"
 300 TARGET="_top"
 301 >appendix
 302   of the Privoxy User Manual</A
 303 > also has helpful information
 304   on understanding <TT
 305 CLASS="LITERAL"
 306 >actions</TT
 307 >, and <TT
 308 CLASS="LITERAL"
 309 >action</TT
 310 > debugging.</P
 311 ></DIV
 312 ><DIV
 313 CLASS="SECT2"
 314 ><H2
 315 CLASS="SECT2"
 316 ><A
 317 NAME="CONTACT-SUPPORT"
 318 >6.2. Get Support</A
 319 ></H2
 320 ><P
 321 > All users are welcome to discuss their issues on the <A
 322 HREF="https://lists.privoxy.org/mailman/listinfo/privoxy-users"
 323 TARGET="_top"
 324 >users
 325  mailing list</A
 326 >, where the developers also hang around.</P
 327 ><P
 328 > Please don't send private support requests to individual Privoxy
 329  developers, either use the mailing lists or the support trackers.</P
 330 ><P
 331 > If you have to contact a Privoxy developer directly for other reasons,
 332  please send a real mail and do not bother with SourceForge's messaging
 333  system. Answers to SourceForge messages are usually bounced by SourceForge's
 334  mail server in which case the developer wasted time writing a response you
 335  don't get. From your point of view it will look like your message has
 336  been completely ignored, so this is frustrating for all parties involved.</P
 337 ><P
 338 > Note that the Privoxy mailing lists are moderated. Posts from unsubscribed
 339  addresses have to be accepted manually by a moderator. This may cause a
 340  delay of several days and if you use a subject that doesn't clearly
 341  mention Privoxy or one of its features, your message may be accidentally
 342  discarded as spam.</P
 343 ><P
 344 > If you aren't subscribed, you should therefore spend a few seconds
 345  to come up with a proper subject. Additionally you should make it clear
 346  that you want to get CC'd. Otherwise some responses will be directed to
 347  the mailing list only, and you won't see them.</P
 348 ></DIV
 349 ><DIV
 350 CLASS="SECT2"
 351 ><H2
 352 CLASS="SECT2"
 353 ><A
 354 NAME="REPORTING"
 355 >6.3. Reporting Problems</A
 356 ></H2
 357 ><P
 358 ><SPAN
 359 CLASS="QUOTE"
 360 >"Problems"</SPAN
 361 > for our purposes, come in two forms:</P
 362 ><P
 363 ></P
 364 ><UL
 365 ><LI
 366 ><P
 367 >    Configuration issues, such as ads that slip through, or sites that
 368     don't function properly due to one <SPAN
 369 CLASS="APPLICATION"
 370 >Privoxy</SPAN
 371 >
 372     <SPAN
 373 CLASS="QUOTE"
 374 >"action"</SPAN
 375 > or another being turned <SPAN
 376 CLASS="QUOTE"
 377 >"on"</SPAN
 378 >.
 379    </P
 380 ></LI
 381 ><LI
 382 ><P
 383 >    <SPAN
 384 CLASS="QUOTE"
 385 >"Bugs"</SPAN
 386 > in the programming code that makes up
 387     <SPAN
 388 CLASS="APPLICATION"
 389 >Privoxy</SPAN
 390 >, such as that might cause a crash.
 391     Documentation issues, for example spelling errors and unclear descriptions,
 392     are bugs, too.
 393    </P
 394 ></LI
 395 ></UL
 396 ><DIV
 397 CLASS="SECT3"
 398 ><H3
 399 CLASS="SECT3"
 400 ><A
 401 NAME="CONTACT-ADS"
 402 >6.3.1. Reporting Ads or Other Configuration Problems</A
 403 ></H3
 404 ><P
 405 > Please send feedback on ads that slipped through, innocent images that were
 406  blocked, sites that don't work properly, and other configuration related problem of
 407  <TT
 408 CLASS="FILENAME"
 409 >default.action</TT
 410 > file, to
 411  <A
 412 HREF="https://sourceforge.net/tracker/?group_id=11118&#38;atid=460288"
 413 TARGET="_top"
 414 > https://sourceforge.net/tracker/?group_id=11118&#38;atid=460288</A
 415 >,
 416  the Actions File Tracker.</P
 417 ></DIV
 418 ><DIV
 419 CLASS="SECT3"
 420 ><H3
 421 CLASS="SECT3"
 422 ><A
 423 NAME="CONTACT-BUGS"
 424 >6.3.2. Reporting Bugs</A
 425 ></H3
 426 ><P
 427 >  Before reporting bugs, please make sure that the bug has <SPAN
 428 CLASS="emphasis"
 429 ><I
 430 CLASS="EMPHASIS"
 431 >not already been submitted</I
 432 ></SPAN
 433 >
 434   and observe the additional hints at the top of the <A
 435 HREF="https://sourceforge.net/tracker/?func=add&#38;group_id=11118&#38;atid=111118"
 436 TARGET="_top"
 437 >submit
 438   form</A
 439 >. If already submitted, please feel free to add any info to the
 440   original report that might help to solve the issue.</P
 441 ></DIV
 442 ></DIV
 443 ><DIV
 444 CLASS="SECT2"
 445 ><H2
 446 CLASS="SECT2"
 447 ><A
 448 NAME="SECURITY-CONTACT"
 449 >6.4. Reporting security problems</A
 450 ></H2
 451 ><P
 452 > If you discovered a security problem or merely suspect that a bug might
 453  be a security issue, please mail Fabian Keil &#60;fk@fabiankeil.de&#62;
 454  (OpenPGP fingerprint: 4F36 C17F 3816 9136 54A1 E850 6918 2291 8BA2 371C).</P
 455 ><P
 456 > Usually you should get a response within a day, otherwise it's
 457  likely that either your mail or the response didn't make it.
 458  If that happens, please mail to the developer list to request a
 459  status update.</P
 460 ></DIV
 461 ><DIV
 462 CLASS="SECT2"
 463 ><H2
 464 CLASS="SECT2"
 465 ><A
 466 NAME="MAILING-LISTS"
 467 >6.5. Mailing Lists</A
 468 ></H2
 469 ><P
 470 >If you prefer to communicate through email, instead of using a web interface,
 471 feel free to use one of the mailing lists.
 472 To discuss issues that haven't been completely diagnosed yet, please use the Privoxy
 473 users list. Technically interested users and people who wish to contribute to
 474 the project are always welcome on the developers list.
 475 You can find an overview of all <SPAN
 476 CLASS="APPLICATION"
 477 >Privoxy</SPAN
 478 >-related mailing lists,
 479 including list archives, at:
 480 <A
 481 HREF="https://lists.privoxy.org/mailman/listinfo"
 482 TARGET="_top"
 483 >https://lists.privoxy.org/mailman/listinfo</A
 484 >.
 485 The lists hosted on privoxy.org have been created in 2016, the previously-used
 486 lists hosted at SourceForge are deprecated but the archives may still be useful:
 487 <A
 488 HREF="https://sourceforge.net/mail/?group_id=11118"
 489 TARGET="_top"
 490 >https://sourceforge.net/mail/?group_id=11118</A
 491 >.</P
 492 ></DIV
 493 ><DIV
 494 CLASS="SECT2"
 495 ><H2
 496 CLASS="SECT2"
 497 ><A
 498 NAME="SF-TRACKERS"
 499 >6.6. SourceForge support trackers</A
 500 ></H2
 501 ><P
 502 > The
 503  <A
 504 HREF="https://sourceforge.net/tracker/?group_id=11118&#38;atid=211118"
 505 TARGET="_top"
 506 >SourceForge support trackers</A
 507 >
 508  may be used as well, but have various technical problems that are unlikely to
 509  be fixed anytime soon. If you don't get a timely response, please try the
 510  mailing list as well.</P
 511 ></DIV
 512 ></DIV
 513 ><DIV
 514 CLASS="NAVFOOTER"
 515 ><HR
 516 ALIGN="LEFT"
 517 WIDTH="100%"><TABLE
 518 SUMMARY="Footer navigation table"
 519 WIDTH="100%"
 520 BORDER="0"
 521 CELLPADDING="0"
 522 CELLSPACING="0"
 523 ><TR
 524 ><TD
 525 WIDTH="33%"
 526 ALIGN="left"
 527 VALIGN="top"
 528 ><A
 529 HREF="trouble.html"
 530 ACCESSKEY="P"
 531 >Prev</A
 532 ></TD
 533 ><TD
 534 WIDTH="34%"
 535 ALIGN="center"
 536 VALIGN="top"
 537 ><A
 538 HREF="index.html"
 539 ACCESSKEY="H"
 540 >Home</A
 541 ></TD
 542 ><TD
 543 WIDTH="33%"
 544 ALIGN="right"
 545 VALIGN="top"
 546 ><A
 547 HREF="copyright.html"
 548 ACCESSKEY="N"
 549 >Next</A
 550 ></TD
 551 ></TR
 552 ><TR
 553 ><TD
 554 WIDTH="33%"
 555 ALIGN="left"
 556 VALIGN="top"
 557 >Troubleshooting</TD
 558 ><TD
 559 WIDTH="34%"
 560 ALIGN="center"
 561 VALIGN="top"
 562 >&nbsp;</TD
 563 ><TD
 564 WIDTH="33%"
 565 ALIGN="right"
 566 VALIGN="top"
 567 >Privoxy Copyright, License and History</TD
 568 ></TR
 569 ></TABLE
 570 ></DIV
 571 ></BODY
 572 ></HTML
 573 >