Rebuild with latest changes.
[privoxy.git] / doc / webserver / user-manual / startup.html
index c0dc0b9..2dcdb7a 100644 (file)
@@ -1,13 +1,13 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
 <HTML
 ><HEAD
 ><TITLE
 >Starting Privoxy</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
-"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
 REL="HOME"
-TITLE="Privoxy 3.0.5 User Manual"
+TITLE="Privoxy 3.0.9 User Manual"
 HREF="index.html"><LINK
 REL="PREVIOUS"
 TITLE="Quickstart to Using Privoxy"
@@ -17,7 +17,10 @@ TITLE="Privoxy Configuration"
 HREF="configuration.html"><LINK
 REL="STYLESHEET"
 TYPE="text/css"
-HREF="../p_doc.css">
+HREF="../p_doc.css"><META
+HTTP-EQUIV="Content-Type"
+CONTENT="text/html;
+charset=ISO-8859-1">
 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
 </head
 ><BODY
@@ -39,7 +42,7 @@ CELLSPACING="0"
 ><TH
 COLSPAN="3"
 ALIGN="center"
->Privoxy 3.0.5 User Manual</TH
+>Privoxy 3.0.9 User Manual</TH
 ></TR
 ><TR
 ><TD
@@ -76,8 +79,8 @@ CLASS="SECT1"
 CLASS="SECT1"
 ><A
 NAME="STARTUP"
-></A
->5. Starting Privoxy</H1
+>5. Starting Privoxy</A
+></H1
 ><P
 > Before launching <SPAN
 CLASS="APPLICATION"
@@ -111,7 +114,7 @@ CLASS="APPLICATION"
 >  <DIV
 CLASS="FIGURE"
 ><A
-NAME="AEN617"
+NAME="AEN615"
 ></A
 ><P
 ><B
@@ -132,7 +135,7 @@ SRC="proxy_setup.jpg"></P
  With <SPAN
 CLASS="APPLICATION"
 >Firefox</SPAN
->, this can be set under:</P
+>, this is typically set under:</P
 ><P
 CLASS="LITERALLAYOUT"
 >&nbsp;<SPAN
@@ -141,6 +144,30 @@ CLASS="GUIBUTTON"
 >&nbsp;-&#62;&nbsp;<SPAN
 CLASS="GUIBUTTON"
 >Options</SPAN
+>&nbsp;-&#62;&nbsp;&nbsp;<SPAN
+CLASS="GUIBUTTON"
+>Advanced</SPAN
+>&nbsp;-&#62;&nbsp;<SPAN
+CLASS="GUIBUTTON"
+>Network</SPAN
+>&nbsp;-&#62;<SPAN
+CLASS="GUIBUTTON"
+>Connection</SPAN
+>&nbsp;-&#62;&nbsp;<SPAN
+CLASS="GUIBUTTON"
+>Settings</SPAN
+><br>&#13;</P
+><P
+> 
+ Or optionally on some platforms:</P
+><P
+CLASS="LITERALLAYOUT"
+>&nbsp;<SPAN
+CLASS="GUIBUTTON"
+>Edit</SPAN
+>&nbsp;-&#62;&nbsp;<SPAN
+CLASS="GUIBUTTON"
+>Preferences</SPAN
 >&nbsp;-&#62;&nbsp;<SPAN
 CLASS="GUIBUTTON"
 >General</SPAN
@@ -182,7 +209,7 @@ CLASS="GUIBUTTON"
 ><P
 > For <SPAN
 CLASS="APPLICATION"
->Internet Explorer v.5-6</SPAN
+>Internet Explorer v.5-7</SPAN
 >: </P
 ><P
 CLASS="LITERALLAYOUT"
@@ -224,7 +251,7 @@ CLASS="EMPHASIS"
 >  <DIV
 CLASS="FIGURE"
 ><A
-NAME="AEN654"
+NAME="AEN660"
 ></A
 ><P
 ><B
@@ -281,8 +308,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-REDHAT"
-></A
->5.1. Red Hat, Fedora and Conectiva</H2
+>5.1. Red Hat and Fedora</A
+></H2
 ><P
 > A default Red Hat installation may not start <SPAN
 CLASS="APPLICATION"
@@ -330,8 +357,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-DEBIAN"
-></A
->5.2. Debian</H2
+>5.2. Debian</A
+></H2
 ><P
 > We use a script. Note that Debian typically starts <SPAN
 CLASS="APPLICATION"
@@ -363,39 +390,9 @@ CLASS="SECT2"
 ><H2
 CLASS="SECT2"
 ><A
-NAME="START-SUSE"
-></A
->5.3. SuSE</H2
-><P
->We use a script. It will use the file <TT
-CLASS="FILENAME"
->/etc/privoxy/config</TT
->
-as its main configuration file. Note that SuSE starts Privoxy upon booting
-your PC.</P
-><P
-> <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
-> # rcprivoxy start</PRE
-></TD
-></TR
-></TABLE
-></P
-></DIV
-><DIV
-CLASS="SECT2"
-><H2
-CLASS="SECT2"
-><A
 NAME="START-WINDOWS"
-></A
->5.4. Windows</H2
+>5.3. Windows</A
+></H2
 ><P
 >Click on the <SPAN
 CLASS="APPLICATION"
@@ -442,8 +439,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-UNICES"
-></A
->5.5. Solaris, NetBSD, FreeBSD, HP-UX and others</H2
+>5.4. Solaris, NetBSD, FreeBSD, HP-UX and others</A
+></H2
 ><P
 >Example Unix startup command:</P
 ><P
@@ -467,8 +464,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-OS2"
-></A
->5.6. OS/2</H2
+>5.5. OS/2</A
+></H2
 ><P
 > During installation, <SPAN
 CLASS="APPLICATION"
@@ -490,43 +487,30 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-MACOSX"
-></A
->5.7. Mac OSX</H2
+>5.6. Mac OS X</A
+></H2
 ><P
-> During installation, <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> is configured to
- start automatically when the system restarts.  To start <SPAN
-CLASS="APPLICATION"
->Privoxy</SPAN
-> manually,
- double-click on the <TT
-CLASS="LITERAL"
->StartPrivoxy.command</TT
-> icon in the
- <TT
-CLASS="LITERAL"
->/Library/Privoxy</TT
-> folder.  Or, type this command
- in the Terminal:</P
+>  After downloading the privoxy software, unzip the downloaded file by
+  double-clicking on the zip file icon.  Then, double-click on the
+  installer package icon and follow the installation process.</P
 ><P
->  <TABLE
-BORDER="0"
-BGCOLOR="#E0E0E0"
-WIDTH="100%"
-><TR
-><TD
-><PRE
-CLASS="SCREEN"
->  /Library/Privoxy/StartPrivoxy.command
-  </PRE
-></TD
-></TR
-></TABLE
-></P
+>  The privoxy service will automatically start after a successful
+  installation.  In addition, the privoxy service will automatically
+  start every time your computer starts up.</P
+><P
+>  To prevent the privoxy service from automatically starting when your
+  computer starts up, remove or rename the folder named
+  /Library/StartupItems/Privoxy.</P
 ><P
-> You will be prompted for the administrator password.</P
+>  A simple application named Privoxy Utility has been created which
+  enables administrators to easily start and stop the privoxy service.</P
+><P
+>  In addition, the Privoxy Utility presents a simple way for
+  administrators to edit the various privoxy config files.  A method
+  to uninstall the software is also available.</P
+><P
+>  An administrator username and password must be supplied in order for
+  the Privoxy Utility to perform any of the tasks.</P
 ></DIV
 ><DIV
 CLASS="SECT2"
@@ -534,8 +518,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-AMIGAOS"
-></A
->5.8. AmigaOS</H2
+>5.7. AmigaOS</A
+></H2
 ><P
 > Start <SPAN
 CLASS="APPLICATION"
@@ -566,8 +550,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="START-GENTOO"
-></A
->5.9. Gentoo</H2
+>5.8. Gentoo</A
+></H2
 ><P
 > A script is again used. It will use the file <TT
 CLASS="FILENAME"
@@ -622,8 +606,8 @@ CLASS="SECT2"
 CLASS="SECT2"
 ><A
 NAME="CMDOPTIONS"
-></A
->5.10. Command Line Options</H2
+>5.9. Command Line Options</A
+></H2
 ><P
 > <SPAN
 CLASS="APPLICATION"
@@ -686,7 +670,6 @@ CLASS="EMPHASIS"
 >--pidfile FILE</I
 ></SPAN
 >
-  
   </P
 ><P
 >   On startup, write the process ID to <SPAN
@@ -728,7 +711,6 @@ CLASS="EMPHASIS"
 >--user USER[.GROUP]</I
 ></SPAN
 >
-  
   </P
 ><P
 >   After (optionally) writing the PID file, assume the user  ID  of
@@ -751,7 +733,6 @@ CLASS="EMPHASIS"
 >--chroot</I
 ></SPAN
 >
-  
   </P
 ><P
 >   Before changing to the user ID given in the <SPAN
@@ -775,6 +756,29 @@ CLASS="APPLICATION"
 ></LI
 ><LI
 ><P
+>   <SPAN
+CLASS="emphasis"
+><I
+CLASS="EMPHASIS"
+>--pre-chroot-nslookup hostname</I
+></SPAN
+>
+  </P
+><P
+>   Specifies a hostname to look up before doing a chroot. On some systems, initializing the
+   resolver library involves reading config files from /etc and/or loading additional shared
+   libraries from /lib. On these systems, doing a hostname lookup before the chroot reduces
+   the number of files that must be copied into the chroot tree.
+  </P
+><P
+>   For fastest startup speed, a good value is a hostname that is not in /etc/hosts but that
+   your local name server (listed in /etc/resolv.conf) can resolve without recursion
+   (that is, without having to ask any other name servers). The hostname need not exist,
+   but if it doesn't, an error message (which can be ignored) will be output.
+  </P
+></LI
+><LI
+><P
 >    <SPAN
 CLASS="emphasis"
 ><I