contrib/lukemftp/INSTALL

   1 INSTALLATION INTRODUCTION
   2 -------------------------
   3
   4 This file describes how to compile and install lukemftp on your
   5 system.
   6
   7         ============================================
   8         =                                          =
   9         =  NOTE: You will need an ANSI C compiler. =
  10         =                                          =
  11         ============================================
  12
  13
  14 For most systems, execute the following to compile and install
  15 lukemftp:
  16         ./configure
  17         make
  18         make install
  19
  20 A preformatted manual page (src/ftp.cat1) is also installed. If
  21 you wish to install the source (src/ftp.1), ensure that your system
  22 has up-to-date mandoc macros. groff ships with this macro suite,
  23 but it has bugs. Try:
  24     ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/src/share/tmac/
  25 for a more recent version.
  26
  27
  28 CONFIGURATION OPTIONS
  29 ---------------------
  30
  31 lukemftp is configured using an `autoconf' generated `configure'
  32 script.  `configure' supports the following options:
  33
  34 * The standard `autoconf configure' options, including:
  35   --prefix=PREFIX         install architecture-independent files in PREFIX
  36                           [/usr/local]
  37   --exec-prefix=EPREFIX   install architecture-dependent files in EPREFIX
  38                           [same as prefix]
  39   --srcdir=DIR            find the sources in DIR [configure dir or ..]
  40                           BSD or GNU make may be required for this to work.
  41
  42 * Specific options:
  43   --enable-editcomplete   Turn on command line editing and completion.
  44   --disable-editcomplete  Turn off command line editing and completion
  45                           [default: enabled].
  46   --enable-ipv6           Enable IPv6 support (if your OS supports it)
  47   --disable-ipv6          Disable IPv6 support (even if your OS supports it.)
  48                           [default: enabled].
  49   --with-socks            Compile with SOCKS firewall traversal support.
  50   --with-socks5[=PATH]    Compile with SOCKS5 firewall traversal support.
  51   --with-socks4[=PATH]    Compile with SOCKS4 firewall traversal support.
  52
  53 The following environment variables can be set to override various
  54 compiler related settings.
  55   CC=compiler           specify name of the C compiler (default: gcc or cc)
  56   CFLAGS=flags          specify flags to C compiler (default: -O -g or just -O)
  57   LDFLAGS=flags         specify flags to linker (default: none)
  58
  59 This can be achieved with:
  60         env CC="compiler" CFLAGS="flags" LDFLAGS="flags" ./configure
  61
  62
  63         ============================================
  64         =                                          =
  65         =  NOTE: You will need an ANSI C compiler. =
  66         =                                          =
  67         ============================================
  68
  69
  70 PLATFORM SPECIFIC NOTES
  71 -----------------------
  72
  73 The following platforms & compilers have been tested:
  74
  75 - AIX 4.1.5:
  76 - AIX 4.2.1:
  77 - AIX 4.3.3:
  78         - Compiler: xlc -qlanglvl=ansi
  79            version: xlC 3.1.4.10 -- C for AIX Compiler
  80            version: ibmcxx.cmp 3.6.6.6 -- IBM C and C++ Compilers
  81
  82           Configure with:
  83                 env CC="xlc" CFLAGS="-qlanglvl=ansi" ./configure
  84
  85 - BSD/OS 4.0.1 (x86)
  86 - BSD/OS 4.1 (x86)
  87 - BSD/OS 4.1 (sparc)
  88 - BSD/OS 4.2 (x86)
  89         - Compiler: /bin/cc
  90            version: gcc 2.7.2.1
  91            version: gcc version 2.95.2 19991024
  92
  93 - Digital UNIX 4.0b
  94 - Digital UNIX 4.0d
  95 - Digital UNIX 4.0f
  96         - Compiler: cc -std
  97            version: DEC C V5.2-036 on Digital UNIX V4.0 (Rev. 564)
  98            version: DEC C V5.9-005 on Digital UNIX V4.0 (Rev. 1229)
  99
 100           Configure with
 101                 env CC="cc -std" ./configure
 102
 103         - Compiler: gcc
 104            version: 2.95.1
 105
 106 - Digital UNIX 5.0
 107         - Compiler: cc
 108            version: Compaq C V6.1-011 on Digital UNIX V5.0 (Rev. 910)
 109
 110 - FreeBSD 3.4 (i386):
 111 - FreeBSD 3.5 (i386):
 112 - FreeBSD 4.1 (i386):
 113         - Compiler: cc
 114            version: gcc version 2.7.2.3
 115            version: gcc version 2.95.2 19991024
 116
 117 - HP/UX 10.20:
 118 - HP/UX 11.00:
 119         - Compiler: /opt/ansic/bin/cc -Ae
 120            version: A.10.32.03
 121
 122           Configure with
 123                 env CC="cc -Ae" ./configure
 124
 125           To generate code that will run on old architectures you
 126           may need to add "+DAportable" to CC.
 127
 128
 129 - IRIX 6.5.4
 130 - IRIX 6.5.8
 131         Compiler: /bin/cc
 132          version: MIPSpro Compilers: Version 7.2.1
 133         Compiler:
 134          version: gcc version 2.95.2
 135
 136 - HP/UX 11.00:
 137 - HP/UX 11.00 64 bit:
 138         - Compiler: /opt/ansic/bin/cc -Ae
 139            version: A.11.01.00
 140
 141           Configure with
 142                 env CC="cc -Ae" ./configure
 143
 144 - NetBSD 1.3.3 (i386)
 145         Compiler: /usr/bin/cc
 146         Compiler: /usr/bin/cc
 147
 148         Ignore warnings about ``passing arg 3 of `tputs' from
 149         incompatible pointer type''.
 150
 151 - RedHat Linux 5.1 (?? i386)
 152 - RedHat Linux 5.2 (?? i386)
 153 - RedHat Linux 6.0 (Linux 2.2.10 i686)
 154 - RedHat Linux 6.1 (Linux 2.2.5-15 i686)
 155 - RedHat Linux 6.2 (Linux 2.2.16-3smp i686)
 156         - Compiler: cc
 157            version: egcs-1.1.2
 158
 159 - Slackware (Linux 2.0.35 i686)
 160         - Compiler: cc
 161            version: 2.7.2.3
 162
 163 - Solaris 2.6 (sparc)
 164 - Solaris 7 (sparc)
 165         - Compiler: /opt/SUNWspro/bin/cc
 166            version: WorkShop Compilers 5.0
 167
 168         - Compiler: gcc
 169            version: egcs-1.1.2
 170
 171 =============
 172 = OLD NOTES =
 173 =============
 174
 175 XXX: clean up to match reality
 176 ------------------------------
 177
 178 - RedHat Linux 5.0 (i386)
 179         Compiler: cc
 180
 181 - Solaris 2.5 (sparc)
 182 - Solaris 7 (x86)
 183         Compiler: /opt/SUNWspro/bin/cc
 184          version: SC3.0 15 Dec 1993
 185          version: WorkShop Compilers 5.0
 186         Compiler: gcc
 187          version: egcs-1.1.2
 188          version: gcc 2.8.1
 189          version: gcc 2.95.1
 190
 191 - Solaris 7 (sparc) 64 bit
 192         Compiler: /opt/SUNWspro/bin/cc -xarch=v9
 193          version: WorkShop Compilers 5.0
 194
 195 - SunOS 4
 196         Compiler: gcc -lresolv
 197          version:
 198
 199 - SuSE Linux
 200         Compiler: gcc
 201          version:
 202
 203         /usr/bin/ftp on SuSE Linux 6.4 is this ftp client.
 204
 205         May need `gcc -L/usr/lib/termcap' if tgetent() et al aren't found.
 206
 207 - Ultrix 4.5
 208         Compiler: cc
 209          version: MIPS C Compiler 3.0
 210         Compiler: gcc
 211          version: 2.7.2.2