This is the documentation for the client program. It is the command line part of the HTML browser. The second part of the report can be found here.
-
Linux or Solaris
(Tested with Linux 2.2.13 and libc6)
-
pthread library
-
gcc or similar compiler (tested with egcs 2.91-66)
-
GNU make
-
libfl (from the flex package)
-
flex if you wish to remake the C-code for the lexical analyzers from the .lex files (usually not)
-
GNU autoconf if you want to remake the configure scripts
There are few things to do:
-
Change to the client directory
-
Type
./configure
to configure the source for your system. If configure reports any error, the source will very likely not build correctly. Please report bugs to the authors.
-
Type
make
at the command prompt. This should build the client executable in the client directory.
Optional: Call make clean
to delete all object files and auto-save files. make stat
outputs a little code statistics. You need the wc
program to use this.
-
In the rare case you should want to rebuild the flex analyser, call
flex -i img.lex
in the source directory and then
make clean; make
in the client directory.
The command line format to call client
is:
client get full-path-to-file destination-file port
Where
-
full-path-to-file
is the full URI, like
io.iupiter.universe/www/hund.html
.
-
destination-file
is the local file where the downloaded file is to be stored.
-
port
is the port number the server is running on. Usually, this is 80.
client mail mailfile
Where
-
mailfile
is a filename of a file of the following format:
First line: Recipient
Second line: Sender
Third line: mailer
Fourth line: port number on which the mailer accepts connections
The following lines contain the mail body, including ALL headers the sender wants to be sent (including sender and recipient headers).
If you download a HTML file, for example www.animals.org/dog/cat/mouse.html, it is stored in the given destination file AND in the cache subdirectory (which is specified in client/src/w3clientconfig.h). The HTML file is scanned for image tags and the corresponding images are downloaded and stored in the cache directory, in this example that could be
cache/www.animals.org/pictures/dog.gif
The HTML pages are stored flatly in cache/, e.g. as
cache/www.animals.org_index.html
The slashes are replaced by underscores. This CAN lead to clashes but that is neglected for this program. In a release version, another mechanism would have to be used.
Generated on Thu Jul 6 15:25:00 2006 for w3server by
1.4.6