From 502012458afaeaec66877da90ec4f6b2305ca2dc Mon Sep 17 00:00:00 2001 From: hal9 Date: Wed, 25 Sep 2002 01:32:15 +0000 Subject: [PATCH] Newly generated with new additions for new make install, with various improvements. --- INSTALL | 99 +++++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 68 insertions(+), 31 deletions(-) diff --git a/INSTALL b/INSTALL index 25a10fbb..20c185a2 100644 --- a/INSTALL +++ b/INSTALL @@ -1,7 +1,38 @@ -########## PRIVOXY INSTALL ############# - -For more info after the install, configure and use refer to the README in the -same dir as the INSTALL +/********************************************************************* + * + * File : $Source: /cvsroot/ijbswa/current/doc/source/install.sgml,v $ + * + * Purpose : INSTALL file to help with installing from source. + * + * Copyright : Written by and Copyright (C) 2001,2002 the SourceForge + * Privoxy team. http://www.privoxy.org/ + * + * Based on the Internet Junkbuster originally written + * by and Copyright (C) 1997 Anonymous Coders and + * Junkbusters Corporation. http://www.junkbusters.com + * + * This program is free software; you can redistribute it + * and/or modify it under the terms of the GNU General + * Public License as published by the Free Software + * Foundation; either version 2 of the License, or (at + * your option) any later version. + * + * This program is distributed in the hope that it will + * be useful, but WITHOUT ANY WARRANTY; without even the + * implied warranty of MERCHANTABILITY or FITNESS FOR A + * PARTICULAR PURPOSE. See the GNU General Public + * License for more details. + * + * The GNU General Public License should be included with + * this file. If not, you can view it at + * http://www.gnu.org/copyleft/gpl.html + * or write to the Free Software Foundation, Inc., 59 + * Temple Place - Suite 330, Boston, MA 02111-1307, USA. + * + *********************************************************************/ + + +------------------------------------------------------------------------------- To build Privoxy from source, autoconf, GNU make (gmake), and, of course, a C compiler like gcc are required. @@ -23,60 +54,66 @@ tested. To download CVS source: This will create a directory named current/, which will contain the source tree. -you can too check any privoxy branch, just change the "current" name with the -wanted branch name (Example: v_3_0_branch for the 3.0 cvs tree) - -you should create the user and group that privoxy will run, the default is -"privoxy" for both +You can also check out any Privoxy "branch", just exchange the current name +with the wanted branch name (Example: v_3_0_branch for the 3.0 cvs tree). -you can change the user and group with --with-user= and --with-group= in the -./configure step +It is also recommended to not run Privoxy as root, and instead it is suggested +to create a "privoxy" user for this purpose. -the user and group should have the login disabled for better safety +/etc/passwd might then look like: -here is my /etc/passwd entry + privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell -privoxy:*:7777:7777:privoxy proxy:/no/home:/no/shell +And then /etc/group, like: -and my /etc/group entry + privoxy:*:7777:privoxy -privoxy:*:7777:privoxy +Some binary packages may do this for you. -Then, in either case, to build from unpacked tarball or CVS source: +Then, to build from either unpacked tarball or CVS source: autoheader autoconf - ./configure # (--help to see options, see the warning below) + ./configure # (--help to see options) make # (the make from gnu, gmake for *BSD) su make -n install # (to see where all the files will go) make install # (to really install) -If you have gnu make, you can have the first four steps automatically done for +If you have GNU make, you can have the first four steps automatically done for you by just typing: - make + make in the freshly downloaded or unpacked source directory. -** WARNING ** - -1- if you are installing in /usr/local or / (root) the use of +The default installation path for make install is /usr/local. This may of +course be customized with the various ./configure path options. configure also +accepts a --with-user and --with-group options for setting user and group +ownership. - --sysconfdir=$prefix/etc/privoxy +If you do install to /usr/local, the install will use sysconfdir=$prefix/etc/ +privoxy by default. All other destinations, and the direct usage of +--sysconfdir flag behave like normal, i.e. will not add the extra privoxy +directory. This is for a safer install, as there may already exist another +program that uses a file with the "config" name, and thus makes /usr/local/etc +cleaner. -is recommended for a safer (there may already exist other program that uses a -file with the "config" name) and cleaner and easier to use etc dir +If installing to /usr/local, the docs will go by default to $prefix/share/doc. +But if this directory doesn't exist, it will then try $prefix/doc and install +there before creating a new $prefix/share/doc just for Privoxy. -2- for user install dont forget to give the --with-user and --with-group equal -to the current user or tune things later +Again, if the installs goes to /usr/local, the localstatedir (ie: var/) will +default to /var instead of $prefix/var so the logs will go to /var/log/privoxy +/, and the pid file will be created in /var/run/privoxy.pid. -** END OF WARNING ** +make install will attempt to set the correct values in config (main +configuration file). If appropriate, an init script will be installed, but it +is up to the user to determine how and where to start Privoxy. For more detailed instructions on how to build Redhat and SuSE RPMs, Windows self-extracting installers, building on platforms with special requirements etc, please consult the developer manual. -For binary RPM installation, and other platforms, see the user-manual as well. +For binary RPM installation, and other platforms, see the User Manual as well. -Now go read the README to learn what should you do next -- 2.39.2