NAME
    Apache::ModSSL - a Perl Interface to mod_ssl functions

SYNOPSIS
     use Apache::ModSSL;

     if( $r->connection->is_https ) {
       $r->print( $r->connection->ssl_var_lookup('SSL_SERVER_S_DN') );
     }

ABSTRACT
    "Apache::ModSSL" adds 2 functions to the "Apache::Connection" class.
    "is_https()" returns true if the connection SSL-encrypted.
    "ssl_var_lookup()" is used to query more detailed information.

METHODS
    $c->is_https
        "is_https()" returns 1 if the connection is SSL-encrypted, 0 if it
        is not encrypted but mod_ssl is available in the apache binary or
        "undef" if mod_ssl is not loaded.

    $c->ssl_var_lookup(NAME)
        "ssl_var_lookup()" returns the value of an SSL variable. If mod_ssl
        is not loaded "undef" is returned. A query for an unknown variable
        returns an empty string.

        For a list of known variables please refer to the mod_ssl
        documentation or mod_ssl source code
        ("httpd-2.0.52/modules/ssl/ssl_engine_vars.c"). At the time of this
        writing this list includes (not complete):

        HTTPS
        API_VERSION
        SSL_VERSION_PRODUCT
        SSL_VERSION_INTERFACE
        SSL_VERSION_LIBRARY
        SSL_PROTOCOL
        SSL_SESSION_ID
        SSL_CIPHER
        SSL_CLIENT_CERT_CHAIN_n (where n is a number)
        SSL_CLIENT_VERIFY
        SSL_(CLIENT|SERVER)_M_VERSION
        SSL_(CLIENT|SERVER)_M_SERIAL
        SSL_(CLIENT|SERVER)_V_START
        SSL_(CLIENT|SERVER)_V_END
        SSL_(CLIENT|SERVER)_(S|I)_DN
        SSL_(CLIENT|SERVER)_(S|I)_DN_C
        SSL_(CLIENT|SERVER)_(S|I)_DN_ST
        SSL_(CLIENT|SERVER)_(S|I)_DN_SP
        SSL_(CLIENT|SERVER)_(S|I)_DN_L
        SSL_(CLIENT|SERVER)_(S|I)_DN_O
        SSL_(CLIENT|SERVER)_(S|I)_DN_OU
        SSL_(CLIENT|SERVER)_(S|I)_DN_CN
        SSL_(CLIENT|SERVER)_(S|I)_DN_T
        SSL_(CLIENT|SERVER)_(S|I)_DN_I
        SSL_(CLIENT|SERVER)_(S|I)_DN_G
        SSL_(CLIENT|SERVER)_(S|I)_DN_S
        SSL_(CLIENT|SERVER)_(S|I)_DN_D
        SSL_(CLIENT|SERVER)_(S|I)_DN_UID
        SSL_(CLIENT|SERVER)_(S|I)_DN_Email
        SSL_(CLIENT|SERVER)_A_SIG
        SSL_(CLIENT|SERVER)_A_KEY
        SSL_(CLIENT|SERVER)_CERT

EXPORTS
    none.

SEE ALSO
    <http://perl.apache.org/docs/2.0/api/Apache/Connection.html>,
    <http://httpd.apache.org/docs-2.0/mod/mod_ssl.html>

AUTHOR
    Torsten Foertsch, <torsten.foertsch@gmx.net>

COPYRIGHT AND LICENSE
    Copyright (C) 2004 by Torsten Foertsch

    This library is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

INSTALLATION
     perl Makefile.PL
     make
     make test
     make install

DEPENDENCIES
    mod_perl 1.99, httpd 2.0.52, perl 5.8.0

