Return-Path: Delivered-To: apmail-new-httpd-archive@apache.org Received: (qmail 25412 invoked by uid 500); 26 Jun 2001 23:12:30 -0000 Mailing-List: contact new-httpd-help@apache.org; run by ezmlm Precedence: bulk Reply-To: new-httpd@apache.org list-help: list-unsubscribe: list-post: Delivered-To: mailing list new-httpd@apache.org Received: (qmail 25158 invoked from network); 26 Jun 2001 23:12:20 -0000 Sender: harrie@lisanza.net Message-ID: <3B3916D1.DBB9486B@covalent.net> Date: Tue, 26 Jun 2001 16:12:17 -0700 From: Harrie Hazewinkel Organization: Covalent Technologies X-Mailer: Mozilla 4.73 [en] (X11; I; FreeBSD 4.1-RELEASE i386) X-Accept-Language: en MIME-Version: 1.0 To: Apache Development Subject: [PATCH] modules documentation Content-Type: multipart/mixed; boundary="------------F77F6AC4ADB018F0F2C3347F" X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N This is a multi-part message in MIME format. --------------F77F6AC4ADB018F0F2C3347F Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Hi, Attached is a not applied patch that I already submitted a while ago. It fixes some of the documentation on how to port the modules. -- address: Covalent Technologies, 645 Howard St, San Francisco, CA - 94105 phone: +1-415-536-5221 fax:+1-415-536-5210 personal website: http://www.lisanza.net/ --------------F77F6AC4ADB018F0F2C3347F Content-Type: text/html; charset=us-ascii; name="modules-doc.patch" Content-Transfer-Encoding: 7bit Content-Disposition: inline; filename="modules-doc.patch" --- ../developer-orig/modules.html Mon Apr 16 11:21:42 2001 +++ docs/manual/developer/modules.html Mon Apr 16 12:13:00 2001 @@ -35,20 +35,20 @@ These should now be renamed to better signify where they sit in the overall process. So the name gets a small change from mmap_init to mmap_post_config. The arguments passed have undergone a radical change and now look like

    -
  • ap_context_t *p,
    • -
  • ap_context_t *plog,
    • -
  • ap_context_t *ptemp,
    • +
  • apr_pools_t *p,
    • +
  • apr_pools_t *plog,
    • +
  • apr_pools_t *ptemp,
  • server_rec *s

-Throughout Apache the old pools have been replced by the ap_context_t, though their use remains remarkably similar. +Throughout Apache the old pools have been replced by the apr_pools_t, though their use remains remarkably similar.

Data Types

A lot of the data types have been moved into the APR. This means that some have had a name change, such as the one shown above. The following is a brief list of some of the changes that you are likely to have to make.

    -
  • pool becomes ap_context_t
    • +
  • pool becomes apr_pools_t
  • table becomes ap_table_t
@@ -171,26 +171,65 @@ ap_hook_post_config (this is where the old _init routines get registered)
  • -ap_hook_http_method +ap_hook_http_method (retrieve the http method from a request. (legacy))
  • -ap_hook_open_logs +ap_hook_open_logs (open any specified logs)
  • -ap_hook_auth_checker +ap_hook_auth_checker (check if the resource requires authorization)
  • -ap_hook_default_port +ap_hook_access_checker (check for module-specific restrictions)
  • -ap_hook_access_checker +ap_hook_check_user_id (check the user-id and password)
  • -ap_hook_process_connection +ap_hook_default_port (retrieve the default port for the server)
  • -ap_hook_child_init_hook +ap_hook_pre_connection (do any setup required just before processing, but after accepting)
    • +
  • +ap_hook_process_connection (run the correct protocol) +
    • +
  • +ap_hook_child_init (call as soon as the child is started) +
    • +
  • +ap_hook_create_request (??) +
    • +
  • +ap_hook_fixups (last chance to modify things before generating content) +
    • +
  • +ap_hook_handler (generate the content) +
    • +
  • +ap_hook_header_parser (let's modules look at the headers, not used by most modules, because they use post_read_request for this.) +
    • +
  • +ap_hook_insert_filter (to insert filters into the filter chain) +
    • +
  • +ap_hook_log_transaction (log information about the request) +
    • +
  • +ap_hook_optional_fn_retrieve (retrieve any functions registered as optional) +
    • +
  • +ap_hook_post_read_request (called after reading the request, before any other phase) +
    • +
  • +ap_hook_quick_handler (??) +
    • +
  • +ap_hook_translate_name (translate the URI into a filename) +
    • +
  • +ap_hook_type_checker (determine and/or set the doc type) + --------------F77F6AC4ADB018F0F2C3347F--