Return-Path: Delivered-To: apmail-httpd-docs-archive@httpd.apache.org Received: (qmail 81036 invoked by uid 500); 18 Jun 2002 23:23:06 -0000 Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: list-post: Reply-To: docs@httpd.apache.org Delivered-To: mailing list docs@httpd.apache.org Received: (qmail 81015 invoked by uid 500); 18 Jun 2002 23:23:06 -0000 Delivered-To: apmail-apache-docs@apache.org Delivered-To: apmail-httpd-docs-1.3-cvs@apache.org Date: 18 Jun 2002 23:23:05 -0000 Message-ID: <20020618232305.52192.qmail@icarus.apache.org> From: mccreedy@apache.org To: httpd-docs-1.3-cvs@apache.org Subject: cvs commit: httpd-docs-1.3/htdocs/manual install-tpf.html readme-tpf.html X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N mccreedy 2002/06/18 16:23:05 Modified: htdocs/manual install-tpf.html readme-tpf.html Log: Update TPF documentation with examples for SyslogD and Apache flags. Revision Changes Path 1.18 +25 -0 httpd-docs-1.3/htdocs/manual/install-tpf.html Index: install-tpf.html =================================================================== RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/install-tpf.html,v retrieving revision 1.17 retrieving revision 1.18 diff -u -r1.17 -r1.18 --- install-tpf.html 19 May 2002 05:03:30 -0000 1.17 +++ install-tpf.html 18 Jun 2002 23:23:05 -0000 1.18 @@ -287,6 +287,31 @@ shutdown of Apache.

+ +
  • + Indicate if you have the Syslog Daemon message logging facility. + +

    If you are on a PUT13 or higher system, or have PJ27214 installed, + you can use syslog for Apache's ErrorLog.
    + To have the option of using syslog you must do one of the following:
    +

    + +
      +
    • add "#define HAVE_SYSLOG" to + src/os/tpf/os.h   or
      • + +
    • add "-DHAVE_SYSLOG" to the + _C89_OPTIONS export in src/os/tpf/TPFExport
      • + +
    +
    + +

    You also need to add "INCLUDE OBJLIB(CSYLOG40)" to your link JCL.

    +

    See TPF Transmission Control Protocol/Internet Protocol for more information + about the Syslog Daemon: + http://www.ibm.com/tpf/pubs/tpfpubs.htm.

    +
    • +
  • Indicate if you would like to use the TCP/IP network services database. (This only applies if you are using TCP/IP native stack.) 1.13 +171 -66 httpd-docs-1.3/htdocs/manual/readme-tpf.html Index: readme-tpf.html =================================================================== RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/readme-tpf.html,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- readme-tpf.html 29 Mar 2002 19:05:54 -0000 1.12 +++ readme-tpf.html 18 Jun 2002 23:23:05 -0000 1.13 @@ -17,11 +17,12 @@
    - [ Configuration - Files  | What's - Available  | CGI Scripts  | - Options  | Porting Notes  ] + [ Configuration Files  + | What's Available  + | CGI Scripts  + | Options  + | Syslog  + | Porting Notes  ]
    @@ -207,6 +208,9 @@
  • rotatelogs.c (requires PUT10; if PJ27214 implemented be sure to apply PJ28367) 
    • +
  • syslog (requires PUT13; see install + and usage instructions) 
    • +
  • util.c 
  • util_date.c 
    • @@ -225,6 +229,8 @@
  • lib/expat-lite 
    • +
  • lib/sdbm 
    • +
  • mod_auth_digest.c 
  • mod_rewrite.c 
    • @@ -350,65 +356,106 @@
    -

    How to Use Apache Command Line Options

    +

    How to Use Apache's "Dash" Options

    -

    You cannot run Apache from the command line on TPF. However - you can use those Apache command line options which don't - actually start the server. This requires PJ27277 which shipped - on PUT13.

    +

    Overview of Apache's "dash" options:

    + +

    Apache can be invoked with various options, such as "-f". + Some of these options display information about the server or perform syntax checks + but they don't actually start the server. + These "information only" options are useful with TPF's ZFILE command line feature: + -h, -l, -L, -S, -t, -T, -v, and -V. +

    + +

    Another option, -X, is used when actually running the server. + It is passed to Apache through the ZINET XPARM field since ZINET is the only way to start the server on TPF.

    + +

    A third group of options apply to both the informational displays (ZFILE) and + running the server (ZINET XPARM): -d, -D and -f.

    + +

    The rest of Apache's options are either not applicable or are not supported on TPF.

    -

    Supported Apache options:

    +

    Using dash options requires PJ27277 which shipped on PUT13.

    + +

    Table of supported Apache options

    -

    -d directory
    - Specify an alternate initial ServerRoot directory. - Default is /usr/local/apache.

    - -

    -f file
    - Specify an alternate server configuration file. - Default is conf/httpd.conf.

    - -

    -h
    - List a short summary of available command line options. - (Note that this outputs all options, not just those supported - on TPF.)

    - -

    -l
    - List modules compiled into the server.

    - -

    -L
    - List available configuration directives. (Note that this - outputs all configuration directives, not just those - supported on TPF.)

    - -

    -S
    - Show the settings as parsed from the configuration file. - Currently only shows the virtualhost settings.

    - -

    -t
    - Run syntax tests for configuration files (with document root - checks)

    - -

    -T
    - Run syntax tests for configuration files (without document - root checks)

    - -

    -v
    - Show the version number.

    - -

    -V
    - Show the version number and various compile settings.

    - -

    See http://httpd.apache.org/docs/programs/httpd.html - for more information about these command line options.

    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Option + ZFILEZINET + Description
    -d pathZFILEZINETSet the initial value for the ServerRoot directive.
    -D defineZFILEZINETSet a configuration parameter which can be used with <IfDefine>...</IfDefine> sections in the configuration file to conditionally skip or process commands.
    -f filenameZFILEZINETUse an alternate configuration file instead of the default conf/httpd.conf file.
    -hZFILE List a short summary of available command line options then exit. + Note that this outputs all options, not just those supported on TPF.
    -lZFILE List modules compiled into the server then exit.
    -LZFILE List available configuration directives then exit. Note that this outputs all configuration directives, not just those supported on TPF.
    -SZFILE Show the settings as parsed from the configuration file then exit. Currently Apache only shows the virtual host settings.
    -tZFILE Run syntax tests for configuration files with document root checks then exit.
    -TZFILE Run syntax tests for configuration files without document root checks then exit.
    -vZFILE Show the version number then exit.
    -VZFILE Show the version number and various compile settings then exit.
    -X ZINETRun in single-process mode for internal debugging purposes only. + The parent process does not fork any children.
    -

    Note: On TPF Apache arguments are supported only on the - command line, not through the ZINET XPARM field.

    +

    See http://httpd.apache.org/docs/programs/httpd.html + for more information about these command line options.

    -

    Setup

    +

    Setup for ZFILE examples

    Ensure Apache (CHTA) is loaded

    @@ -431,7 +478,6 @@ zfile chmod 755 /bin/httpd

    -

    (See "ZFILE-Activate a TPF Segment or Script" in @@ -439,7 +485,7 @@ href="http://www.ibm.com/tpf/pubs/tpfpubs.htm">http://www.ibm.com/tpf/pubs/tpfpubs.htm.)

    -

    Example 1

    +

    ZFILE example 1

    zfile httpd -v

    @@ -451,17 +497,75 @@ END OF DISPLAY

    -

    Example 2

    +

    ZFILE example 2

    zfile httpd -t -f - /usr/local/apache/conf/httpd.conf.new

    + /usr/local/apache/conf/alt.conf

    FILE0002I 11.47.26 START OF ERROR DISPLAY FROM httpd -t ...
    Syntax OK
    END OF DISPLAY

    + +

    ZINET XPARM example

    +
    + + This example uses an alternate configuration file called /usr/local/apache/conf/alt.conf.
    + Transfer the alternate configuration file to your TPF test system.
    + zinet add s-apache pgm-chta model-daemon user-root xparm--f conf/alt.conf
    + zinet start s-apache + +

    (See "ZINET ADD-Add an Internet Server Application Entry" and + "ZINET ALTER-Change an Internet Server Application Entry" in + the Operations guide for more information about using the XPARM field: + http://www.ibm.com/tpf/pubs/tpfpubs.htm.)

    +
    + + + + +
    +

    Syslog Daemon

    +
    + +

    Syslog overview:

    + +

    The syslog daemon is a server process that provides a message logging facility for application and system processes. + It can be used to write messages to log files or to tapes. + See TPF Transmission Control Protocol/Internet Protocol for detailed information about using the syslog daemon on TPF: + http://www.ibm.com/tpf/pubs/tpfpubs.htm. + And see the Apache ErrorLog directive documentation + for details on how to use syslog with Apache.

    + +

    Syslog capabilities were added with PJ27214 which shipped with PUT13. + You must follow the syslog specific installation instructions + in order to have the option of using syslog with Apache.

    + + +

    Tips on using syslog with your Apache error log:

    + +

    This section provides some tips on using syslog with Apache. + It is not meant to replace the syslog documentation in the TPF TCP/IP publication.

    + +
      +
    • The syslog daemon will not create files. If you are logging to a file (as specified in the syslog.conf configuration file) that file must already exist and + have permissions that allow the syslog daemon to write to it.
      • +
    • You must restart the syslog daemon for it to recognize changes to its syslog.conf configuration file.
      • +
    • The syslog daemon must be active prior to starting Apache.
      • +
    • To indicate you want to use syslog with your Apache error log add the following directive to your httpd.conf file: + "ErrorLog syslog:facility" where facility is "local0" through "local7".
      • +
    • Apache will default the facility to "local7" if you omit the facility name from the ErrorLog directive (that is "ErrorLog syslog").
      • +
    • The syslog facility name must be one that is recognized by both Apache and the syslog.h header file. + The facility names "local0" through "local7" are explicitly set aside for your use.
      • +
    • Although "local0" through "local7" are recommended user facility names, here is the complete list of names recognized + by both Apache and TPF's syslog.h: auth, cron, daemon, kern, local0, local1, local2, local3, local4, local5, local6, local7, + lpr, mail, news, syslog, user, and uucp.
      • +
    • You won't see the normal Apache startup/shutdown messages when you use syslog with your Apache error log.
      • +
    • Syslog does not support TCP/IP Offload devices (ZCLAW)
      • +
    +
    @@ -514,12 +618,13 @@
    - [ top  | Configuration Files  | - What's Available  | CGI Scripts  | Options  | Porting Notes ] + [ top  + | Configuration Files  + | What's Available  + | CGI Scripts  + | Options  + | Syslog  + | Porting Notes ]
    --------------------------------------------------------------------- To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org For additional commands, e-mail: docs-help@httpd.apache.org