docs/manual/new_features_2_6.xml

<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.en.xsl"?>
<!-- $LastChangedRevision$ -->

<!--
 Licensed to the Apache Software Foundation (ASF) under one or more
 contributor license agreements.  See the NOTICE file distributed with
 this work for additional information regarding copyright ownership.
 The ASF licenses this file to You under the Apache License, Version 2.0
 (the "License"); you may not use this file except in compliance with
 the License.  You may obtain a copy of the License at

     http://www.apache.org/licenses/LICENSE-2.0

 Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and
 limitations under the License.
-->

<manualpage metafile="new_features_2_6.xml.meta">

<title>Overview of new features in Apache HTTP Server 2.6</title>

<summary>
  <p>This document describes some of the major changes between the
     2.4 and 2.6 versions of the Apache HTTP Server. For new features since
     version 2.2, see the <a href="new_features_2_4.html">2.4 new features</a>
     document.</p>
</summary>

  <section id="core">
    <title>Core Enhancements</title>
    <dl>
      <dt>ContentDigest directive and Content-MD5 header</dt>
      <dd>The <code>ContentDigest</code> directive and support for the the
          <code>Content-MD5</code> header has been removed from the server,
          corresponding with the removal of this header from
          <a href="https://tools.ietf.org/html/rfc7231#appendix-B">
          RFC7231 Hypertext Transfer Protocol (HTTP/1.1): Semantics and
          Content.</a></dd>

      <dt><code>Listen</code> directive options</dt>
      <dd>The <directive module="mpm_common">Listen</directive>
      directive now supports an optional <code>options=...</code>
      argument, allowing per-listener socket options to be
      configured.</dd>

      <dt><code>systemd</code> socket activation</dt>
      <dd><program>httpd</program> can now be configured to start via
      <code>systemd</code> <a href="https://www.freedesktop.org/software/systemd/man/systemd.socket.html">socket activation</a>.</dd>

<!--      <dt>Loadable errorlog providers</dt>
      <dd>TODO</dd> -->

      <dt>New <code>DefaultStateDir</code> directive.</dt>
      <dd>The <directive module="core">DefaultStateDir</directive>
      directive has been added to specify a directory for storing
      persistent state.</dd>

      <dt>Zone/scope support in IPv6 addresses</dt>
      <dd>If built against APR 1.7.0 or later, zones (scopes) can be
      specified in an IPv6 link-local address used with the
      <directive module="mpm_common">Listen</directive> or
      <directive module="core">VirtualHost</directive> directive.</dd>
      
    </dl>
  </section>

  <section id="newmods">
    <title>New Modules</title>
    <dl>
<!--      <dt><module>mod_ssl_ct</module></dt>
      <dd>Fill me in.</dd> -->

      <dt><module>mod_journald</module>, <module>mod_syslog</module></dt>
      <dd>These new modules provide support for logging to syslog or
      <code>journald</code>.</dd>

</dl>
  </section>

  <section id="module">
    <title>Module Enhancements</title>
    <dl>
      <dt><module>mod_ssl</module></dt>
      <dd>The following mod_ssl enhancements are included:
      <ul>
        <li><directive module="mod_ssl">SSLRandomSeed</directive>
      directive is now deprecated and is ignored if building against
        OpenSSL 1.1.1 or later.</li>
        <li>The <code>SSLKEYLOGFILE</code> environment variable can
        now be set to log private key material for off-line decryption
        of SSL/TLS protocol dumps using third-party tools.</li>
      </ul></dd>

      <dt><module>mod_cgid</module></dt>
      <dd>If configured with <code>--enable-cgid-fdpassing</code>, the
      CGI daemon will set up stderr handling in the same way as
      mod_cgi.</dd>

      
    </dl>
  </section>

  <section id="programs">
    <title>Program Enhancements</title>
    <dl>
        <dt><program>htpasswd</program></dt>
        <dd>The <program>htpasswd</program> utility can now generate
        SHA-256 or SHA-512 <code>crypt()</code> hashes where supported
        by the C library.</dd>
    </dl>
  </section>

  <section id="documentation">
    <title>Documentation</title>
    <dl>
        <dt>Fill me in</dt>
        <dd>The <module>mod_example</module> documentation fill me in.</dd>

    </dl>
  </section>

  <section id="developer">
    <title>Module Developer Changes</title>
    <dl>
      <dt>New type <code>ap_method_mask_t</code>.</dt>

      <dd>The <code>ap_method_mask_t</code> type has been added and is
      now used for the method_mask field in ap_method_list_t,
      AP_METHOD_BIT, allowed field of request_rec, limited field of
      cmd_parms.</dd>

      <dt><code>mod_ssl.h</code> mod_ssl API changes.</dt>

      <dd>The <code>ssl_var_lookup</code> optional function API now
      takes a <code>const char *</code><em>name</em> argument and
      returns a <code>const char *</code> string value.  The pool
      argument must now be non-NULL.</dd>

    </dl>
    <p>The developer documentation contains a
    <a href="developer/new_api_2_6.html">detailed list of API changes</a>.</p>
  </section>

</manualpage>