Apache logging services logo Apache log4j logo

Rat (Release Audit Tool) results

The following document contains the results of Rat (Release Audit Tool).

*****************************************************
Summary
-------
Generated at: 2017-04-02T15:47:54-05:00

Notes: 2
Binaries: 144
Archives: 1
Standards: 73

Apache Licensed: 72
Generated Documents: 0

JavaDocs are generated, thus a license header is optional.
Generated files do not require license headers.

1 Unknown Licenses

*****************************************************

Files with unapproved licenses:

  RELEASE-NOTES.md

*****************************************************

Archives:

 + .mvn/wrapper/maven-wrapper.jar
 
*****************************************************
  Files with Apache License headers will be marked AL
  Binary files (which do not require any license headers) will be marked B
  Compressed archives will be marked A
  Notices, licenses etc. will be marked N
  AL    .dockerignore
  A     .mvn/wrapper/maven-wrapper.jar
  AL    .mvn/wrapper/maven-wrapper.properties
  AL    .travis.yml
  AL    BUILDING.md
  AL    checkstyle-header.txt
  AL    checkstyle-import-control.xml
  AL    checkstyle-suppressions.xml
  AL    checkstyle.xml
  AL    CONTRIBUTING.md
  AL    doap_log4j2.rdf
  AL    Dockerfile
  AL    findbugs-exclude-filter.xml
  N     LICENSE.txt
  AL    log4j-distribution/pom.xml
  AL    log4j-distribution/src/assembly/bin.xml
  AL    log4j-distribution/src/assembly/src.xml
  AL    mvnw
  AL    mvnw.cmd
  N     NOTICE.txt
  AL    pom.xml
  AL    README.md
 !????? RELEASE-NOTES.md
  AL    src/assembly/site.xml
  AL    src/changes/announcement.vm
  AL    src/changes/changes.xml
  AL    src/site/custom/project-info-report.properties
  AL    src/site/markdown/articles.md
  AL    src/site/markdown/build.md
  AL    src/site/markdown/changelog.md
  AL    src/site/markdown/download.md.vm
  AL    src/site/markdown/faq.md.vm
  AL    src/site/markdown/index.md.vm
  AL    src/site/markdown/javadoc.md
  AL    src/site/markdown/maven-artifacts.md.vm
  AL    src/site/pdf.xml
  AL    src/site/resources/css/bootstrap.css
  AL    src/site/resources/css/bootstrap.min.css
  AL    src/site/resources/css/site.css
  B     src/site/resources/images/async-average-latency.png
  B     src/site/resources/images/async-latency-histogram-64-threads.png
  B     src/site/resources/images/async-max-latency-99.99pct.png
  B     src/site/resources/images/async-throughput-comparison.png
  B     src/site/resources/images/async-vs-sync-throughput.png
  B     src/site/resources/images/AsyncWithLocationThrpt1T-labeled.png
  B     src/site/resources/images/AsyncWithLocationThrpt1T.png
  B     src/site/resources/images/collapsed.gif
  B     src/site/resources/images/expanded.gif
  B     src/site/resources/images/garbage-free2.6-SyncThroughputLinux.png
  B     src/site/resources/images/IntelliJ-IDEA-logo.png
  B     src/site/resources/images/jmx-jconsole-editconfig.png
  B     src/site/resources/images/jmx-jconsole-mbeans.png
  B     src/site/resources/images/jmx-jconsole-statuslogger.png
  B     src/site/resources/images/jmx-standalone-editconfig.png
  B     src/site/resources/images/jmx-standalone-statuslogger.png
  B     src/site/resources/images/log4j-2.5-FlightRecording-thumbnail40pct.png
  B     src/site/resources/images/log4j-2.5-FlightRecording.png
  B     src/site/resources/images/log4j-2.6-FlightRecording-thumbnail40pct.png
  B     src/site/resources/images/log4j-2.6-FlightRecording.png
  B     src/site/resources/images/Log4j2AppenderThroughputComparison-linux.png
  B     src/site/resources/images/Log4j2AppenderThroughputComparison-windows.png
  B     src/site/resources/images/Log4jClasses.jpg
  B     src/site/resources/images/logo.jpg
  B     src/site/resources/images/logo.png
  B     src/site/resources/images/ls-logo.jpg
  B     src/site/resources/images/MarkerFilterCostComparison.png
  B     src/site/resources/images/maven-feather.png
  B     src/site/resources/images/ParamMsgThrpt1-4T.png
  B     src/site/resources/images/ResponseTimeAsyncClassicVsGcFree-label.png
  B     src/site/resources/images/ResponseTimeAsyncLogging16Threads@8kEach.png
  B     src/site/resources/images/ResponseTimeAsyncLogging16Threads@8kEachLog4j2Only-labeled.png
  B     src/site/resources/images/ResponseTimeAsyncLogging1Thread@128k.png
  B     src/site/resources/images/ResponseTimeAsyncLogging4Threads@16kEach.png
  B     src/site/resources/images/ResponseTimeSyncClassicVsGcFree.png
  B     src/site/resources/images/ResponseTimeVsServiceTimeAsyncLoggers.png
  B     src/site/resources/images/SynchronousFileResponseTime2T32k-labeled.png
  B     src/site/resources/images/SyncThroughputLoggerComparisonLinux.png
  B     src/site/resources/images/ThreadContextFilterCostComparison.png
  B     src/site/resources/images/whichjar-2.1.png
  B     src/site/resources/images/whichjar-2.x.png
  B     src/site/resources/images/whichjar-slf4j-2.1.png
  B     src/site/resources/images/whichjar-slf4j-2.x.png
  B     src/site/resources/images/whichjar-slf4j.png
  B     src/site/resources/images/whichjar.png
  B     src/site/resources/images/whichjar.xlsx
  B     src/site/resources/images/YourKitLogo.png
  B     src/site/resources/img/glyphicons-halflings-white.png
  B     src/site/resources/img/glyphicons-halflings.png
  AL    src/site/resources/js/bootstrap.js
  AL    src/site/resources/js/bootstrap.min.js
  AL    src/site/resources/js/prettify.js
  AL    src/site/resources/js/prettify.min.js
  AL    src/site/resources/js/site.js
  B     src/site/resources/logo/logo-3d-green-bg-2.png
  B     src/site/resources/logo/logo-3d-green-bg-2.xcf
  B     src/site/resources/logo/logo-3d-green-bg.png
  B     src/site/resources/logo/logo-3d-green-bg.xcf
  B     src/site/resources/logo/logo-big-blue.png
  B     src/site/resources/logo/logo-big-blue.xcf
  B     src/site/resources/logo/logo-blue-web-r2.6.png
  B     src/site/resources/logo/logo-blue-web-r2.6.xcf
  B     src/site/resources/logo/logo-blue-web.png
  B     src/site/resources/logo/logo-blue-web.xcf
  B     src/site/resources/logo/logo-chocolate-swirl-2.png
  B     src/site/resources/logo/logo-chocolate-swirl-2.xcf
  B     src/site/resources/logo/logo-chocolate-swirl.png
  B     src/site/resources/logo/logo-chocolate-swirl.xcf
  B     src/site/resources/logo/logo-craters-2.png
  B     src/site/resources/logo/logo-craters-2.xcf
  B     src/site/resources/logo/logo-craters.png
  B     src/site/resources/logo/logo-craters.xcf
  B     src/site/resources/logo/logo-electric-blue.png
  B     src/site/resources/logo/logo-electric-blue.xcf
  B     src/site/resources/logo/logo-granite-2.png
  B     src/site/resources/logo/logo-granite-2.xcf
  B     src/site/resources/logo/logo-granite.png
  B     src/site/resources/logo/logo-granite.xcf
  B     src/site/resources/logo/logo-ice.png
  B     src/site/resources/logo/logo-ice.xcf
  B     src/site/resources/logo/logo-java-1.png
  B     src/site/resources/logo/logo-java-1.xcf
  B     src/site/resources/logo/logo-java-2-2.6.2.png
  B     src/site/resources/logo/logo-java-2-2.6.2.xcf
  B     src/site/resources/logo/logo-java-2.png
  B     src/site/resources/logo/logo-java-2.xcf
  B     src/site/resources/logo/logo-java-3.png
  B     src/site/resources/logo/logo-java-3.xcf
  B     src/site/resources/logo/logo-leather-2.png
  B     src/site/resources/logo/logo-leather-2.xcf
  B     src/site/resources/logo/logo-leather.png
  B     src/site/resources/logo/logo-leather.xcf
  B     src/site/resources/logo/logo-lightning-2.6.1.png
  B     src/site/resources/logo/logo-lightning-2.6.1.xcf
  B     src/site/resources/logo/logo-lightning.png
  B     src/site/resources/logo/logo-lightning.xcf
  B     src/site/resources/logo/logo-marble-1.png
  B     src/site/resources/logo/logo-marble-1.xcf
  B     src/site/resources/logo/logo-paper-1.png
  B     src/site/resources/logo/logo-paper-1.xcf
  B     src/site/resources/logo/logo-paper-2.png
  B     src/site/resources/logo/logo-paper-2.xcf
  B     src/site/resources/logo/logo-parque-1.png
  B     src/site/resources/logo/logo-parque-1.xcf
  B     src/site/resources/logo/logo-parque-2.png
  B     src/site/resources/logo/logo-parque-2.xcf
  B     src/site/resources/logo/logo-parque-3.png
  B     src/site/resources/logo/logo-parque-3.xcf
  B     src/site/resources/logo/logo-pastel-stuff-2.8.1.png
  B     src/site/resources/logo/logo-pastel-stuff-2.png
  B     src/site/resources/logo/logo-pastel-stuff-2.xcf
  B     src/site/resources/logo/logo-pastel-stuff-3.png
  B     src/site/resources/logo/logo-pastel-stuff-3.xcf
  B     src/site/resources/logo/logo-pastel-stuff.png
  B     src/site/resources/logo/logo-pastel-stuff.xcf
  B     src/site/resources/logo/logo-pine.png
  B     src/site/resources/logo/logo-pine.xcf
  B     src/site/resources/logo/logo-pool-bottom-2.7.png
  B     src/site/resources/logo/logo-pool-bottom-bg.png
  B     src/site/resources/logo/logo-pool-bottom-bg.xcf
  B     src/site/resources/logo/logo-pool-bottom.png
  B     src/site/resources/logo/logo-pool-bottom.xcf
  B     src/site/resources/logo/logo-qbert.png
  B     src/site/resources/logo/logo-qbert.xcf
  B     src/site/resources/logo/logo-rain.png
  B     src/site/resources/logo/logo-rain.xcf
  B     src/site/resources/logo/logo-red-cubes.png
  B     src/site/resources/logo/logo-red-cubes.xcf
  B     src/site/resources/logo/logo-rocks.png
  B     src/site/resources/logo/logo-rocks.xcf
  B     src/site/resources/logo/logo-sky.png
  B     src/site/resources/logo/logo-sky.xcf
  B     src/site/resources/logo/logo-starfield.png
  B     src/site/resources/logo/logo-starfield.xcf
  B     src/site/resources/logo/logo-stone-2.8.png
  B     src/site/resources/logo/logo-stone-2.8.xcf
  B     src/site/resources/logo/logo-stone.png
  B     src/site/resources/logo/logo-stone.xcf
  B     src/site/resources/logo/logo-tree-bark.png
  B     src/site/resources/logo/logo-tree-bark.xcf
  B     src/site/resources/logo/logo-walnut.png
  B     src/site/resources/logo/logo-walnut.xcf
  B     src/site/resources/logo/logo-wood-1.png
  B     src/site/resources/logo/logo-wood-1.xcf
  B     src/site/resources/logo/logo-wood-2.png
  B     src/site/resources/logo/logo-wood-2.xcf
  B     src/site/resources/logo/logo-wood.png
  B     src/site/resources/logo/logo-wood.xcf
  B     src/site/resources/logo/logo.jpg
  AL    src/site/resources/pdf-config.xml
  AL    src/site/site.vm
  AL    src/site/site.xml
  AL    src/site/xdoc/guidelines.xml
  AL    src/site/xdoc/javastyle.xml
  AL    src/site/xdoc/manual/api.xml
  AL    src/site/xdoc/manual/appenders.xml
  AL    src/site/xdoc/manual/architecture.xml
  AL    src/site/xdoc/manual/async.xml
  AL    src/site/xdoc/manual/configuration.xml.vm
  AL    src/site/xdoc/manual/customconfig.xml
  AL    src/site/xdoc/manual/customloglevels.xml.vm
  AL    src/site/xdoc/manual/eventlogging.xml
  AL    src/site/xdoc/manual/extending.xml
  AL    src/site/xdoc/manual/filters.xml
  AL    src/site/xdoc/manual/flowtracing.xml
  AL    src/site/xdoc/manual/garbagefree.xml
  AL    src/site/xdoc/manual/index.xml
  AL    src/site/xdoc/manual/jmx.xml.vm
  AL    src/site/xdoc/manual/layouts.xml.vm
  AL    src/site/xdoc/manual/logsep.xml
  AL    src/site/xdoc/manual/lookups.xml
  AL    src/site/xdoc/manual/markers.xml
  AL    src/site/xdoc/manual/messages.xml
  AL    src/site/xdoc/manual/migration.xml
  AL    src/site/xdoc/manual/plugins.xml
  AL    src/site/xdoc/manual/scala-api.xml
  AL    src/site/xdoc/manual/thread-context.xml
  AL    src/site/xdoc/manual/webapp.xml
  AL    src/site/xdoc/performance.xml
  AL    src/site/xdoc/runtime-dependencies.xml
  AL    src/site/xdoc/thanks.xml
 
*****************************************************

 Printing headers for text files without a valid license header...
 
=====================================================
== File: RELEASE-NOTES.md
=====================================================
# Apache Log4j 2.8.2 Release Notes

The Apache Log4j 2 team is pleased to announce the Log4j 2.8.2 release!

Apache Log4j is a well known framework for logging application behavior. Log4j 2 is an upgrade
to Log4j that provides significant improvements over its predecessor, Log4j 1.x, and provides
many other modern features such as support for Markers, lambda expressions for lazy logging,
property substitution using Lookups, multiple patterns on a PatternLayout and asynchronous
Loggers. Another notable Log4j 2 feature is the ability to be "garbage-free" (avoid allocating
temporary objects) while logging. In addition, Log4j 2 will not lose events while reconfiguring.

This release primarily contains bugfixes and minor enhancements. More details on the new features and
fixes are itemized below.

Note that subsequent to the 2.6 release a minor source incompatibility was found due to the
addition of new methods to the Logger interface. If you have code that does:

    logger.error(null, “This is the log message”, throwable);

or similar with any log level you will get a compiler error saying the reference is ambiguous.
To correct this either do:

    logger.error(“This is the log message”, throwable);

or

    logger.error((Marker) null, “This is the log message”, throwable);

The Log4j 2.8.2 API, as well as many core components, maintains binary compatibility with previous releases.

## GA Release 2.8.2

Changes in this version include:

### New Features
* [LOG4J2-1863](https://issues.apache.org/jira/browse/LOG4J2-1863):
Add support for filtering input in TcpSocketServer and UdpSocketServer.
* [LOG4J2-1848](https://issues.apache.org/jira/browse/LOG4J2-1848):
Add JSON encoding support to EncodingPatternConverter %encode{}.
* [LOG4J2-1843](https://issues.apache.org/jira/browse/LOG4J2-1843):
Add support for appending common suffix to each line of throwable stack trace. Thanks to Zilong Song.
* [LOG4J2-1838](https://issues.apache.org/jira/browse/LOG4J2-1838):
Add support for appending common suffix to each line of extended and root throwable stack trace. Thanks to Zilong Song.

### Fixed Bugs
* [LOG4J2-1861](https://issues.apache.org/jira/browse/LOG4J2-1861):
Fix JavaDoc on org.apache.logging.log4j.ThreadContext about inheritance.
* [LOG4J2-1862](https://issues.apache.org/jira/browse/LOG4J2-1862):
Fix JavaDoc about @Order and OrderComparator ordering. Thanks to wangyuntao.
* [LOG4J2-1849](https://issues.apache.org/jira/browse/LOG4J2-1849):