Pileus Git - ~andy/fetchmail/blob - INSTALL

   1                 INSTALL Instructions for fetchmail
   2
   3 1. CONFIGURE
   4
   5 Installing fetchmail is easy.  From within this directory, type:
   6
   7         ./configure
   8
   9 The autoconfiguration script will spend a bit of time figuring out the
  10 specifics of your system.  If you want to specify a particular compiler
  11 (e.g. you have gcc but want to compile with cc), set the environment
  12 variable CC before you run configure.
  13
  14 The configure script accepts certain standard configuration options.
  15 These include --prefix, --exec-prefix, --bindir, --infodir, --mandir,
  16 and --srcdir.  Do `config --help' for more.
  17
  18 If you're running QNX, edit the distributed Makefile directly.  The
  19 QNX values for various macros are there but commented out; all you
  20 have to do is uncomment them.
  21
  22 2. MAKE
  23
  24 Next run
  25
  26         make
  27
  28 This will compile fetchmail for your system.  Note that in order to
  29 build it, you'll need either flex at version 2.5.3 org greater, or lex.
  30
  31 3. INSTALL
  32
  33 Lastly, become root and run
  34
  35         make install
  36
  37 This will install fetchmail.  By default, fetchmail will be installed
  38 in /usr/local/bin, with the man page in /usr/local/man/man1.  If you
  39 wish to change these defaults, edit the Makefile AFTER you run
  40 "configure" but BEFORE you run "make install."  You can easily choose
  41 a prefix other than /usr/local, or you can choose completely different
  42 directories for each item.
  43
  44 Note: if you intended to use RPOP (which we don't recommend, you
  45 should set up APOP), you'll have to make fetchmail suid root.  This
  46 is so it can call rresvport and bind to a privileged port, so the
  47 server's TCP/IP will see that and know it's OK to let it bind to
  48 a privileged port at the other end.
  49
  50 4. SET UP A RUN CONTROL FILE
  51
  52 See the man page or the file sample.rcfile for a description of how to
  53 configure your individual preferences.
  54
  55 Note: if you have been using popclient (the ancestor of this program)
  56 at version 3.0b6 or later, do this
  57
  58 (cd ~; mv ~/.poprc ~/.fetchmailrc)
  59
  60 in order to migrate.
  61
  62 5. TEST
  63
  64 I strongly recommend that your first fetchmail run use the -v and -k
  65 options, in case there is something not quite right with your local
  66 delivery configuration or your port 25 listener.  Also, beware
  67 of aliases that direct your local mail back to the server host!
  68
  69 6. USE IT
  70
  71 Enjoy!
  72