src - OpenBSD base system

diff options


context:
space:
mode:

author	Bob Beck <beck@cvs.openbsd.org>	1999-03-01 01:17:53 +0000
committer	Bob Beck <beck@cvs.openbsd.org>	1999-03-01 01:17:53 +0000
commit	5efc6240898ea7182310ebc32528b94c69283464 (patch)
tree	d6a276e93bd25bb083c415f0e5fdc806f53051d3
parent	5e9b927491680aa1d931a0fce0e01c7a47f0ffa0 (diff)

import apache 1.3.26 + mod_ssl 2.8.10

Diffstat

-rw-r--r--

usr.sbin/httpd/htdocs/manual/readme-tpf.html

206

1 files changed, 206 insertions, 0 deletions

diff --git a/usr.sbin/httpd/htdocs/manual/readme-tpf.html b/usr.sbin/httpd/htdocs/manual/readme-tpf.html
new file mode 100644
index 00000000000..2e9161b1aa9
--- /dev/null
+++ b/usr.sbin/httpd/htdocs/manual/readme-tpf.html

@@ -0,0 +1,206 @@

+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">

+<HTML>

+<HEAD>

+<TITLE>The Apache TPF Port</TITLE>

+</HEAD>

+<BODY>

+<A NAME="top"></A>

+<H1 align="center">Overview of the Apache TPF Port</H1>

+<HR>

+<CENTER>[ <A HREF="#configuration_files">Configuration Files</A>

+  | <A HREF="#auto_generated_files">Auto Generated Files</A>

+  | <A HREF="#whats_available">What's Available</A>

+  | <A HREF="#porting_notes">Porting Notes</A> ]

+</CENTER>

+<HR>

+<BR>

+<P>

+ This version of Apache includes changes allowing it to run on

+ IBM's EBCDIC-based

+ <A HREF="http://www.s390.ibm.com/products/tpf/tpfhp.html">TPF</A>

+ (Transaction Processing Facility) operating system.

+ Unless otherwise noted TPF version 4.1 PUT08 and APAR PJ25589 are required.

+ <BR><BR>

+ Refer to htdocs/manual/<A HREF="install-tpf.html">install-tpf.html</A>

+ for step-by-step installation instructions.

+ <BR><BR>

+ As this is the first cut at making Apache run on TPF,

+ performance tuning has not been done.

+ <BR><BR>

+ This port builds upon the <A HREF="ebcdic.html">EBCDIC changes</A>

+ previously made to Apache.

+ <BR>

+</P>

+<A NAME="configuration_files"> </A>

+<H2 align=center>Apache Configuration Files</H2>

+<P>

+ The distributed configuration files (httpd.conf-dist and

+ mime.types, both located in the conf subdirectory)

+ work on TPF with only a couple of operating system specific changes

+ to httpd.conf:<BR>

+ <UL>

+ <LI>ServerType needs to be "inetd" since TPF does not yet support

+ "standalone" mode.

+ <LI>Performance considerations may dictate setting KeepAlive to "Off"

+ (the default is "On") or lowering the Timeout value from the default

+ 300 seconds (5 minutes) in order to reduce the number of active ECBs on your system.

+ </UL>

+</P>

+<A NAME="whats_available"> </A>

+<H2 align=center>What's Available in this Version</H2>

+ (The Apache organization provides

+ <A HREF="http://www.apache.org/docs/">online documentation</A>

+ describing the various modules and components of the server.)

+<H3>Components/modules tested on TPF:</H3>

+ <multicol COLS=3><UL>

+ <LI>alloc.c

+ <LI>ap_cpystrn.c

+ <LI>ap_fnmatch.c

+ <LI>ap_signal.c

+ <LI>ap_slack.c

+ <LI>ap_snprintf.c

+ <LI>buff.c

+ <LI>buildmark.c

+ <LI>ebcdic.c

+ <LI>http_config.c

+ <LI>http_core.c

+ <LI>http_log.c

+ <LI>http_main.c

+ <LI>http_protocol.c

+ <LI>http_request.c

+ <LI>http_vhost.c <A HREF="#note_2">*</A>

+ <LI>mod_access.c

+ <LI>mod_alias.c

+ <LI>mod_asis.c

+ <LI>mod_autoindex.c

+ <LI>mod_cern_meta.c

+ <LI>mod_dir.c

+ <LI>mod_example.c

+ <LI>mod_expires.c

+ <LI>mod_headers.c

+ <LI>mod_imap.c

+ <LI>mod_info.c

+ <LI>mod_log_agent.c

+ <LI>mod_log_config.c

+ <LI>mod_log_referer.c

+ <LI>mod_mime.c

+ <LI>mod_negotiation.c

+ <LI>mod_setenvif.c

+ <LI>mod_speling.c

+ <LI>mod_userdir.c

+ <LI>mod_usertrack.c

+ <LI>os.c

+ <LI>os-inline.c

+ <LI>regular expression parser

+ <LI>util.c

+ <LI>util_date.c

+ <LI>util_uri.c

+ </UL></MULTICOL>

+ Please keep in mind that some major pieces are not yet in place including

+ standalone mode, pipes, password/group files, CGI scripts, and MD5 support.

+ <BR>

+ <A NAME="note_2"> </A>

+ <BR>

+ * virtual hosting requires TPF version 4.1 PUT09

+<H3>Components/modules not (yet?) supported on TPF:</H3>

+ <multicol COLS=3><UL>

+ <LI>htpasswd.c

+ <LI>md5c.c

+ <LI>mod_actions.c

+ <LI>mod_auth.c

+ <LI>mod_auth_anon.c

+ <LI>mod_cgi.c

+ <LI>mod_digest.c

+ <LI>mod_env.c

+ <LI>mod_include.c

+ <LI>mod_mime_magic.c

+ <LI>mod_proxy.c

+ <LI>mod_rewrite.c

+ <LI>mod_status.c

+ <LI>mod_unique_id.c

+ <LI>proxy_cache.c

+ <LI>proxy_connect.c

+ <LI>proxy_ftp.c

+ <LI>proxy_http.c

+ <LI>proxy_util.c

+ <LI>rfc1413.c

+ <LI>util_md5.c

+ <LI>util_script.c

+ </UL></MULTICOL>

+<H3>Components/modules that don't apply or that probably won't ever be available on TPF:</H3>

+ <multicol COLS=3><UL>

+ <LI>gen_test.char.c

+ <LI>gen_uri_delims.c

+ <LI>mod_auth_db.c

+ <LI>mod_auth_dbm.c

+ <LI>mod_auth_db.module

+ <LI>mod_mmap_static.c

+ <LI>mod_so.c

+ </UL></MULTICOL>

+<A NAME="porting_notes"> </A>

+<H2 align=center>Porting Notes</H2>

+<P>

+ <H3>Changes made due to differences between UNIX and

+ TPF's process models:</H3>

+ <UL>

+ <LI><STRONG>Signals</STRONG>: On TPF a signal that is sent to a process

+ remains unhandled until the process explicitly requests that signals

+ be handled using the <CODE>tpf_process_signals()</CODE> function.

+ Additionally, the default action for an alarm on TPF is to take

+ an OPR-7777 dump and exit. (On UNIX the default is the equivalent

+ of <CODE>exit()</CODE> with no dump taken.)

+ These differences necessitated a few modifications:

+ <BR><BR>

+ <UL>

+ <LI>bypass the use of <CODE>ap_block_alarms()</CODE> &

+ <CODE>ap_unblock_alarms()</CODE>

+ <LI>add <CODE>tpf_process_signals()</CODE> calls

+ <LI>add <CODE>select()</CODE> calls in buff.c to prevent blocking.

+ </UL>

+ <BR>

+ </UL>

+ <H3>Find that function...</H3>

+ <P>Some simple functions & definitions needed to be added

+ on TPF, such as <CODE>FD_SET()</CODE>.

+ We've put these in src/os/tpf/os.h for now.

+ </P>

+ <H3>EBCDIC changes:</H3>

+ <P>TPF-specific conversion tables between US-ASCII and

+ EBCDIC (character set IBM-1047 to be exact) were created

+ and put into ebcdic.c in the src/os/tpf directory.

+ </P>

+ <H3>Miscellaneous, minor changes:</H3>

+ <P>Various minor changes (such as casting) were made due to

+ differences in how some functions are implemented on TPF.

+ </P>

+ <H3>Temporary changes:</H3>

+ <P>Lastly, we needed to bypass sections of Apache processing

+ since this first cut for TPF doesn't include

+ Standalone mode, pipes, forking, et cetera.

+ </P>

+<HR>

+<CENTER>[ <A HREF="#top">top</A>

+  | <A HREF="#configuration_files">Configuration Files</A>

+  | <A HREF="#auto_generated_files">Auto Generated Files</A>

+  | <A HREF="#whats_available">What's Available</A>

+  | <A HREF="#porting_notes">Porting Notes</A> ]

+</CENTER>

+</BODY>

+</HTML>