"Fossies" - the Fresh Open Source Software Archive 
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