readme

mini http server,可以集成嵌入到程序中,实现简单的web功能

Setup for Pi3Web
================

Setup
-----
Configure the server manually modifying the file Conf/Features.pi3 
(default) on UNIX systems. On Windows modify the file Conf\Config.pi3

The Windows 95/NT enhanced GUI (EnhPi3.exe) can be used to generate
and modify this file on Windows 95 or NT 4.0, see further instructions
below

Accessing the Web site from a browser
-------------------------------------
The URL for the browser will be

	http://<the host selected in configuration>:<port>/....

A web server installed with defaults can be accessed with

	http://localhost/

From a browser running on the machine where it was installed.

The windows enhanced GUI (EnhPi3.exe) provide hypertext links that you
can click on to bring up the default browser pointing at the home page.

Directories
-----------
bin          - binaries and administration scripts
Conf         - Configuration files
Cache        - Root of file cache for proxy server
Fragment     - Error messagesm Mime.typ file and miscellanious pieces
Icons        - Images and icons
Logs         - log files including pid.log 
Pi3Docs      - Documentation
Tests        - Test data
WebRoot      - Document root for primary virtual host
WebRoot2     - Document root for second virtual host
cgi-temp     - For temporary files created during execution (Window CGI)
devel        - Include files and examples for CGI and PiAPI programs
cgi-bin      - CGI programs
cgi-fcgi     - FastCGI programs
cgi-win      - Windows CGI programs
Isapi        - ISAPI (isa) DLL's

Running
-------
Pi3 can be started with the top level configuration file X.pi3 with

	Pi3 X.pi3

Typically the top level configuration file will be called 'Config.pi3' so
the Pi3Web server can be started with 

	Pi3 ..\Conf\Config.pi3

Windows platform can the command Pi3.exe, which supports exactly the same 
start line from a Command box. Additionally the program 

	Pi3Win32.exe ..\Conf\Config.pi3

Starts Pi3 as a simple windows GUI although EnhPi3.exe should be used 
instead.

EnhPi3.exe is the enhanced GUI for Windows 95 and NT 4.0, released
with 0.9 beta 4. Invoking it with no arguments will give usage information.
In summary

	EnhPi3.exe /start ..\Conf\Config.pi3
OR 	EnhPi3.exe ..\Conf\Config.pi3	will start the server defined
by the configuration file ..\Conf\Config.pi3

	EnhPi3.exe /admin ..\Conf\Config.pi3 starts the properties (or
server admin) to configure the server specified by the configuration file
..\Conf\Config.pi3

	EnhPi3.exe /uninstall ..\Conf\Config.pi3 remove registry entries
and fully uninstall the server defined by ..\Conf\Config.pi3

	EnhPi3.exe /setup ..\Conf\Config.pi3 brings up the Pi3Web setup
wizard to create the configuration file ..\Conf\Config.pi3. This option
can be used at any point to recreate a configuration which has become
corrupt or change between desktop and service mode (windows NT only).

Windows builds also contain the Pi3Srv32.exe binary, for use when Pi3Web
is installed as a service. This binary should not be started from the
command line, because it is start by the service control manager. When
invoked from the service control manager it uses as its configuration file
the file name 'Config.pi3' in the same directory as Pi3Srv32.exe

Uninstallation (Windows)
------------------------
Click the 'Uninstall' icon in the start menu or manually invoke
	EnhPi3.exe /uninstall ..\Conf\Config.pi3 from the Pi3Web
installation directory. 

The following Window uninstallation instructions apply only to older
versions or where EnhPi3.exe is not available or is not successful:

If Pi3Web was added as a service, first stop the service using the
service control manager (from control panel )or the script bin\Stop.bat.
Then use the Script bin\Remove.bat remove the service from the registry.

Delete the directory in which Pi3Web was installed. Typically 
this would be C:\Pi3Web. 

License
-------
Use and distribution of this package is governed by the conditions as
described in the file 'LICENSE', in the root directory of this package.
If this file is missing please refer to

    http://pi3web.sourceforge.net/license.htm

All trademarks as mentioned in documentation and source are property of
their respective owners.