"Fossies" - the Fresh Open Source Software Archive

Member "mod_ftp-0.9.6/README-FTP" (27 Aug 2009, 5205 Bytes) of package /linux/www/apache_httpd_modules/old/mod_ftp-0.9.6-beta.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 Unix Build Instructions
    2 -----------------------
    3 
    4 To build and install as a DSO outside of the httpd source
    5 build, from the ftp source root directory, simply;
    6 
    7     ./configure.apxs
    8     make
    9     make install
   10 
   11 If apxs is not in your path, or you are building to a different
   12 httpd installation, or your distribution has an alternate script
   13 name for apxs (e.g. apxs2), then either set the APXS environment
   14 variable, or use the syntax;
   15 
   16     APXS=/path/to/bin/apxs ./configure.apxs
   17 
   18 so the desired configuration is used.
   19 
   20 To build static, or as a DSO but within the same build as httpd,
   21 copy the entire ftp source directory tree on top of your existing 
   22 httpd source tree, and from the httpd source root directory
   23 
   24     ./buildconf  (to pick up ftp)
   25     ./configure --enable-ftp {your usual options}
   26 
   27 and proceed as usual.
   28 
   29 
   30 Win32 Build Instructions
   31 ------------------------
   32 
   33 The windows packages prior to 2.2.7 (or 2.0.62) left out the file
   34 include\mod_log_config.h, just copy these from the source tree
   35 or you can export them from subversion, just change to your
   36 installed Apache 2.2 (or 2.0) include subdirectory and...
   37 
   38   svn export http://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x/modules/loggers/mod_log_config.h
   39 
   40 (for your 2.0 installation, replace 2.2.x with 2.0.x in the
   41 command above).  You should be ready to compile the project.
   42 
   43 On windows, before building for httpd-2.0, you must adjust the
   44 two apr 1.x specific lines in modules\ftp\mod_ftp.dsp which begin
   45 
   46     # ADD LINK32 libapr-1.lib libaprutil-1.lib ...
   47 
   48 to start with the apr 0.9 equivilants for httpd-2.0,
   49 
   50     # ADD LINK32 libapr.lib libaprutil.lib ...
   51 
   52 To build on windows out-of-tree as a DSO, simply
   53 
   54     set APACHE2_HOME=c:\path\to\Apache2.2
   55 
   56 and then, for Visual Studio 6.0 (98)...
   57 
   58     msdev /useenv mod_ftp.dsw
   59 
   60 or for Visual Studio .NET (2002) and later ...
   61 
   62     devenv /useenv mod_ftp.dsw
   63 
   64 The later command is needed on Visual Studio .NET/2002 and later, 
   65 and converts mod_ftp.dsw to mod_ftp.sln.  So after converting once,
   66 use the newly converted solution instead...
   67 
   68     devenv /useenv mod_ftp.sln
   69 
   70 On windows you can overlay mod_ftp source files into the httpd source
   71 file tree, and make the following changes for an in-tree build;
   72 
   73  * Manually add the project mod_ftp.dsp to the Apache.dsw workspace.
   74  * Ensure the BuildBin project includes the mod_ftp project dependency.
   75  * Add mod_ftp project dependencies of libhttpd, libapr and libaprutil.
   76  * Remove /D "FTP_APXS_BUILD" from the # ADD CPP lines of
   77    modules\ftp\mod_ftp.dsp.
   78  * Replace /I "$(APACHE2_HOME)/include" with /I "../../modules/loggers" 
   79    for both # ADD CPP lines of modules\ftp\mod_ftp.dsp.
   80  * Remove the libraries libapr[-1].lib libaprutil[-1].lib libhttpd.lib 
   81    and the /libpath:"$(APACHE2_HOME)\lib" flag from the # ADD LINK32 
   82    lines of modules\ftp\mod_ftp.dsp.
   83 
   84 Note that mod_ftp.so needs to be added to the module installation 
   85 lines in Makefile.win, or you must manually copy the .so module from 
   86 modules\ftp\Release after compiling.
   87 
   88 
   89 NetWare Build Instructions
   90 --------------------------
   91 
   92 First, build httpd to get the processed headers and import files.
   93 
   94 To build for NetWare out-of-tree as a DSO, rename NWGNUftp-makefile
   95 to NWGNUmakefile, and set the same environment variables as used for 
   96 building httpd.  See the applicable platform notes;
   97 
   98   http://httpd.apache.org/docs/2.2/platform/netware.html#comp
   99   http://httpd.apache.org/docs/2.0/platform/netware.html#comp
  100 
  101 Then from the mod_ftp root directory to build the module, invoke:
  102 
  103     gmake -f NWGNUftp-makefile
  104 
  105 and finally:
  106 
  107     gmake -f NWGNUftp-makefile install
  108 
  109 to copy all files to the httpd distribution directory. This step also creates
  110 a sample config file in ./conf/extra.
  111 
  112 There is no advantage to building in-tree, therefore this is currently not
  113 supported.
  114 
  115 
  116 Documentation Build
  117 -------------------
  118 
  119 To regenerate the html.en documentation, here again it's as simple
  120 as copying the content docs/ into an httpd/docs/ tree and regenerating
  121 httpd's documentation.  However, it's also possible you are generating
  122 a local copy for reference in mod_ftp's tree, in that case you must
  123 have a copy of the httpd docs/manual/style.  For example;
  124 
  125     cd docs/manual
  126     svn co http://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x/docs/manual/style
  127 
  128 In either case;
  129 
  130     cd docs/manual
  131     svn co http://svn.apache.org/repos/asf/httpd/docs-build/trunk build
  132     cd build
  133 
  134 and finally;
  135 
  136     ./build.sh all
  137 
  138 or on windows...
  139 
  140     build.bat all
  141 
  142 To make this simpler on unix, after invoking ./configure.apxs in the 
  143 top level directory, you can simply;
  144 
  145     make generate-docs
  146 
  147 which will fetch up those style and build directories (for httpd-2.2)
  148 and generate the docs for you.  After using make and make install, you
  149 can even merge the directives for the installed manual using this target;  
  150 
  151     make manualdir=/path/to/httpd/manual generate-docs
  152 
  153 The same rules about an installed, locatable JAVA_HOME apply to building
  154 mod_ftp docs as apply to building the httpd manual.
  155 
  156 The advantage to building in-tree within httpd is that you gain the complete
  157 directive cross references applicable to all httpd and mod_ftp directives,
  158 before installing the httpd\manual files.
  159