sjero.net Git - wget/blob - INSTALL

   1                                                                    -*- text -*-
   2                         Installation Procedure
   3
   4 0) Preparation
   5
   6 To build and install GNU Wget, you need to unpack the archive (which
   7 you have presumably done, since you are reading this), and read on.
   8 Like most GNU utilities, Wget uses the GNU Autoconf mechanism for
   9 build and installation; those of you familiar with compiling GNU
  10 software will feel at home.
  11
  12 1) Configuration
  13
  14 To configure Wget, run the configure script provided with the
  15 distribution.  You may use all the standard arguments configure
  16 scripts take.  The most important ones are:
  17
  18   --help                  print help message
  19
  20   --prefix=PREFIX         install architecture-independent files in PREFIX
  21                           (/usr/local by default)
  22   --bindir=DIR            user executables in DIR (PREFIX/bin)
  23   --infodir=DIR           info documentation in DIR [PREFIX/info]
  24   --mandir=DIR            man documentation in DIR [PREFIX/man]
  25
  26   --build=BUILD           configure for building on BUILD [BUILD=HOST]
  27   --host=HOST             configure for HOST [guessed]
  28   --target=TARGET         configure for TARGET [TARGET=HOST]
  29
  30 --enable and --with options recognized (mostly Wget-specific):
  31   --with-ssl[=SSL_ROOT]   link with libssl [in SSL_ROOT/lib] for https: support
  32   --disable-opie          disable support for opie or s/key FTP login
  33   --disable-digest        disable support for HTTP digest authorization
  34   --disable-ntlm          disable support for HTTP NTLM authorization
  35   --disable-debug         disable support for debugging output
  36   --disable-nls           do not use Native Language Support
  37   --disable-largefile     omit support for large files
  38   --disable-ipv6          disable IPv6 support
  39
  40 So, if you want to configure Wget for installation in your home
  41 directory, you can type:
  42
  43     ./configure --prefix=$HOME
  44
  45 You can customize many default settings by editing Makefile and
  46 config.h.  The program will work very well without your touching these
  47 files, but it is useful to have a look at things you can change there.
  48
  49 If you have OpenSSL libraries installed in one of the default
  50 directories, such as /usr/local/lib or /usr/local/ssl/lib, you can
  51 simply `configure --with-ssl'.  If you have it installed elsewhere,
  52 you need to specify your alternate OpenSSL root directory.  For
  53 instance, if libcrypto.* and libssl.* are in /opt/openssl/lib, you
  54 need to `configure --with-ssl=/opt/openssl'.
  55
  56 To configure Wget on Windows, read the instructions in
  57 `windows/README'. If this doesn't work for any reason, talk to the
  58 Windows developers listed there; I do not maintain the port.  That
  59 does not apply to the "Cygwin" environment, where Wget should compile
  60 out of the box as described here.
  61
  62 2) Compilation
  63
  64 To compile the program, type make and cross your fingers.  If you do
  65 not have an ANSI compiler, Wget will try to KNR-ize its sources "on
  66 the fly".  This should make GNU Wget compilable on almost any
  67 Unix-like system out there.
  68
  69 After the compilation a ready to use `wget' executable should reside
  70 in the src directory.  I do not have any kind of test-suite as of this
  71 moment, but it should be easy enough to test whether the basic stuff
  72 works.
  73
  74 3) Installation
  75
  76 Use `make install' to install GNU Wget to directories specified to
  77 configure.  The standard prefix is "/usr/local/", which can be changed
  78 using the `--prefix' configure option.
  79
  80 The installation process will copy the wget binary to $PREFIX/bin,
  81 install the wget.info* info pages to $PREFIX/info, the autogenerated
  82 manual page (where available) wget.1 to $PREFIX/man/man1, and the
  83 default config file to $PREFIX/etc, unless a config file already
  84 exists there.  You can customize these directories either through the
  85 configuration process or making the necessary changes in the Makefile.
  86
  87 To delete the files created by Wget installation, you can use make
  88 uninstall.